OpenClawSkills
GitHub
CLI 参考 • 5 分钟阅读

节点

“openclaw node”的 CLI 参考(列表/状态/批准/调用、相机/画布/屏幕)

管理配对节点(设备)并调用节点功能。

相关:

- 节点概述:''节点''

- 相机:''相机节点''

- 图像:''图像节点''

常用选项:

- ''--url''、''--token''、''--timeout''、''--json''

Tutorial.step

常用命令

Bash
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'').

Tutorial.step

调用/运行

Bash
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.

#

Tutorial.step

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.