> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 節點

# `openclaw nodes`

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

相關內容：[節點概覽](/zh-TW/nodes) - [使用中電腦狀態](/zh-TW/nodes/presence) - [相機節點](/zh-TW/nodes/camera) - [影像節點](/zh-TW/nodes/images)

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

## 狀態

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes status
openclaw nodes status --connected
openclaw nodes status --last-connected 24h
openclaw nodes list
openclaw nodes describe --node <idOrNameOrIp>
```

`status` 和 `list` 都接受 `--connected`（僅限已連線的節點）及 `--last-connected <duration>`（例如 `24h`、`7d`；僅限在指定期間內曾連線的節點）。`list` 會在不同表格中顯示待處理及已配對的節點，已配對的資料列會包含最近一次連線至今的時間（Last Connect）；`status` 則顯示一個合併表格，其中包含各節點的功能、版本及最後輸入詳細資訊。已連線的 macOS 節點只會在使用者啟用 **使用中電腦偵測**並授予「輔助使用」權限後回報最後輸入；最新的資料列會標示為 `active`。請參閱[使用中電腦狀態](/zh-TW/nodes/presence)。`describe` 會輸出單一節點的功能、權限、活動，以及生效中／待處理的叫用命令。

## 配對

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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>
```

這些命令會操作由閘道擁有的 `node.pair.*` 儲存區；它與裝置配對（`openclaw devices approve`）分開，後者會管控節點的 WS `connect` 交握。請參閱[節點](/zh-TW/nodes)，瞭解兩者的關係。

* `remove` 會撤銷節點的已配對角色項目。對於由裝置支援的節點，這會撤銷裝置配對儲存區中的 `node` 角色，並中斷其節點角色工作階段：具有混合角色的裝置會保留其資料列，且只失去 `node` 角色；僅有節點角色的裝置資料列則會被刪除。這也會清除任何相符的舊版閘道所擁有的節點配對記錄。
* `pending` 僅需要 `operator.pairing` 範圍。
* `gateway.nodes.pairing.autoApproveCidrs` 可針對明確信任的首次 `role: node` 裝置配對略過待處理步驟。預設關閉；不會核准角色升級。
* `gateway.nodes.pairing.sshVerify`（預設開啟）會在閘道可透過 SSH 向節點主機驗證裝置金鑰時，自動核准首次 `role: node` 裝置配對；第一個功能介面會在同一步驟中獲得核准。請參閱[節點配對](/zh-TW/gateway/pairing#ssh-verified-device-auto-approval-default)。
* `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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
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，請改用搭配 `host=node` 的 `exec` 工具。允許透過 `invoke` 使用 `system.which`。

## 通知、推播、位置、螢幕

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes notify --node <id> --title "Build" --body "Done" --priority timeSensitive
openclaw nodes push --node <id> --title "OpenClaw" --environment sandbox
openclaw nodes location get --node <id> --accuracy precise
openclaw 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 命令各有專屬文件：[相機節點](/zh-TW/nodes/camera)、[Canvas](/zh-TW/platforms/mac/canvas)。Canvas 由內建的實驗性 Canvas 外掛實作；核心會保留 `openclaw nodes canvas` 作為相容性掛載點。

## 相關內容

* [命令列介面參考](/zh-TW/cli)
* [節點](/zh-TW/nodes)