openclaw nodes

管理已配對的節點（裝置）並呼叫節點能力。

相關資源：

• 節點概覽：Nodes
• 攝影機：Camera nodes
• 圖片：Image nodes

通用選項：

• --url、--token、--timeout、--json

常用指令

openclaw nodes list
openclaw nodes list --connected
openclaw nodes list --last-connected 24h
openclaw nodes pending
openclaw nodes approve <requestId>
openclaw nodes status
openclaw nodes status --connected
openclaw nodes status --last-connected 24h

nodes list 會列印待審核/已配對的表格。已配對的列會包含最近一次連線時間（Last Connect）。 使用 --connected 僅顯示目前已連線的節點。使用 --last-connected <duration> 可 篩選在指定時間範圍內連線過的節點（例如 24h、7d）。

呼叫 / 執行

openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>
openclaw nodes run --node <id|name|ip> <command...>
openclaw nodes run --raw "git status"
openclaw nodes run --agent main --node <id|name|ip> --raw "git status"

呼叫旗標：

• --params <json>：JSON 物件字串（預設 {}）。
• --invoke-timeout <ms>：節點呼叫逾時（預設 15000）。
• --idempotency-key <key>：選填的冪等鍵。

指令執行預設行為

nodes run 仿照模型的指令執行行為（預設值 + 核准機制）：

• 讀取 tools.exec.*（以及 agents.list[].tools.exec.* 的覆寫設定）。
• 呼叫 system.run 前會使用指令核准機制（exec.approval.request）。
• 當 tools.exec.node 已設定時，可省略 --node。
• 需要公告 system.run 的節點（macOS 輔助程式或無頭節點主機）。

旗標：

• --cwd <path>：工作目錄。
• --env <key=val>：環境變數覆寫（可重複）。注意：節點主機會忽略 PATH 覆寫（tools.exec.pathPrepend 不適用於節點主機）。
• --command-timeout <ms>：指令逾時。
• --invoke-timeout <ms>：節點呼叫逾時（預設 30000）。
• --needs-screen-recording：要求螢幕錄製權限。
• --raw <command>：執行 shell 字串（/bin/sh -lc 或 cmd.exe /c）。 在 Windows 節點主機的允許清單模式下，cmd.exe /c shell 包裝執行需要核准 （僅有允許清單項目不會自動允許包裝形式）。
• --agent <id>：代理範圍的核准/允許清單（預設使用已設定的代理）。
• --ask <off|on-miss|always>、--security <deny|allowlist|full>：覆寫設定。