Nodes

节点就像你的小帮手，它们不是总指挥中心，而是听指挥中心命令的设备。它们可以是苹果电脑、苹果手机、安卓手机，或者没有屏幕的电脑。它们通过一个叫 WebSocket 的“电话线”连接到总指挥中心。

第一步：让节点和总指挥中心成为好朋友（配对） 要让节点开始工作，首先要让总指挥中心认识它、信任它。这个过程叫“配对”。

1. 节点会向总指挥中心说：“你好，我是新来的。”
2. 总指挥中心会问：“这个新朋友可以信任吗？”
3. 你需要告诉总指挥中心：“是的，可以信任它。”
   • 怎么做呢？在总指挥中心那台电脑上，打开一个叫“终端”的窗口，输入命令：openclaw devices list。这会列出所有等待你批准的新朋友。
   • 找到那个想当“节点”的新朋友，记下它的 requestId。
   • 输入命令：openclaw devices approve <requestId>，把 <requestId> 换成你记下的那串数字或字母。这样就批准它啦！
   • 你可以用 openclaw nodes status 看看所有节点朋友的状态。

第二步：在另一台电脑上启动一个“节点帮手” 有时候，你想让命令在另一台电脑（比如你的游戏电脑）上运行，而不是在总指挥中心那台电脑上。这时就需要在那台电脑上启动一个“节点帮手”。

1. 在你想当“节点帮手”的那台电脑上，打开“终端”。
2. 输入命令：openclaw node run --host <总指挥中心的地址> --port 18789 --display-name “我的游戏电脑”。
   • 把 <总指挥中心的地址> 换成总指挥中心那台电脑的地址（比如它的IP地址）。
   • --display-name 是给你这个节点帮手起个名字，方便你记住。
3. 如果总指挥中心只允许自己家里的设备连接（这是默认的安全设置），你就需要搭一条“秘密通道”（SSH隧道）。
   • 在一个“终端”窗口（我们叫它窗口A）输入：ssh -N -L 18790:127.0.0.1:18789 user@总指挥中心的地址。
   • 在另一个“终端”窗口（窗口B）输入：
     • export OPENCLAW_GATEWAY_TOKEN=“<你的网关令牌>”
     • openclaw node run --host 127.0.0.1 --port 18790 --display-name “我的游戏电脑”
   • 这样，节点帮手就能通过秘密通道找到总指挥中心了。

第三步：告诉节点帮手可以做什么（设置允许名单） 为了安全，节点帮手不能随便运行任何命令。你需要先告诉它哪些命令是允许的。

1. 在总指挥中心的电脑上，输入命令：openclaw approvals allowlist add --node <节点名字或ID> “/usr/bin/uname”。
2. 这个命令的意思是，允许节点帮手运行 /usr/bin/uname 这个程序（这个程序可以告诉你电脑是什么系统）。
3. 你可以用同样的方法添加其他允许的命令。

第四步：让总指挥中心把命令发给节点帮手 现在，你需要告诉总指挥中心：“以后有运行命令的活儿，就交给那个节点帮手吧！”

1. 在总指挥中心的电脑上，输入命令：
   • openclaw config set tools.exec.host node （把命令发送给节点）
   • openclaw config set tools.exec.security allowlist （使用我们刚才设置的允许名单来检查安全）
   • openclaw config set tools.exec.node “<节点帮手名字或ID>” （指定发给哪个节点帮手）

节点能帮你做什么？ 配对好并设置好后，节点就可以帮你做很多事啦！比如：

• 截图和操作网页：用 openclaw nodes canvas snapshot 命令可以让节点帮你截取屏幕上网页的图片。用 openclaw nodes canvas navigate 可以让节点帮你打开一个新网页。
• 拍照和录像：如果节点是手机，可以用 openclaw nodes camera snap 拍照，用 openclaw nodes camera clip 录一小段视频。
• 录屏：用 openclaw nodes screen record 可以录制节点的屏幕。
• 发短信（仅限安卓手机）：如果节点是安卓手机并且你同意了权限，可以用 openclaw nodes invoke 命令来发送短信。
• 运行系统命令：用 openclaw nodes run 可以在节点帮手的电脑上运行一些简单的命令，比如 echo “你好”。

要小心的事情：

• 节点只是帮手，所有消息（比如电报、WhatsApp消息）都是先到总指挥中心，不会直接到节点。
• 想让节点拍照、录屏或操作网页时，必须把节点的屏幕点亮，让应用在最前面。如果节点在后台睡觉，这些命令会失败。
• 录像和录屏的时间不能超过60秒，不然数据太大传不过来。
• 在安卓手机上用相机、录音或发短信，需要你先在手机上点“允许”。
• 位置信息功能默认是关闭的，需要你在节点上打开。
• 在苹果电脑上运行系统命令，需要在苹果电脑的OpenClaw应用设置里批准。
• 在没有屏幕的“节点帮手”电脑上运行命令，安全规则保存在它自己电脑的 ~/.openclaw/exec-approvals.json 文件里。