# openclaw 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 reject <requestId>
openclaw nodes remove --node <id|name|ip>
openclaw nodes rename --node <id|name|ip> --name <displayName>
openclaw nodes status
openclaw nodes status --connected
openclaw nodes status --last-connected 24h

nodes list 會印出待處理/已配對表格。已配對列包含最近一次連線距今時間（最近連線）。 使用 --connected 只顯示目前已連線的節點。使用 --last-connected <duration> 以 篩選在某段時間內曾連線的節點（例如 24h、7d）。 使用 nodes remove --node <id|name|ip> 刪除過時且由 Gateway 擁有的節點配對記錄。

核准注意事項：

• openclaw nodes pending 只需要配對範圍。
• gateway.nodes.pairing.autoApproveCidrs 只能針對 明確信任、首次 role: node 裝置配對略過待處理步驟。它預設為關閉， 且不會核准升級。
• openclaw nodes approve <requestId> 會從待處理請求繼承額外的範圍要求：
  • 無命令請求：僅配對
  • 非 exec 節點命令：配對 + 寫入
  • system.run / system.run.prepare / system.which：配對 + 管理員

# 叫用

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

叫用旗標：

• --params <json>：JSON 物件字串（預設 {}）。
• --invoke-timeout <ms>：節點叫用逾時（預設 15000）。
• --idempotency-key <key>：選用的冪等性金鑰。
• system.run 和 system.run.prepare 在此被封鎖；請使用含 host=node 的 exec 工具進行 shell 執行。

若要在節點上執行 shell，請使用含 host=node 的 exec 工具，而不是 openclaw nodes run。 nodes CLI 現在專注於功能：透過 nodes invoke 進行直接 RPC，以及配對、相機、 螢幕、位置、canvas 和通知。

# 相關

• CLI 參考
• 節點