Cli 导读

用 CLI 管理已配对设备:配对、审批、调用能力

`openclaw nodes` 管理已配对节点(设备),核心操作是查看列表、审批待配对请求、以及通过 invoke 调用设备能力。注意:shell 执行(如 system.run)已被禁止,需改用 exec 工具;审批不同命令所需权限不同,pending 只需配对权限,但 approve 可能额外需要 write 或 admin。

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

用 CLI 管理已配对设备:配对、审批、调用能力

`openclaw nodes` 管理已配对节点(设备),核心操作是查看列表、审批待配对请求、以及通过 invoke 调用设备能力。注意:shell 执行(如 system.run)已被禁止,需改用 exec 工具;审批不同命令所需权限不同,pending 只需配对权限,但 approve 可能额外需要 write 或 admin。

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

第一站

🧩 先想画面:Gateway 在前台,Node 在旁边帮忙

官方一开头就说得很明确。Node 会连到 Gateway 的 WebSocket,而且它会带着 role: "node" 来报到。

🧑‍🍳

Gateway

像厨房里的总厨,负责收单、分单、调度所有活。

🧰

Node

像厨房旁边的帮手桌。它能做具体动作,但不会自己变成总厨。

📡

WebSocket

像一根一直插着的对讲线。Node 和 Gateway 靠它持续说话。

🏷

role: "node"

像进门时贴的胸牌。告诉 Gateway:“我是来当节点帮忙的。”

第二站

🚪 Node 不是 Gateway,它只是来开一扇小门

官方一直在强调一件事:Node 是外围设备,不是 Gateway 服务本身。它能把自己的能力暴露出来,但它不负责当总入口。

📱 macOS / iOS / Android

这些都可以当 Node。它们像不同形状的小帮手桌,但都能接进同一条系统线。

🫥 headless

像没有屏幕的后厨机器。看不见脸,但照样能干活。

🚫 不是网关

Node 不跑 Gateway 服务。它只是把自己的命令、摄像头、画布、通知之类能力交给 Gateway 调用。

⭐ 先记一句

Node 是配件,不是总台。

第三站

🛠 `openclaw nodes` 这组命令,像是在给节点发工作牌

官方把节点的 CLI 集合叫做 nodes。它能列清单、看状态、改名字、批准配对,也能往节点里真正送命令。

openclaw nodes list

像翻一张“现在有哪些节点在场”的名单。

openclaw nodes status

像抬头看仪表盘,看看这些节点有没有连上、最近有没有回来过。

openclaw nodes approve <requestId>

像给刚来报到的新设备点头:“可以,你正式成为节点了。”

openclaw nodes rename --name \"Build Node\"

像给这位小帮手贴一张更好认的名字牌。以后叫它就方便多了。

第四站

🔐 Pairing 不是装饰,它是在给节点发正式通行证

WS 节点要用 device pairing。官方的意思很明确:设备连上来时要先登记,Gateway 再决定放不放它进来。

🪪

先报到

Node 发起连接时,会先展示自己的身份。

📋

再审批

Gateway 会生成一个设备配对请求,等你去批准。

批准后才算进门

没批准前,它只是门口排队的小朋友;批准后才是正式成员。

🔁

重试会换新票

如果它改了 auth details 再来,旧票会被顶掉,新 requestId 才算数。

第五站

🧳 远程节点主机,像让另一台机器替你跑腿

官方还讲了一个更实用的场景:Gateway 在一台机器上,命令想在另一台机器上跑。这时就会有 node host。

🏃 `openclaw node run`

像在那台远处的机器上启动一个跑腿小帮手。它会连回 Gateway,然后替你在本机做事。

🛠 `openclaw node install` / `restart`

像把这位跑腿小帮手装成常驻服务,不用每次都手动叫醒它。

🔗 SSH tunnel

如果 Gateway 只听本机,那就先搭一条私密小桥,再让 node host 走桥过来。

📌 这节最重要的点

Node host 不是“再装一个 Gateway”,而是“给远处那台机器装一个执行跑腿的人”。

第六站

📷 Camera、Canvas、Location、SMS,都是节点手里不同的小本领

官方把节点能力拆得很细。你可以把它们想成不同抽屉:有的装相机,有的装画布,有的装定位,还有的装短信。

📸

Camera / Screen

像让节点把眼前的画面拍给你看,或者录下来。

🖼

Canvas

像给节点一块可操作的白板,能展示、能导航、能截图。

📍

Location

像问它“你现在站在哪儿”。这个能力默认关着,要看设备和权限。

💬

SMS / Notifications

像让 Android 节点会发短信、让 macOS 节点会弹通知。

第七站

🛠 这些命令本质上都在做“把动作送到节点那边”

不要被一长串子命令吓到。它们大多都在做同一件事:把指定动作交给指定节点。

openclaw nodes invoke --command canvas.eval

像对节点说:“帮我在那块白板上做这件事。”

openclaw nodes canvas snapshot

像让节点拍一张当前画布的照片,再交给你看。

openclaw nodes camera snap

像让节点把摄像头前的景象咔嚓拍下来。

openclaw nodes location get

像问节点:“你现在坐标在哪儿?”

第八站

🧠 macOS node mode 和 headless node host,像两种不同的小帮手外形

一个有界面,一个没有界面,但本质都一样:它们都是 Gateway 旁边干活的节点。

🖥 macOS node mode

像你的菜单栏 App 自己也变成一个节点,能把本机的画布和相机能力分享出来。

🫥 headless node host

像没有脸的小帮手,安静地连着 Gateway,专心做执行任务。

🎈 一句话收住

Nodes 这一页讲的是:让外围设备先报到,再按门牌叫它们做具体动作。