nodes

这个工具就像是你指挥一群小帮手的遥控器。你可以用它来认识新帮手、看看哪些帮手正在工作，或者让它们执行任务。

看看有哪些小帮手 你可以用几个简单的命令来查看你的小帮手们：

1. 列出所有帮手：输入 openclaw nodes list，它就会像点名一样，把等待加入的和已经配对的帮手都列出来给你看。
2. 只看正在工作的帮手：加上 --connected，就像 openclaw nodes list --connected，这样只给你看那些现在正连着线的、能马上干活的好帮手。
3. 看最近工作过的帮手：加上 --last-connected 24h，比如 openclaw nodes list --last-connected 24h，它会帮你找出在过去一天里（24小时）曾经工作过的帮手。

批准新帮手加入 如果有新的小帮手想加入你的队伍，它会出现在“等待”名单里。你可以用 openclaw nodes pending 看看谁在等。然后，用 openclaw nodes approve <requestId> 命令，并告诉它那个等待小帮手的号码（就是 <requestId>），你一说“批准”，它就能正式成为你的帮手啦！

让帮手们干活 想让小帮手做点事情？有两个主要方法：

1. 直接告诉它做什么：用 openclaw nodes invoke 命令。你需要告诉它：找哪个帮手（--node），让它执行什么命令（--command），有时还需要一些额外的说明（--params，像一张写满要求的纸条）。这里要小心，如果任务太久，你可以用 --invoke-timeout 设置一个最长时间（比如15000毫秒），不然它可能会一直等。
2. 像在电脑上直接运行一样：用 openclaw nodes run 命令。这个更简单，就像你在自己电脑上打开一个窗口输入命令一样。你通常需要告诉它找哪个帮手（--node）。如果帮手自己已经知道要听谁的话（在 tools.exec.node 里设置好了），你甚至可以不写 --node。

用 run 命令时要注意的事情 当你用 nodes run 让帮手执行任务时，有一些特别的开关可以控制：

• --cwd：告诉帮手，工作从哪个文件夹开始。
• --env：可以临时改变帮手工作时的环境，就像给它换一件工作服。但要记住，帮手会忽略你改变 PATH 的指令。
• --raw：让帮手直接运行一串你写的“咒语”（shell命令）。在 Windows 系统的帮手上，即使这个“咒语”在允许名单里，用 cmd.exe /c 这种方式运行时，可能还需要你再批准一次。
• 帮手必须得是那种会 system.run 这个本领的才行（比如 macOS 上的伴侣程序，或者一种叫“无界面节点主机”的帮手）。

最后的小提醒

• 有些命令，比如 --url， --token， --timeout， --json，在很多地方都能用，它们是“通用选项”。
• 让帮手干活前，系统可能会先问问你同不同意（exec.approval.request），这是为了安全。
• 你可以用 --agent 指定由哪个“小管家”（代理）来负责批准和检查任务是否被允许。