OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

ノード

openclaw nodes

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

関連項目: Node の概要 - アクティブなコンピューターの存在状態 - カメラ Node - 画像 Node

すべてのサブコマンドに共通するオプション: --url <url>、--token <token>、--timeout <ms>（デフォルト 10000）、--json。

ステータス

bash
openclaw nodes statusopenclaw nodes status --connectedopenclaw nodes status --last-connected 24hopenclaw nodes listopenclaw nodes describe --node <idOrNameOrIp>

status と list はどちらも、--connected（接続中の Node のみ）と --last-connected <duration>（例: 24h、7d。指定期間内に接続した Node のみ）を受け付けます。list は保留中の Node とペアリング済みの Node を別々の表に表示し、ペアリング済みの行には直近の接続からの経過時間（Last Connect）が含まれます。status は、Node ごとの機能、バージョン、最終入力の詳細を統合した 1 つの表に表示します。接続中の macOS Node は、アクセシビリティ権限が付与されている間のみ最終入力を報告し、最も新しい行には active と表示されます。アクティブなコンピューターの存在状態を参照してください。describe は、1 つの Node の機能、権限、アクティビティ、および有効な呼び出しコマンドと保留中の呼び出しコマンドを表示します。

ペアリング

bash
openclaw 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>

これらのコマンドは、Node の WS connect ハンドシェイクを制御するデバイスペアリング（openclaw devices approve）とは別の、Gateway が所有する node.pair.* ストアを操作します。両者の関係については、Nodeを参照してください。

  • remove は、Node のペアリング済みロールエントリを取り消します。デバイスを基盤とする Node の場合、デバイスペアリングストア内の node ロールを取り消し、その Node ロールのセッションを切断します。複数のロールを持つデバイスでは行が維持され、node ロールのみが失われます。Node 専用デバイスの行は削除されます。また、一致する従来の Gateway 所有 Node ペアリングレコードもすべて消去されます。
  • pending に必要なのは operator.pairing スコープのみです。
  • gateway.nodes.pairing.autoApproveCidrs を使用すると、明示的に信頼された初回の role: node デバイスペアリングで、保留中の手順を省略できます。デフォルトでは無効で、ロールのアップグレードは承認しません。
  • gateway.nodes.pairing.sshVerify（デフォルトで有効）は、Gateway が SSH 経由で Node ホストのデバイスキーを検証できる場合、初回の role: node デバイスペアリングを自動承認します。最初の機能サーフェスも同じ手順で承認されます。Node のペアリングを参照してください。
  • approve のスコープ要件は、保留中のリクエストで宣言されたコマンドに従います。
    • コマンドなしのリクエスト: operator.pairing
    • exec 以外の Node コマンド: operator.pairing + operator.write
    • system.run / system.run.prepare / system.which: operator.pairing + operator.admin
  • remove のスコープ: operator.pairing は、operator ではない Node の行を削除できます。複数のロールを持つデバイスで、デバイストークンの呼び出し元が自身の Node ロールを取り消す場合は、追加で operator.admin が必要です。

呼び出し

bash
openclaw nodes invoke --node <id> --command system.which --params '{"bins":["uname"]}'

フラグ:

  • --command <command>（必須）: 例: canvas.eval。
  • --params <json>: JSON オブジェクト文字列（デフォルト {}）。
  • --invoke-timeout <ms>: Node 呼び出しのタイムアウト（デフォルト 15000）。
  • --idempotency-key <key>: 任意の冪等性キー。

ここでは system.run と system.run.prepare はブロックされます。代わりに、シェルの実行には host=node を指定した exec ツールを使用してください。system.which は invoke 経由で使用できます。

通知、プッシュ、位置情報、画面

bash
openclaw nodes notify --node <id> --title "Build" --body "Done" --priority timeSensitiveopenclaw nodes push --node <id> --title "OpenClaw" --environment sandboxopenclaw nodes location get --node <id> --accuracy preciseopenclaw nodes screen record --node <id> --duration 10s --fps 10 --out ./clip.mp4
  • notify は、macOS、iOS、Android、直接接続された watchOS Node を含む、system.notify を宣言している Node にローカル通知を送信します。watchOS への直接配信には、OpenClaw がアクティブである必要があります。--title または --body が必要です。オプション: --sound <name>、--priority <passive|active|timeSensitive>、--delivery <system|overlay|auto>（デフォルト system）、--invoke-timeout <ms>（デフォルト 15000）。
  • push は、iOS Node に APNs テストプッシュを送信します。オプション: --title <text>（デフォルト OpenClaw）、--body <text>、検出された APNs 環境を上書きする --environment <sandbox|production>。
  • location get は、Node の現在位置を取得します。オプション: --max-age <ms>（キャッシュ済みの位置情報を再利用）、--accuracy <coarse|balanced|precise>、--location-timeout <ms>（デフォルト 10000）、--invoke-timeout <ms>（デフォルト 20000）。
  • screen record は短いクリップをキャプチャし、保存先のパスを表示します（--json を指定した場合は JSON を出力します）。オプション: --screen <index>（デフォルト 0）、--duration <ms|10s>（デフォルト 10000）、--fps <fps>（デフォルト 10）、--no-audio、--out <path>、--invoke-timeout <ms>（デフォルト 120000）。

カメラと Canvas のコマンドには、それぞれ専用のドキュメントがあります。カメラ Node、Canvasを参照してください。Canvas はバンドルされた実験的な Canvas Plugin によって実装されています。コアでは、互換性のためのマウントポイントとして openclaw nodes canvas を維持しています。

関連項目

Was this useful?
On this page

On this page