Cli 导读

`openclaw daemon` 是旧名,新名是 `openclaw gateway`,命令一样用

这一页是 `openclaw daemon` 命令的参考,它已被 `openclaw gateway` 取代,但所有子命令(status、install、start、stop、restart、uninstall)完全兼容。如果你在用旧脚本或习惯,可以继续用 daemon,但新项目请改用 gateway。最容易踩坑的是 status 的 token 探测:如果 token 来自 SecretRef 且未解析,status 会报 rpc.authWarning,此时要么显式传 --token,要么先解析 SecretRef。

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

`openclaw daemon` 是旧名,新名是 `openclaw gateway`,命令一样用

这一页是 `openclaw daemon` 命令的参考,它已被 `openclaw gateway` 取代,但所有子命令(status、install、start、stop、restart、uninstall)完全兼容。如果你在用旧脚本或习惯,可以继续用 daemon,但新项目请改用 gateway。最容易踩坑的是 status 的 token 探测:如果 token 来自 SecretRef 且未解析,status 会报 rpc.authWarning,此时要么显式传 --token,要么先解析 SecretRef。

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

第一站

🔁 先记一句大白话:看见 daemon,脑子里直接翻译成“Gateway 服务管理”

官方说得很直白:openclaw daemon ... 映射到和 openclaw gateway ... 一样的服务控制面。

🪪

老名字

daemon 像旧招牌,还留着方便你认人。

🧍

同一个人

背后真正干活的,还是 Gateway 服务那套动作。

📚

旧教程能对照

你如果看到老文章里写 daemon,不用慌,它没换系统,只是旧称呼。

📌

一句话

daemon = 老名字的 gateway 服务命令。

第二站

🧰 这些子命令很像值班室的 6 个常用按钮

虽然它是旧别名,但按钮还是很实用:看状态、安装、启动、停止、重启、卸掉。

openclaw daemon status

像去值班室窗前问一句:“现在有没有人在岗?门铃通不通?”

openclaw daemon install

像正式把值班制度挂起来,让系统开机后也知道谁来守门。

start / stop / restart

像叫值班员上岗、下岗,或者重整衣服再来一轮。

uninstall

像把这套托管值班制度拆掉,不再让系统替你自动安排这位值班员。

第三站

🔐 statusinstall 的那些参数,其实都在围绕“值班员怎么认门、拿哪把钥匙”

官方列的选项多,但核心就是地址、认证、超时、运行时这些几件事。

📍

--url / --port

像告诉值班员门口具体在哪,或者要守哪个端口。

🔑

--token / --password

像交给它上岗时要带的门卡或口令。

⏱️

--timeout / --deep

像决定检查多久、查多深,不是只看门口灯亮不亮。

⚙️

--runtime <node|bun>

像决定值班员坐哪种交通工具来上岗。

第四站

🪵 那些 SecretRef 注释其实是在提醒:值班员拿不到钥匙时,不要假装自己已经开门成功

官方在这页特别谨慎,因为服务安装和探测一旦拿错钥匙,就很容易造成“明明装了,却总报未授权”的怪现象。

status 的 authWarning

像值班员去试门时说:“门在那儿,但我今天没拿到正确钥匙,所以只能给你报个提醒。”

probe 成功就不乱报

如果门真的已经成功打开,系统就不会再拿旧提醒吓你。

install 失败关口

如果 token 模式需要钥匙,而 SecretRef 又根本解不出来,安装会直接拦下,像门卫说“钥匙没拿到,不许你假装上岗”。

mode 不明确也拦

如果 token 和 password 两把钥匙都摆着,但没说到底用哪把,系统宁可先不装,也不让值班员糊里糊涂上班。

最后总结

🎈 把 openclaw daemon 压成一句话

openclaw daemon 就像 Gateway 服务命令的旧门牌:看上去是老名字,背后做的还是安装、启动、停用、探测和带钥匙上岗那套值班室管理动作。