Gateway Operations
Gateway 网关运行手册
Gateway 是 OpenClaw 的常驻控制平面：它连接聊天渠道、管理 WebSocket / HTTP 接口、协调节点与工具，并维持健康检查、日志、状态与远程访问能力。
Gateway 是什么
统一接入层
统一持有 WhatsApp / Telegram 等渠道连接，以及 Dashboard / WebChat / 节点的控制面接口。
单端口多路复用
同一个端口同时承载 WebSocket 控制面和 HTTP 入口，例如 Control UI、OpenAI 风格接口与工具调用接口。
适合 supervisor 托管
推荐由 launchd / systemd 等监管。出现致命错误时应非零退出，由 supervisor 负责拉起。
本地也建议启用 token
即使只绑定 loopback，也建议配置 token，避免同机其他进程无认证直连。
常用运行命令
本地运行
openclaw gateway --port 18789详细日志
直接把调试与追踪信息打到当前终端。
openclaw gateway --port 18789 --verbose强制占端口恢复
端口被占时，先查找监听器并尝试结束，再启动 Gateway。
openclaw gateway --force开发监视模式
修改 TypeScript 后自动重载 Gateway，适合本地开发。
pnpm gateway:watch运维要点
远程访问
优先使用 Tailscale / VPN；次选 SSH 隧道，例如 ssh -N -L 18789:127.0.0.1:18789 user@host。
多实例
确实需要隔离时，为每个实例单独准备 gateway.port、配置文件、状态目录与工作区。
热重载与重启
Gateway 会监听配置变化；安全修改可热应用，关键修改会触发重启。要完全关闭这类行为，再显式禁用 reload。
服务管理
macOS 常见是 LaunchAgent，Linux / WSL2 常见是 systemd 用户服务。服务正常“加载”不等于 RPC 可探测，排障时务必同时检查 gateway status 和日志。