openclaw nodes

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

関連ドキュメント:

• ノードの概要: Nodes
• カメラ: Camera nodes
• 画像: Image nodes

共通オプション:

• --url、--token、--timeout、--json

主要コマンド

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 で現在接続中のノードのみを表示します。--last-connected <duration> で指定期間内に接続したノードをフィルタリングします（例: 24h、7d）。

invoke / run

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承認（exec.approval.request）を使用します。
• tools.exec.node が設定されている場合、--node は省略可能です。
• system.run をアドバタイズするノード（macOSコンパニオンアプリまたはヘッドレスノードホスト）が必要です。

フラグ:

• --cwd <path>: 作業ディレクトリ。
• --env <key=val>: 環境変数のオーバーライド（繰り返し指定可）。注意: ノードホストは PATH のオーバーライドを無視します（tools.exec.pathPrepend もノードホストには適用されません）。
• --command-timeout <ms>: コマンドタイムアウト。
• --invoke-timeout <ms>: ノードinvokeタイムアウト（デフォルト 30000）。
• --needs-screen-recording: 画面収録の権限を要求。
• --raw <command>: シェル文字列を実行（/bin/sh -lc または cmd.exe /c）。 Windowsノードホストの許可リストモードでは、cmd.exe /c シェルラッパー実行は承認が必要です （許可リストエントリだけではラッパー形式の自動許可にはなりません）。
• --agent <id>: エージェントスコープの承認/許可リスト（デフォルトは設定済みエージェント）。
• --ask <off|on-miss|always>、--security <deny|allowlist|full>: オーバーライド。