English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

CLI commands

Node

openclaw 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 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 は保留中/ペアリング済みのテーブルを出力します。ペアリング済みの行には、直近の接続からの経過時間（最終接続）が含まれます。 現在接続中のノードだけを表示するには --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: ペアリング + 管理者

呼び出し

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 に加え、ペアリング、カメラ、 画面、位置情報、キャンバス、通知を扱います。

関連