Cli 导读

启动 Gateway 前必须搞懂的三件事

Gateway 是 OpenClaw 的 WebSocket 服务器,管理通道、节点、会话和钩子。首次启动前先确认 `gateway.mode=local` 已写入配置,否则必须加 `--allow-unconfigured` 才能跑起来。绑定非回环地址时默认禁止无认证连接,这是安全护栏,别硬关。

先讲这一页到底在解决什么

启动 Gateway 前必须搞懂的三件事

Gateway 是 OpenClaw 的 WebSocket 服务器,管理通道、节点、会话和钩子。首次启动前先确认 `gateway.mode=local` 已写入配置,否则必须加 `--allow-unconfigured` 才能跑起来。绑定非回环地址时默认禁止无认证连接,这是安全护栏,别硬关。

原文共 19 节,先看 Start Here 路径:/cli/gateway 查看官方原文

第一站

🚀 openclaw gateway 就是在说:“把机房现在就开起来”

官方一开头先讲运行。因为很多事情都得先有一台活着的 Gateway,后面的状态、探测、远程连接才有意义。

openclaw gateway

像当场把机房电闸拉起,让它在你眼前运行。

openclaw gateway run

像同一件事的另一个名字,还是前台跑,还是你盯着它。

--allow-unconfigured

像你规则表还没正式贴好,但今天先想临时通电试一下。

⚠️ 非 loopback + 无 auth

官方明确拦这个场景。翻成人话就是:门朝外开时,不给门票就别想偷懒。

第二站

🎛 启动参数别背术语,把它们想成“门牌、门朝哪开、门禁、监控灯”

这一串 flags 容易看花眼,其实完全可以按现场物件来记。

🚪

--port

像机房门牌号,常见默认是 18789

🧭

--bind

像门只朝家里开,还是朝局域网、尾网、更远处开。

🎟

--auth / --token / --password

像门禁卡、口令和验票方式。

💡

--verbose / --ws-log / --raw-stream

像把更多监控灯打开,让你看到后台细节流出来。

第三站

🔎 Query a running Gateway 这段的重点,是“先问,不要先拍机房电闸”

真正会值班的人,出问题时先查状态,不是先重启。官方这段写得很务实。

openclaw gateway status

像去前台问:“服务到底在不在?是托管服务在跑,还是只有一层空壳?”

openclaw gateway health

像索要更偏体检单的健康快照。

openclaw gateway call status

像直接拿内线电话,问某个具体 RPC 房间一句话。

--json

像不要彩色人话,直接要机器可抄走的表格。

第四站

🛰 gateway probe 像“拿探照灯把本地和远端都扫一遍”

这不是普通问状态,而是更像全场侦察。官方甚至说它是“debug everything”命令。

openclaw gateway probe

像一手照本地,一手照远端,看看哪边真的有人回应。

Reachable: yes

像至少有一间机房愿意开门搭话。

RPC: ok

像不只是门开了,里面值班员还真的能回答更细的问题。

--ssh user@host

像先用一条秘密走廊钻到远端楼下,再从那里敲机房门。

第五站

🛎 service commands 在讲“别老站着手扶开关,要请物业长期值班”

这一组命令管理的不是一次性前台运行,而是长期托管的服务。

📦

gateway install

像把机房正式登记给物业,变成系统托管服务。

start / stop / restart

像叫物业开门、关门、重新拉一次电。

🧹

uninstall

像撤销这套托管登记,让它不再被系统当正式设施照看。

🩺

status --require-rpc

像不满足于“门口灯亮着”,而是要求后台也真的能说话,不然就算没过关。

第六站

🔐 这页反复在提醒一件事:你一旦手填远端地址,就自己把票带齐

官方多次强调 `--url` 的行为。因为很多人以为“我给了 URL,它应该顺便猜到 token”。它不会这么做。

--url

像你自己指了一栋楼,说“我今天去那边”。

--token / --password

像你还得把那栋楼的门票一起带上。

不会自动兜底

官方明确说不会再回头帮你猜配置或环境变量里的隐式凭证。

🎈 一句话

门牌你自己指定了,门票也请你自己拿稳。

最后总结

🎈 把 openclaw gateway 这页压成一句话

openclaw gateway 这整页讲的是机房值班动作:先把 Gateway 开起来,再学会问状态、拿探照灯探远端、最后交给系统服务长期托管。

如果你下一页只想继续看一页,我建议看 /cli/acp/cli/browser。前者是把别的编辑器和 OpenClaw 接起来,后者是让 OpenClaw 动浏览器。