openclaw gateway网关运行详解

Gateway 网关运行手册 — 关键内容与操作流程1) Gateway 是什么Gateway 网关服务是一款长期运行的进程用于处理连接控制、事件平面与底层 Baileys / Telegram 等协议对接为客户端提供 RPC/HTTP 接口。它自身启动后持续运行出现致命错误会以非零退出码退出以便 supervisor 重启。([openclaw.cc][1]) 2) 启动与运行本地启动示例openclaw gateway--port18789# 开启网关服务openclaw gateway--port18789--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) 端口与接口说明默认端口与服务控制与事件 WebSocket127.0.0.1:port通常是上面指定的 18789HTTP 服务复用同一端口支持如下接口/v1/chat/completions/v1/responses/tools/invokeCanvas 文件服务在默认情况下Canvas 静态文件服务器启动在18793。可用canvasHost.enabledfalse或设置OPENCLAW_SKIP_CANVAS_HOST1禁用。([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) 检查与诊断常见的检查项包括健康检查Healthopenclaw 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_sourcechatgpt.com “Gateway 网关运行手册 | OpenClaw 中文站”[2]: https://docs.openclaw.ai/zh-CN/gateway?utm_sourcechatgpt.com “Gateway 网关运行手册 - OpenClaw”