表示にはノードがあるのにノードツールが失敗する場合は、このページを使用します。Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
コマンド手順
- Node は接続済みで、ロール
nodeとしてペアリングされています。 nodes describeに呼び出しているケイパビリティが含まれています。- Exec 承認に期待されるモード/許可リストが表示されています。
フォアグラウンド要件
canvas.*、camera.*、screen.* は iOS/Android ノードではフォアグラウンドでのみ使用できます。
クイックチェックと修正:
NODE_BACKGROUND_UNAVAILABLE が表示された場合は、ノードアプリをフォアグラウンドにして再試行してください。
権限マトリクス
| ケイパビリティ | iOS | Android | macOS ノードアプリ | 典型的な失敗コード |
|---|---|---|---|---|
camera.snap, camera.clip | カメラ（クリップ音声用のマイクも） | カメラ（クリップ音声用のマイクも） | カメラ（クリップ音声用のマイクも） | *_PERMISSION_REQUIRED |
screen.record | 画面収録（マイクは任意） | 画面キャプチャプロンプト（マイクは任意） | 画面収録 | *_PERMISSION_REQUIRED |
location.get | 使用中または常に許可（モードによる） | モードに基づくフォアグラウンド/バックグラウンド位置情報 | 位置情報権限 | LOCATION_PERMISSION_REQUIRED |
system.run | 該当なし（ノードホストパス） | 該当なし（ノードホストパス） | Exec 承認が必要 | SYSTEM_RUN_DENIED |
ペアリングと承認の違い
これらは異なるゲートです。- デバイスのペアリング: このノードは Gateway に接続できますか？
- Gateway ノードコマンドポリシー: RPC コマンド ID は
gateway.nodes.allowCommands/denyCommandsとプラットフォームのデフォルトで許可されていますか？ - Exec 承認: このノードは特定のシェルコマンドをローカルで実行できますか？
nodes describe にコマンドがない場合は、Gateway ノードコマンドポリシーと、そのノードが接続時に実際にそのコマンドを宣言したかを確認してください。
ペアリングに問題がないのに system.run が失敗する場合は、そのノードの Exec 承認/許可リストを修正してください。
ノードのペアリングは ID/信頼のゲートであり、コマンドごとの承認サーフェスではありません。system.run の場合、ノードごとのポリシーは Gateway のペアリングレコードではなく、そのノードの Exec 承認ファイル（openclaw approvals get --node ...）にあります。
承認に基づく host=node 実行では、Gateway は実行を準備済みの正規 systemRunPlan にもバインドします。承認済みの実行が転送される前に、後続の呼び出し元が command/cwd またはセッションメタデータを変更した場合、Gateway は編集済みペイロードを信頼せず、承認の不一致として実行を拒否します。
よくあるノードエラーコード
NODE_BACKGROUND_UNAVAILABLE→ アプリがバックグラウンドにあります。フォアグラウンドにしてください。CAMERA_DISABLED→ ノード設定でカメラトグルが無効です。*_PERMISSION_REQUIRED→ OS 権限がないか拒否されています。LOCATION_DISABLED→ 位置情報モードがオフです。LOCATION_PERMISSION_REQUIRED→ 要求された位置情報モードが許可されていません。LOCATION_BACKGROUND_UNAVAILABLE→ アプリはバックグラウンドにありますが、使用中のみの権限しかありません。SYSTEM_RUN_DENIED: approval required→ Exec リクエストには明示的な承認が必要です。SYSTEM_RUN_DENIED: allowlist miss→ コマンドが許可リストモードによってブロックされています。 Windows ノードホストでは、cmd.exe /c ...のようなシェルラッパー形式は、ask フローで承認されていない限り、許可リストモードで許可リストミスとして扱われます。
高速リカバリループ
- デバイスのペアリングを再承認します。
- ノードアプリを再度開きます（フォアグラウンド）。
- OS 権限を再付与します。
- Exec 承認ポリシーを再作成/調整します。