OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI 命令

节点

openclaw nodes

管理已配对的节点（设备）并调用节点能力。

相关内容：节点概览 - 活跃计算机在线状态 - 摄像头节点 - 图像节点

每个子命令的通用选项：--url <url>、--token <token>、--timeout <ms>（默认值为 10000）、--json。

状态

bash
openclaw nodes statusopenclaw nodes status --connectedopenclaw nodes status --last-connected 24hopenclaw nodes listopenclaw nodes describe --node <idOrNameOrIp>

status 和 list 均接受 --connected（仅显示已连接的节点）和 --last-connected <duration>（例如 24h、7d；仅显示在该时长内连接过的节点）。list 在不同表格中分别显示待处理和已配对的节点，其中已配对行包含最近一次连接距今的时间（Last Connect）；status 显示一个合并表格，其中包含每个节点的能力、版本和最近输入详情。已连接的 macOS 节点仅在用户启用 活跃计算机检测并授予辅助功能权限后才会报告最近输入；最新的一行标记为 active。请参阅活跃计算机在线状态。describe 输出单个节点的能力、权限、活动以及生效中/待处理的调用命令。

配对

bash
openclaw nodes pendingopenclaw nodes approve <requestId>openclaw nodes reject <requestId>openclaw nodes remove --node <id|name|ip>openclaw nodes rename --node <id|name|ip> --name <displayName>

这些命令操作由 Gateway 网关所有的 node.pair.* 存储；它与用于限制节点 WS connect 握手的设备配对（openclaw devices approve）相互独立。有关两者的关系，请参阅节点。

  • remove 会撤销节点的已配对角色条目。对于设备支持的节点，此操作会撤销设备配对存储中的 node 角色，并断开其节点角色会话：混合角色设备会保留其行，只失去 node 角色；仅有节点角色的设备行则会被删除。它还会清除任何匹配的旧版 Gateway 网关所有的节点配对记录。
  • pending 仅需要 operator.pairing 权限范围。
  • gateway.nodes.pairing.autoApproveCidrs 可以为明确受信任、首次进行的 role: node 设备配对跳过待处理步骤。默认关闭；不会批准角色升级。
  • gateway.nodes.pairing.sshVerify（默认开启）会在 Gateway 网关能够通过 SSH 验证节点主机上的设备密钥时，自动批准首次进行的 role: node 设备配对；首个能力表面会在同一步骤中获得批准。请参阅节点配对。
  • approve 权限范围要求取决于待处理请求中声明的命令：
    • 不含命令的请求：operator.pairing
    • 普通节点命令：operator.pairing + operator.write
    • 管理员敏感命令（system.run、system.run.prepare、system.which、browser.proxy、fs.listDir 和 system.execApprovals.get/set）：operator.pairing + operator.admin
  • remove 权限范围：operator.pairing 可以移除非操作员节点行；由设备令牌发起的调用方在混合角色设备上撤销自身节点角色时，还需要 operator.admin。

调用

bash
openclaw nodes invoke --node <id> --command system.which --params '{"bins":["uname"]}'

标志：

  • --command <command>（必需）：例如 canvas.eval。
  • --params <json>：JSON 对象字符串（默认值为 {}）。
  • --invoke-timeout <ms>：节点调用超时时间（默认值为 15000）。
  • --idempotency-key <key>：可选的幂等键。

此处会阻止 system.run 和 system.run.prepare；如需执行 shell，请改用带有 host=node 的 exec 工具。system.which 可通过 invoke 使用。

通知、推送、位置和屏幕

bash
openclaw nodes notify --node <id> --title "Build" --body "Done" --priority timeSensitiveopenclaw nodes push --node <id> --title "OpenClaw" --environment sandboxopenclaw nodes location get --node <id> --accuracy preciseopenclaw nodes screen record --node <id> --duration 10s --fps 10 --out ./clip.mp4
  • notify 会在声明了 system.notify 的节点上发送本地通知，包括 macOS、iOS、Android 和直连的 watchOS 节点。直接投递到 watchOS 需要 OpenClaw 处于活跃状态。需要 --title 或 --body。选项：--sound <name>、--priority <passive|active|timeSensitive>、--delivery <system|overlay|auto>（默认值为 system）、--invoke-timeout <ms>（默认值为 15000）。
  • push 会向 iOS 节点发送 APNs 测试推送。选项：--title <text>（默认值为 OpenClaw）、--body <text>、--environment <sandbox|production>（用于覆盖检测到的 APNs 环境）。
  • location get 获取节点的当前位置。选项：--max-age <ms>（复用缓存的定位结果）、--accuracy <coarse|balanced|precise>、--location-timeout <ms>（默认值为 10000）、--invoke-timeout <ms>（默认值为 20000）。
  • screen record 会捕获一段短视频并输出保存路径（使用 --json 时则写入 JSON）。选项：--screen <index>（默认值为 0）、--duration <ms|10s>（默认值为 10000）、--fps <fps>（默认值为 10）、--no-audio、--out <path>、--invoke-timeout <ms>（默认值为 120000）。

摄像头和 Canvas 命令有各自的文档：摄像头节点、Canvas。Canvas 由内置的实验性 Canvas 插件实现；核心将 openclaw nodes canvas 保留为兼容性挂载点。

相关内容

Was this useful?
On this page

On this page