ノードのトラブルシューティング

ノードがステータスに表示されているのにノードツールが失敗する場合、このページを参考にしてください。

コマンドの確認手順

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

次に、ノード固有のチェックを実行します。

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>

正常な状態:

  • ノードが接続済みで、ロール node としてペアリングされている。
  • nodes describe に呼び出そうとしている機能が含まれている。
  • exec 承認が想定どおりのモード/許可リストを示している。

フォアグラウンド要件

canvas.*、camera.*、screen.* は iOS/Android ノードではフォアグラウンドでのみ動作します。

簡易チェックと対処:

openclaw nodes describe --node <idOrNameOrIp>
openclaw nodes canvas snapshot --node <idOrNameOrIp>
openclaw logs --follow

NODE_BACKGROUND_UNAVAILABLE が表示された場合、ノードアプリをフォアグラウンドに切り替えて再試行してください。

パーミッションマトリックス

機能iOSAndroidmacOS ノードアプリ典型的なエラーコード
camera.snap、camera.clipCamera（+ clip の音声にはマイク）Camera（+ clip の音声にはマイク）Camera（+ clip の音声にはマイク）*_PERMISSION_REQUIRED
screen.recordScreen Recording（+ マイクは任意）画面キャプチャプロンプト（+ マイクは任意）Screen Recording*_PERMISSION_REQUIRED
location.get使用中のみ or 常に（モードに依存）モードに基づくフォアグラウンド/バックグラウンド位置情報Location パーミッションLOCATION_PERMISSION_REQUIRED
system.runn/a（ノードホスト経由）n/a（ノードホスト経由）Exec 承認が必要SYSTEM_RUN_DENIED

ペアリングと承認の違い

これらは別のゲートです。

  1. デバイスペアリング: このノードは Gateway に接続できるか？
  2. Exec 承認: このノードは特定のシェルコマンドを実行できるか？

簡易チェック:

openclaw devices list
openclaw nodes status
openclaw approvals get --node <idOrNameOrIp>
openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"

ペアリングが不足している場合は、まずノードデバイスを承認してください。 ペアリングは正常だが system.run が失敗する場合は、exec 承認/許可リストを修正してください。

よくあるノードエラーコード

  • 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 フローで承認されない限り許可リストミスとして扱われます。

迅速な復旧ループ

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow

それでも解決しない場合:

  • デバイスペアリングを再承認。
  • ノードアプリを再度開く（フォアグラウンドに）。
  • OS パーミッションを再許可。
  • exec 承認ポリシーを再作成/調整。

関連:

arrow_back
前へ
Nodes
次へ
Media Understanding
arrow_forward