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

# ノード

# `openclaw nodes`

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

関連項目:

* ノード概要： [Nodes](/nodes)
* カメラ： [Camera nodes](/nodes/camera)
* 画像： [Image nodes](/nodes/images)

共通オプション：

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

## 共通コマンド

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes list
openclaw nodes list --connected
openclaw nodes list --last-connected 24h
openclaw nodes pending
openclaw nodes approve <requestId>
openclaw nodes status
openclaw nodes status --connected
openclaw nodes status --last-connected 24h
```

`nodes list` は保留/ペアテーブルを表示します。 ペアリングされた行には、最新の接続年齢 (Last Connect) が含まれます。
現在接続されているノードのみを表示するには、 `--connected` を使用します。 \<duration>には、 `--last-connected
`を使用して、持続時間内に接続されたノード(例えば `24h`, `7d`)にフィルターをかけます。

## Invoke / 実行

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>
openclaw nodes run --node <id|name|ip> <command...>
openclaw nodes run --raw "git status"
openclaw nodes run --agent main --node <id|name|ip> --raw "git status"
```

Invoke フラグ：

* `--params <json>`：JSON オブジェクト文字列（デフォルト：`{}`）。
* `--invoke-timeout <ms>`：ノード Invoke のタイムアウト（デフォルト：`15000`）。
* `--idempotency-key <key>`：任意の冪等性キー。

### Exec 形式のデフォルト

`nodes run` は、モデルの exec 振る舞い（デフォルト＋承認）を反映します：

* `tools.exec.*` を読み込みます（`agents.list[].tools.exec.*` の上書きを含む）。
* `system.run` を呼び出す前に、実行承認（`exec.approval.request`）を使用します。
* `tools.exec.node` が設定されている場合、`--node` は省略できます。
* `system.run` をアドバタイズするノードが必要です（macOS コンパニオンアプリ、またはヘッドレスのノードホスト）。

フラグ：

* `--cwd <path>`：作業ディレクトリ。
* `--env <key=val>`：環境変数の上書き（繰り返し指定可）。
* `--command-timeout <ms>`：コマンドのタイムアウト。
* `--invoke-timeout <ms>`：ノード Invoke のタイムアウト（デフォルト：`30000`）。
* `--needs-screen-recording`：画面録画の権限を必須にします。
* `--raw <command>`：シェル文字列を実行します（`/bin/sh -lc` または `cmd.exe /c`）。
* `--agent <id>`：エージェントスコープの承認／許可リスト（デフォルトは設定済みエージェント）。
* `--ask <off|on-miss|always>`, `--security <deny|allowlist|full>`：上書き設定。