Gateway
像厨房里的总厨,负责收单、分单、调度所有活。
Cli 导读
`openclaw nodes` 管理已配对节点(设备),核心操作是查看列表、审批待配对请求、以及通过 invoke 调用设备能力。注意:shell 执行(如 system.run)已被禁止,需改用 exec 工具;审批不同命令所需权限不同,pending 只需配对权限,但 approve 可能额外需要 write 或 admin。
先讲这一页到底在解决什么
`openclaw nodes` 管理已配对节点(设备),核心操作是查看列表、审批待配对请求、以及通过 invoke 调用设备能力。注意:shell 执行(如 system.run)已被禁止,需改用 exec 工具;审批不同命令所需权限不同,pending 只需配对权限,但 approve 可能额外需要 write 或 admin。
第一站
官方一开头就说得很明确。Node 会连到 Gateway 的 WebSocket,而且它会带着 role: "node" 来报到。
像厨房里的总厨,负责收单、分单、调度所有活。
像厨房旁边的帮手桌。它能做具体动作,但不会自己变成总厨。
像一根一直插着的对讲线。Node 和 Gateway 靠它持续说话。
role: "node"像进门时贴的胸牌。告诉 Gateway:“我是来当节点帮忙的。”
第二站
官方一直在强调一件事:Node 是外围设备,不是 Gateway 服务本身。它能把自己的能力暴露出来,但它不负责当总入口。
这些都可以当 Node。它们像不同形状的小帮手桌,但都能接进同一条系统线。
像没有屏幕的后厨机器。看不见脸,但照样能干活。
Node 不跑 Gateway 服务。它只是把自己的命令、摄像头、画布、通知之类能力交给 Gateway 调用。
Node 是配件,不是总台。
第三站
官方把节点的 CLI 集合叫做 nodes。它能列清单、看状态、改名字、批准配对,也能往节点里真正送命令。
openclaw nodes list像翻一张“现在有哪些节点在场”的名单。
openclaw nodes status像抬头看仪表盘,看看这些节点有没有连上、最近有没有回来过。
openclaw nodes approve <requestId>像给刚来报到的新设备点头:“可以,你正式成为节点了。”
openclaw nodes rename --name \"Build Node\"像给这位小帮手贴一张更好认的名字牌。以后叫它就方便多了。
第四站
WS 节点要用 device pairing。官方的意思很明确:设备连上来时要先登记,Gateway 再决定放不放它进来。
Node 发起连接时,会先展示自己的身份。
Gateway 会生成一个设备配对请求,等你去批准。
没批准前,它只是门口排队的小朋友;批准后才是正式成员。
如果它改了 auth details 再来,旧票会被顶掉,新 requestId 才算数。
第五站
官方还讲了一个更实用的场景:Gateway 在一台机器上,命令想在另一台机器上跑。这时就会有 node host。
像在那台远处的机器上启动一个跑腿小帮手。它会连回 Gateway,然后替你在本机做事。
像把这位跑腿小帮手装成常驻服务,不用每次都手动叫醒它。
如果 Gateway 只听本机,那就先搭一条私密小桥,再让 node host 走桥过来。
Node host 不是“再装一个 Gateway”,而是“给远处那台机器装一个执行跑腿的人”。
第六站
官方把节点能力拆得很细。你可以把它们想成不同抽屉:有的装相机,有的装画布,有的装定位,还有的装短信。
像让节点把眼前的画面拍给你看,或者录下来。
像给节点一块可操作的白板,能展示、能导航、能截图。
像问它“你现在站在哪儿”。这个能力默认关着,要看设备和权限。
像让 Android 节点会发短信、让 macOS 节点会弹通知。
第七站
不要被一长串子命令吓到。它们大多都在做同一件事:把指定动作交给指定节点。
openclaw nodes invoke --command canvas.eval像对节点说:“帮我在那块白板上做这件事。”
openclaw nodes canvas snapshot像让节点拍一张当前画布的照片,再交给你看。
openclaw nodes camera snap像让节点把摄像头前的景象咔嚓拍下来。
openclaw nodes location get像问节点:“你现在坐标在哪儿?”
第八站
一个有界面,一个没有界面,但本质都一样:它们都是 Gateway 旁边干活的节点。
像你的菜单栏 App 自己也变成一个节点,能把本机的画布和相机能力分享出来。
像没有脸的小帮手,安静地连着 Gateway,专心做执行任务。
Nodes 这一页讲的是:让外围设备先报到,再按门牌叫它们做具体动作。