节点
“openclaw node”的 CLI 参考(列表/状态/批准/调用、相机/画布/屏幕)
管理配对节点(设备)并调用节点功能。
相关:
- 节点概述:''节点''
- 相机:''相机节点''
- 图像:''图像节点''
常用选项:
- ''--url''、''--token''、''--timeout''、''--json''
常用命令
openclaw nodes list openclaw nodes list --connected openclaw nodes list --last-connected 24h openclaw nodes pending openclaw nodes approve <requestId> openclaw nodes status openclaw nodes status --connected openclaw nodes status --last-connected 24h
''nodes list'' 打印待处理/配对的表。成对的行包括最近的连接时间(上次连接)。
使用 ''--connected'' to show only currently connected nodes. Use ''--last-connected <duration>'' to filter to nodes connected within a time period (e.g. ''24h'', ''7d'').
调用/运行
openclaw nodes invoke --node <id|name|ip> --command <command> --params <json> openclaw nodes run --node <id|name|ip> <command...> openclaw nodes run --raw "git status" openclaw nodes run --agent main --node <id|name|ip> --raw "git status"
调用标志:
- ''--params <json>'': JSON object string (default ''{}'').
- ''--invoke-timeout <ms>'': Node invoke timeout (default ''15000'').
- ''--idempotency-key <key>'': Optional idempotency key.
#
Exec 风格的默认值
''nodes run'' 反映模型的执行行为(默认+批准):
- 读取 ''tools.exec.*'' (加上 ''agents.list[].tools.exec.*'' 覆盖)。
- 在调用 ''system.run'' 之前使用执行批准 (''system.run'')。
- 当设置 ''tools.exec.node'' 时,可以省略 ''tools.exec.node''。
- 需要一个通告 ''system.run'' 的节点(macOS 配套应用程序或无头节点主机)。
标志:
- ''--cwd <path>'': Working directory.
- ''--env <key=val>'': Environment override (repeatable).
- ''--command-timeout <ms>'': Command timeout.
- ''--invoke-timeout <ms>'': Node invoke timeout (default ''30000'').
- ''--needs-screen-recording'':需要屏幕录制权限。
- ''--raw <command>'': Run shell string (''/bin/sh -lc'' or ''cmd.exe /c'').
- ''--agent <id>'': Agent-scoped approvals/allowlist (defaults to configured agent).
- ''--ask <off|on-miss|always>'', ''--security <deny|allowlist|full>'': Override.