跳轉到主要內容

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
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 和通知。

​
相關