Gateway Runbook（中文运维版）

核心职责

Gateway 是 OpenClaw 的控制面与路由面，负责会话、渠道、工具策略和 API 接入。

参考：

• https://docs.openclaw.ai/gateway/index.md
• https://docs.openclaw.ai/gateway/configuration.md
• https://docs.openclaw.ai/gateway/troubleshooting.md

日常命令

openclaw gateway status
openclaw gateway status --deep
openclaw status
openclaw logs --follow
openclaw doctor

五分钟健康检查

1. openclaw gateway status：确认 running
2. openclaw status：确认 runtime 与 channels 正常
3. openclaw channels status --probe：确认渠道可用
4. openclaw logs --follow：确认无连续错误

配置与重载策略

重点关注：

• gateway.bind
• gateway.port
• gateway.auth.*
• gateway.reload.mode

重载模式建议：

• 测试环境 hybrid
• 生产环境先 hybrid，并配合变更窗口

远程访问建议

优先级：

1. Tailscale / VPN
2. SSH 隧道
3. 公网代理（必须加鉴权与访问控制）

SSH 隧道示例：

ssh -N -L 18789:127.0.0.1:18789 user@host

常见故障定位顺序

1. 进程是否运行
2. 端口与 bind 是否符合预期
3. 鉴权配置是否生效
4. 渠道连接状态是否异常
5. Provider 是否可达

值班手册最小模板

• 告警名称
• 影响范围
• 即时止血动作
• 根因归类
• 回滚与修复动作
• 复盘结论