---
read_when:
    - ペアリングされたノード（カメラ、画面、キャンバス）を管理しています
    - リクエストを承認するか、node コマンドを実行する必要があります
summary: '`openclaw nodes` の CLI リファレンス（ステータス、ペアリング、呼び出し、カメラ/canvas/画面）'
title: Node
x-i18n:
    generated_at: "2026-05-07T13:14:32Z"
    model: gpt-5.5
    provider: openai
    source_hash: 681c199462d5f58c3e4346713263a78e7513335f087c713877e3050e21c8e15f
    source_path: cli/nodes.md
    workflow: 16
---

# `openclaw nodes`

ペアリング済みノード（デバイス）を管理し、ノード機能を呼び出します。

関連:

- ノード概要: [ノード](/ja-JP/nodes)
- カメラ: [カメラノード](/ja-JP/nodes/camera)
- 画像: [画像ノード](/ja-JP/nodes/images)

共通オプション:

- `--url`, `--token`, `--timeout`, `--json`

## 共通コマンド

```bash
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` は、保留中/ペアリング済みの表を出力します。ペアリング済みの行には、直近の接続からの経過時間（Last Connect）が含まれます。
現在接続中のノードだけを表示するには `--connected` を使用します。指定した期間内（例: `24h`, `7d`）に接続したノードに
絞り込むには `--last-connected <duration>` を使用します。
古い Gateway 所有のノードペアリングレコードを削除するには、`nodes remove --node <id|name|ip>` を使用します。

承認に関する注記:

- `openclaw nodes pending` に必要なのはペアリングスコープだけです。
- `gateway.nodes.pairing.autoApproveCidrs` は、明示的に信頼された初回の `role: node` デバイスペアリングに限り、
  保留中ステップをスキップできます。これはデフォルトでオフであり、アップグレードは承認しません。
- `openclaw nodes approve <requestId>` は、保留中のリクエストから追加のスコープ要件を継承します:
  - コマンドなしのリクエスト: ペアリングのみ
  - 非 exec ノードコマンド: ペアリング + 書き込み
  - `system.run` / `system.run.prepare` / `system.which`: ペアリング + 管理者

## 呼び出し

```bash
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` ツールを使用してください。

ノード上でシェルを実行するには、`openclaw nodes run` ではなく `host=node` 付きの `exec` ツールを使用します。
`nodes` CLI は現在、機能を中心にしています。`nodes invoke` による直接 RPC に加え、ペアリング、カメラ、
画面、位置情報、Canvas、通知を扱います。Canvas コマンドは同梱の実験的な Canvas Plugin によって実装されます。core は互換性フックを保持しているため、これらは引き続き `openclaw nodes canvas` 配下に残ります。

## 関連

- [CLI リファレンス](/ja-JP/cli)
- [ノード](/ja-JP/nodes)