--port
像机房门牌号,常见默认是 18789。
Cli 导读
Gateway 是 OpenClaw 的 WebSocket 服务器,管理通道、节点、会话和钩子。首次启动前先确认 `gateway.mode=local` 已写入配置,否则必须加 `--allow-unconfigured` 才能跑起来。绑定非回环地址时默认禁止无认证连接,这是安全护栏,别硬关。
先讲这一页到底在解决什么
Gateway 是 OpenClaw 的 WebSocket 服务器,管理通道、节点、会话和钩子。首次启动前先确认 `gateway.mode=local` 已写入配置,否则必须加 `--allow-unconfigured` 才能跑起来。绑定非回环地址时默认禁止无认证连接,这是安全护栏,别硬关。
第一站
openclaw gateway 就是在说:“把机房现在就开起来”官方一开头先讲运行。因为很多事情都得先有一台活着的 Gateway,后面的状态、探测、远程连接才有意义。
openclaw gateway像当场把机房电闸拉起,让它在你眼前运行。
openclaw gateway run像同一件事的另一个名字,还是前台跑,还是你盯着它。
--allow-unconfigured像你规则表还没正式贴好,但今天先想临时通电试一下。
官方明确拦这个场景。翻成人话就是:门朝外开时,不给门票就别想偷懒。
第二站
这一串 flags 容易看花眼,其实完全可以按现场物件来记。
--port像机房门牌号,常见默认是 18789。
--bind像门只朝家里开,还是朝局域网、尾网、更远处开。
--auth / --token / --password像门禁卡、口令和验票方式。
--verbose / --ws-log / --raw-stream像把更多监控灯打开,让你看到后台细节流出来。
第三站
真正会值班的人,出问题时先查状态,不是先重启。官方这段写得很务实。
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像先用一条秘密走廊钻到远端楼下,再从那里敲机房门。
第五站
这一组命令管理的不是一次性前台运行,而是长期托管的服务。
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 动浏览器。