OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

節點

openclaw nodes

管理已配對的節點（裝置），並叫用節點功能。

相關內容：節點概覽 - 使用中的電腦存在狀態 - 相機節點 - 影像節點

每個子命令的通用選項：--url <url>、--token <token>、--timeout <ms>（預設為 10000）、--json。

狀態

bash
openclaw nodes statusopenclaw nodes status --connectedopenclaw nodes status --last-connected 24hopenclaw nodes listopenclaw nodes describe --node <idOrNameOrIp>

status 和 list 都接受 --connected（僅限已連線的節點）及 --last-connected <duration>（例如 24h、7d；僅限在指定時間內曾連線的節點）。list 會在不同表格中顯示待處理和已配對的節點，其中已配對的資料列包含最近一次連線距今時間（Last Connect）；status 則顯示一個合併表格，其中包含各節點的功能、版本及上次輸入詳細資訊。已連線的 macOS 節點只有在獲得「輔助使用」權限時才會回報上次輸入，最新的資料列會標記為 active；請參閱使用中的電腦存在狀態。describe 會列印單一節點的功能、權限、活動，以及有效／待處理的叫用命令。

配對

bash
openclaw nodes pendingopenclaw nodes approve <requestId>openclaw nodes reject <requestId>openclaw nodes remove --node <id|name|ip>openclaw nodes rename --node <id|name|ip> --name <displayName>

這些命令會操作由閘道擁有的 node.pair.* 儲存區；該儲存區與裝置配對（openclaw devices approve）分開，後者會管控節點的 WS connect 交握。請參閱節點，了解兩者的關係。

  • remove 會撤銷節點的已配對角色項目。對於以裝置為基礎的節點，這會撤銷裝置配對儲存區中的 node 角色，並中斷其節點角色工作階段：具有混合角色的裝置會保留其資料列，只失去 node 角色；僅具節點角色的裝置資料列則會被刪除。它也會清除任何相符的舊版閘道所擁有之節點配對記錄。
  • pending 僅需要 operator.pairing 範圍。
  • gateway.nodes.pairing.autoApproveCidrs 可略過明確信任、首次進行之 role: node 裝置配對的待處理步驟。預設關閉；不會核准角色升級。
  • gateway.nodes.pairing.sshVerify（預設開啟）會在閘道可透過 SSH 向節點主機驗證裝置金鑰時，自動核准首次進行的 role: node 裝置配對；第一個功能介面會在同一步驟中獲得核准。請參閱節點配對。
  • approve 範圍需求取決於待處理要求所宣告的命令：
    • 不含命令的要求：operator.pairing
    • 一般節點命令：operator.pairing + operator.write
    • 管理員敏感命令（system.run、system.run.prepare、system.which、browser.proxy、fs.listDir 及 system.execApprovals.get/set）：operator.pairing + operator.admin
  • remove 範圍：operator.pairing 可移除非操作員節點資料列；裝置權杖呼叫端若要撤銷其在混合角色裝置上的自身節點角色，還需要 operator.admin。

叫用

bash
openclaw nodes invoke --node <id> --command system.which --params '{"bins":["uname"]}'

旗標：

  • --command <command>（必填）：例如 canvas.eval。
  • --params <json>：JSON 物件字串（預設為 {}）。
  • --invoke-timeout <ms>：節點叫用逾時（預設為 15000）。
  • --idempotency-key <key>：選用的冪等性金鑰。

此處會封鎖 system.run 和 system.run.prepare；若要執行 shell，請改用 exec 工具搭配 host=node。透過 invoke 可使用 system.which。

通知、推播、位置、螢幕

bash
openclaw nodes notify --node <id> --title "Build" --body "Done" --priority timeSensitiveopenclaw nodes push --node <id> --title "OpenClaw" --environment sandboxopenclaw nodes location get --node <id> --accuracy preciseopenclaw nodes screen record --node <id> --duration 10s --fps 10 --out ./clip.mp4
  • notify 會在宣告 system.notify 的節點上傳送本機通知，包括 macOS、iOS、Android 及直接連線的 watchOS 節點。直接傳送至 watchOS 時，OpenClaw 必須處於使用中狀態。需要 --title 或 --body。選項：--sound <name>、--priority <passive|active|timeSensitive>、--delivery <system|overlay|auto>（預設為 system）、--invoke-timeout <ms>（預設為 15000）。
  • push 會將 APNs 測試推播傳送至 iOS 節點。選項：--title <text>（預設為 OpenClaw）、--body <text>、用於覆寫偵測到之 APNs 環境的 --environment <sandbox|production>。
  • location get 會擷取節點目前的位置。選項：--max-age <ms>（重複使用快取的位置修正）、--accuracy <coarse|balanced|precise>、--location-timeout <ms>（預設為 10000）、--invoke-timeout <ms>（預設為 20000）。
  • screen record 會擷取一段短片並列印儲存路徑（或使用 --json 寫入 JSON）。選項：--screen <index>（預設為 0）、--duration <ms|10s>（預設為 10000）、--fps <fps>（預設為 10）、--no-audio、--out <path>、--invoke-timeout <ms>（預設為 120000）。

相機和 Canvas 命令各有專屬文件：相機節點、Canvas。Canvas 由隨附的實驗性 Canvas 外掛實作；核心會保留 openclaw nodes canvas 作為相容性掛載點。

相關內容

Was this useful?
On this page

On this page