4.24 nodes命令

openclaw nodes 命令用于管理已配对的设备并调用其功能。

核心功能

该工具允许用户"管理已配对的节点（设备）并调用节点功能"。相关资源涵盖节点概述、摄像头节点和图像节点。

列表命令

# 显示待配对和已配对的节点
openclaw nodes list

# 显示当前活动的设备
openclaw nodes list --connected

# 按连接时间过滤
openclaw nodes list --last-connected 24h

# 其他状态检查
openclaw nodes pending
openclaw nodes status

调用方法

调用节点命令有两种主要方式：

直接调用

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

Run 方式

openclaw nodes run --node <id|name|ip> <command...>

主要调用选项

选项	说明
--params <json>	接受 JSON 对象字符串（默认为空对象）
--invoke-timeout <ms>	设置节点操作超时时间
--idempotency-key <key>	可选的幂等性指定
--raw "command"	直接执行 shell 字符串
--cwd <path>	指定工作目录
--env <key=val>	环境变量覆盖
--command-timeout <ms>	命令执行超时时间

Exec 风格默认值

文档指出 nodes run 镜像模型的 exec 行为，从 tools.exec.* 设置读取配置，支持命令执行前的审批工作流。