nodes
与网关通信并控制已配对的节点。
用法
bash
openclaw nodes <子命令> [选项]通用选项
--url: 网关 URL--token: 网关 token--timeout: 超时时间--json: JSON 输出
子命令
nodes status
显示节点状态。
bash
openclaw nodes status [--connected] [--last-connected <duration>]nodes list
列出节点。
bash
openclaw nodes list [--connected] [--last-connected <duration>]nodes describe
描述节点详情。
bash
openclaw nodes describe --node <id|name|ip>nodes pending
查看待审批的配对请求。
bash
openclaw nodes pendingnodes approve
批准配对请求。
bash
openclaw nodes approve <requestId>nodes reject
拒绝配对请求。
bash
openclaw nodes reject <requestId>nodes rename
重命名节点。
bash
openclaw nodes rename --node <id|name|ip> --name <displayName>nodes invoke
调用节点命令。
bash
openclaw nodes invoke --node <id|name|ip> --command <command> [选项]选项：
--params <json>: 参数--invoke-timeout <ms>: 调用超时--idempotency-key <key>: 幂等键
nodes run
在节点上运行命令。
bash
openclaw nodes run --node <id|name|ip> [选项] <command...>选项：
--cwd <path>: 工作目录--env KEY=VAL: 环境变量--command-timeout <ms>: 命令超时--needs-screen-recording: 需要屏幕录制--invoke-timeout <ms>: 调用超时
nodes notify
发送通知到节点（仅 macOS）。
bash
openclaw nodes notify --node <id|name|ip> [选项]选项：
--title <text>: 标题--body <text>: 内容--sound <name>: 声音--priority <passive|active|timeSensitive>: 优先级--delivery <system|overlay|auto>: 投递方式--invoke-timeout <ms>: 调用超时
摄像头命令
nodes camera list
列出摄像头。
bash
openclaw nodes camera list --node <id|name|ip>nodes camera snap
拍照。
bash
openclaw nodes camera snap --node <id|name|ip> [选项]选项：
--facing front|back|both: 摄像头方向--device-id <id>: 设备 ID--max-width <px>: 最大宽度--quality <0-1>: 质量--delay-ms <ms>: 延迟
nodes camera clip
录制视频。
bash
openclaw nodes camera clip --node <id|name|ip> [选项]选项：
--facing front|back: 摄像头方向--device-id <id>: 设备 ID--duration <ms|10s|1m>: 时长--no-audio: 不录制音频
Canvas 和屏幕命令
bash
openclaw nodes canvas snapshot --node <id|name|ip>
openclaw nodes canvas present --node <id|name|ip> [--target <urlOrPath>]
openclaw nodes canvas hide --node <id|name|ip>
openclaw nodes canvas navigate <url> --node <id|name|ip>
openclaw nodes canvas eval [<js>] --node <id|name|ip>
openclaw nodes screen record --node <id|name|ip> [--duration <ms|10s>]位置命令
bash
openclaw nodes location get --node <id|name|ip> [选项]选项：
--max-age <ms>: 最大缓存时间--accuracy <coarse|balanced|precise>: 精度--location-timeout <ms>: 定位超时
示例
bash
# 列出所有节点
openclaw nodes list
# 查看已连接的节点
openclaw nodes status --connected
# 在节点上运行命令
openclaw nodes run --node my-mac "ls -la"
# 发送通知
openclaw nodes notify --node my-mac --title "提醒" --body "任务完成"
# 拍照
openclaw nodes camera snap --node my-iphone --facing back
# 获取位置
openclaw nodes location get --node my-iphone