远程 Linux / Windows / NAS
像把跑腿员派去另一栋楼,让它在那边本地执行命令。
Cli 导读
`openclaw node` 让你在远程 Linux/Windows 机器上启动一个轻量节点,agent 可以通过它执行命令或操控浏览器,无需安装完整桌面应用。启动前务必确认 `OPENCLAW_GATEWAY_TOKEN` 或 `gateway.auth.token` 已配置——节点命令不支持 `--token` 参数,且不会继承 `gateway.remote.token`。浏览器代理默认开启,如果不想暴露节点上的浏览器配置文件,记得在配置里把 `nodeHost.browserProxy.enabled` 设为 `false`。
先讲这一页到底在解决什么
`openclaw node` 让你在远程 Linux/Windows 机器上启动一个轻量节点,agent 可以通过它执行命令或操控浏览器,无需安装完整桌面应用。启动前务必确认 `OPENCLAW_GATEWAY_TOKEN` 或 `gateway.auth.token` 已配置——节点命令不支持 `--token` 参数,且不会继承 `gateway.remote.token`。浏览器代理默认开启,如果不想暴露节点上的浏览器配置文件,记得在配置里把 `nodeHost.browserProxy.enabled` 设为 `false`。
第一站
官方这一段讲的就是价值:把执行能力带到别的机器上,但不用在那边装整套重设备。
像把跑腿员派去另一栋楼,让它在那边本地执行命令。
像跑腿员不是拿了通行证就能乱跑,门卫审批和 allowlist 还在。
像给流水线机器也装一个听得懂总控室话的小值班员。
总控室不挪窝,跑腿员去远方。
第二站
node run 和 node install,像“临时上岗”和“装成长期值班”这页最常用的就是这两条路线:前台跑起来,或者装成后台常驻服务。
openclaw node run --host ... --port 18789像把远程跑腿员现在立刻叫起来,站在前台值班,你能看着它连线和上岗。
openclaw node install --host ... --port 18789像给跑腿员办正式工位和长期排班,以后开机就能自己守在那儿。
status / stop / restart / uninstall像看值班状态、让它下岗、重新上岗,或者彻底撤掉这位值班员。
--runtime node|bun像决定这位值班员坐哪种交通工具去上岗。
第三站
官方这里写得很严,是因为 auth 这件事不能靠乱猜。
OPENCLAW_GATEWAY_TOKEN / ...PASSWORD像先翻值班员自己口袋里的门卡。
口袋没票,再去桌上总账本里翻 gateway.auth.*。
像门卡抽屉今天打不开,那就别假装自己已经拿到票,宁可不上岗。
能拿到真钥匙再上岗,拿不到就别蒙着头冲。
第四站
第一次连接不会直接变成员工,而是先生成一张待审批的 node 配对请求。
像跑腿员先走到门口报到,说“我是 node,我想加入值班队伍”。
openclaw devices list像门卫把待审批名单摊开,让你看到新来的这位。
openclaw devices approve <requestId>像给它正式盖章,发一张 node 工牌。
如果它改了 auth 细节再来,旧号会过期,就像重填了一份新入职表。
第五站
官方把这块单独提出来,是因为这不是普通 exec,而是零配置就可能自动带上的额外本领。
如果节点没关掉浏览器能力,它会像顺手举牌说“我这边还能帮你看浏览器”。
allowProfiles像只让指定几个浏览器档案能通过,别让任何人随便挑任意 profile。
enabled: false像把这块招牌先收起来,只保留命令跑腿,不做代理浏览器。
这位跑腿员有时不只会跑腿,还会顺手带一台浏览器代理车。
最后总结
openclaw node 压成一句话openclaw node 就像把远方机器变成一个轻量跑腿员:先连回 Gateway,领到 node 工牌,再替总控室在那台机器上执行命令,必要时还顺手做代理浏览器。