CLI - nodes 命令

openclaw nodes

管理已配对的节点（cameras、screen、canvas 等）并调用节点能力。

常用命令

openclaw nodes list                          # 列出 pending + paired 节点
openclaw nodes list --connected              # 仅显示当前在线节点
openclaw nodes list --last-connected 24h     # 过滤最近 24h 内连接过的节点
openclaw nodes pending                       # 查看待审批配对请求
openclaw nodes approve <requestId>           # 审批配对请求
openclaw nodes reject <requestId>            # 拒绝配对请求
openclaw nodes remove --node <id|name|ip>    # 删除节点配对记录
openclaw nodes rename --node <id|name|ip> --name <displayName>
openclaw nodes status                        # 节点状态概览

审批权限说明

• openclaw nodes pending 仅需 pairing scope
• openclaw nodes approve <requestId> 的额外权限要求：
  • 无命令请求：仅 pairing
  • 非 exec 节点命令：pairing + write
  • system.run / system.run.prepare / system.which：pairing + admin
• gateway.nodes.pairing.autoApproveCidrs 可对受信 CIDR 的首次 role: node 请求自动审批（默认关闭）

调用节点命令

openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>

调用参数：

• --params <json>：JSON 对象字符串，默认 {}
• --invoke-timeout <ms>：超时，默认 15000ms
• --idempotency-key <key>：幂等键（可选）

注意：system.run 和 system.run.prepare 不能通过 nodes invoke 调用，需使用 exec 工具（host=node）。

通用选项

• --url：Gateway WebSocket URL
• --token：Gateway token
• --timeout：RPC 超时
• --json：JSON 输出

相关链接

• cli-node — 无头节点主机
• cli-devices — 设备配对与 token 管理