CLI commands
Node
openclaw nodes
ペアリング済みノード（デバイス）を管理し、ノードの機能を呼び出します。
関連:
共通オプション:
--url,--token,--timeout,--json
共通コマンド
openclaw nodes listopenclaw nodes list --connectedopenclaw nodes list --last-connected 24hopenclaw nodes pendingopenclaw 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 statusopenclaw nodes status --connectedopenclaw nodes status --last-connected 24hnodes list は保留中/ペアリング済みの表を出力します。ペアリング済みの行には、直近の接続からの経過時間（最終接続）が含まれます。
現在接続中のノードだけを表示するには --connected を使用します。ある期間内（例: 24h, 7d）に
接続したノードに絞り込むには --last-connected <duration> を使用します。
ノードのペアリングを削除するには nodes remove --node <id|name|ip> を使用します。
デバイスに基づくノードの場合、これは devices/paired.json でそのデバイスの node ロールを取り消し、
そのノードロールのセッションを切断します（混在ロールのデバイスは行を保持し、
node ロールだけを失います。ノード専用デバイスは削除されます）。また、一致する
従来の Gateway 所有ノードペアリングレコードも消去します。operator.pairing は
非オペレーターのノード行を削除できます。デバイストークンの呼び出し元が混在ロールデバイス上の
自分自身のノードロールを取り消す場合は、追加で operator.admin が必要です。
承認に関する注記:
openclaw nodes pendingに必要なのはペアリングスコープだけです。gateway.nodes.pairing.autoApproveCidrsは、明示的に信頼された初回のrole: nodeデバイスペアリングに限り、 保留ステップをスキップできます。デフォルトではオフで、アップグレードは承認しません。openclaw nodes approve <requestId>は、保留中リクエストから追加のスコープ要件を継承します:- コマンドなしリクエスト: ペアリングのみ
- 非 exec ノードコマンド: ペアリング + 書き込み
system.run/system.run.prepare/system.which: ペアリング + 管理者
呼び出し
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 の下にあります。
