OC
OpenClaw 中文解释版

给五岁小朋友也能看懂的说明书

简要总结

node

这页说明书是讲一个叫 openclaw node 的小工具。它就像一台听话的“遥控小汽车”,你可以把它放在家里的另一台电脑上。然后,你在主电脑上,就能让“小助手”去遥控那台电脑,让它帮你运行一些命令。这页就是教你怎么让这台“遥控小汽车”跑起来,以及怎么让它一直在后台工作。

五岁小孩版解释

openclaw node 是一个程序,它能让你的电脑变成一个“节点主机”。你可以把它想象成一个“遥控接收器”。当它运行起来,并且连接到主电脑(我们叫它“网关”)后,主电脑上的“小助手”就能通过它,在这台电脑上运行命令了。这在你不想在另一台电脑上安装完整软件时特别有用。

为什么需要它? 比如,你想让“小助手”帮你管理家里的另一台电脑(可能是 Linux 或 Windows 的),或者一台专门用来做事的服务器。有了这个“节点主机”,你就不用在那台电脑上也装一个完整的软件了。而且,命令能不能运行,还需要经过你的批准,所以很安全。

一个方便的功能:浏览器代理 这个“节点主机”还会自动提供一个“浏览器遥控”功能。这就像给你的浏览器也装了个遥控器。这样,“小助手”就能直接在这台电脑上帮你操作网页了。如果你不想要这个功能,可以关掉它。方法是修改一个叫 nodeHost.browserProxy.enabled 的设置,把它改成 false

怎么让它跑起来?(前台运行) 就像启动一个普通游戏一样,你可以在电脑的命令行窗口里输入命令,让它立刻开始工作。这个命令是: openclaw node run --host <gateway-host> --port 18789

  • --host:后面要写上你的“主电脑”(网关)的地址,比如 127.0.0.1
  • --port:后面要写上端口号,通常是 18789
  • 还有其他一些选项,比如 --tls 是让连接更安全,--display-name 是给这个节点起个好记的名字。

怎么让它一直工作?(后台服务) 如果你希望这个“遥控接收器”一直开着,即使你关掉了命令行窗口,你可以把它“安装”成一个后台服务。就像把玩具设置成自动模式。命令是: openclaw node install --host <gateway-host> --port 18789 这个命令的选项和上面 run 命令的选项差不多。安装好后,你可以用下面这些命令来管理它:

  • openclaw node status:看看它是不是正在工作。
  • openclaw node stop:让它暂停工作。
  • openclaw node restart:让它重新开始工作。
  • openclaw node uninstall:把它从后台服务里移除。

第一次连接需要“配对” 当你第一次运行“节点主机”时,它需要得到主电脑的同意才能连接。这就像新玩具要和遥控器配对一样。你需要在主电脑上运行:

  1. openclaw devices list:看看有哪些设备在等待配对。
  2. openclaw devices approve <requestId>:批准那个角色是 node 的请求。 配对成功后,信息会保存在 ~/.openclaw/node.json 这个文件里。

重要的事情:运行命令需要批准 即使连接上了,“小助手”想在这台电脑上运行命令(使用 system.run),还需要得到额外的批准。这就像爸爸妈妈同意你才能玩某个玩具。批准的方式有几种:

  • 直接编辑这台电脑上的 ~/.openclaw/exec-approvals.json 文件。
  • 或者,在主电脑上使用 openclaw approvals --node <节点名字> 命令来管理。 这样就能确保只有你允许的命令才能被执行。

怎么告诉它主电脑的密码? 在运行 openclaw node runinstall 时,你不需要直接在命令里写密码。程序会自己从两个地方找:

  1. 首先看一个叫 OPENCLAW_GATEWAY_TOKENOPENCLAW_GATEWAY_PASSWORD 的秘密环境变量。
  2. 如果没找到,再看本地的配置文件里的 gateway.auth.tokengateway.auth.password 设置。