📘 Gateway 网关运行手册 — 关键内容与操作流程

1) Gateway 是什么

Gateway 网关服务 是一款长期运行的进程，用于处理连接控制、事件平面，与底层 Baileys / Telegram 等协议对接，为客户端提供 RPC/HTTP 接口。它自身启动后持续运行，出现致命错误会以非零退出码退出以便 supervisor 重启。([openclaw.cc][1])

---

🚀 2) 启动与运行

本地启动示例

openclaw gateway --port 18789          # 开启网关服务
openclaw gateway --port 18789 --verbose # debug/trace 日志输出
openclaw gateway --force                # 如果端口被占用，强制重启

提示

• 默认监听端口是 18789。
• --verbose 显示详细调试日志。
• --force 用以终止可能已占用该端口的进程，然后重新启动。([openclaw.cc][1])

---

⚙️ 3) 配置与热重载机制

配置文件位置

网关默认读取：

~/.openclaw/openclaw.json

可通过环境变量替换：

OPENCLAW_CONFIG_PATH=<你的配置路径>

热重载模式

模式	说明
hybrid（默认）	尝试热应用安全配置，更改重大配置时触发重启
off	禁止热重载，所有更改需手动重启服务

这个模式由 gateway.reload.mode 控制。([openclaw.cc][1])

---

📡 4) 端口与接口说明

默认端口与服务

• 控制与事件 WebSocket：127.0.0.1:<port>
  （通常是上面指定的 18789）

• HTTP 服务（复用同一端口）
  支持如下接口：

  • /v1/chat/completions
  • /v1/responses
  • /tools/invoke

Canvas 文件服务

• 在默认情况下，Canvas 静态文件服务器启动在 18793。
• 可用 canvasHost.enabled=false 或设置 OPENCLAW_SKIP_CANVAS_HOST=1 禁用。([openclaw.cc][1])

---

🛠️ 5) Supervisor / 管理（运行模式）

建议使用 Supervisor 管理器（如 systemd、launchd 等）将 Gateway 作为守护进程运行：

• 正常停止/重启发送：SIGTERM
• 错误退出码：非 0（可被 supervisor 捕获并重启）
• 可用日志轮转机制防止日志无限增长。([openclaw.cc][1])

---

🔐 6) 认证与安全配置

默认情况下，Gateway 要求认证。你需要配置一种方式：

配置项	说明
gateway.auth.token	访问令牌
gateway.auth.password	密码

客户端必须发送匹配的 connect.params.auth.token 或 connect.params.auth.password 才能连接，除非使用诸如 Tailscale Serve 等身份方法。([openclaw.cc][1])

---

🧪 7) 检查与诊断

常见的检查项包括：

• 健康检查（Health）：

  openclaw gateway status
  

  正常输出例子：

  Runtime: running
  Connectivity probe: ok
  

• 渠道就绪检查：

  openclaw channels status --probe
  

• 实时日志：

  openclaw logs --follow
  

  可以帮助分析连接或 RPC 调用失败原因。([OpenClaw][2])

---

🧾 8) 参考结构（文档部分索引）

完整文档还包含以下部分：

• 多个 Gateway 实例在同一主机的管理
• Dev 模式快速配置
• 协议运维参考（RPC/事件/错误码结构）
• 远程访问与安全保证
• systemd / macOS service 示例
• 错误处理场景与恢复策略
• CLI 工具辅助功能
• 迁移指南（版本升级）([OpenClaw][2])

---

📌 总结

这份运行核心覆盖了 Gateway 网关的：

• 启动步骤与运行命令
• 配置与热重载机制
• 端口与服务说明
• Supervisor 守护运行策略
• 认证与安全机制
• 健康检查与日志追踪策略

参考链接:
[1]: https://openclaw.cc/gateway/?utm_source=chatgpt.com “Gateway 网关运行手册 | OpenClaw 中文站”
[2]: https://docs.openclaw.ai/zh-CN/gateway?utm_source=chatgpt.com “Gateway 网关运行手册 - OpenClaw”