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.* 存储；它独立于设备配对（openclaw devices approve），后者负责控制节点的 WS connect 握手。请参阅节点，了解二者之间的关系。

  • 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>、用于覆盖检测到的 APNs 环境的 --environment <sandbox|production>。
  • 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