---
read_when:
    - 你正在管理已配對的節點（相機、螢幕、畫布）
    - 你需要核准請求或叫用節點命令
summary: '`openclaw nodes` 的命令列介面參考（狀態、配對、呼叫、相機／畫布／螢幕／位置／通知）'
title: 節點
x-i18n:
    generated_at: "2026-07-14T13:32:13Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 25
    provider: openai
    source_hash: 5b57235006d803fe09f626a65157dfb1f620d3d3c6f337e33132bcffdf4f1e37
    source_path: cli/nodes.md
    workflow: 16
---

# `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
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
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
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 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)