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

ステータス上でノードは表示されているが、ノードツールが失敗する場合は、このページを使用してください。

コマンドラダー¶

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 に、呼び出している機能が含まれています。
• 実行承認に、期待されるモード / 許可リストが表示されています。

フォアグラウンド要件¶

canvas.*、camera.*、screen.* は、iOS/Android ノードではフォアグラウンド専用です。

簡易チェックと修正:

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

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

権限マトリクス¶

ペアリングと承認の違い¶

これらは異なるゲートです。

1. デバイスのペアリング: このノードはゲートウェイに接続できますか。
2. 実行承認: このノードは特定のシェルコマンドを実行できますか。

簡易チェック:

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

ペアリングがない場合は、最初にノードデバイスを承認してください。 ペアリングは問題なく、 system.run が失敗した場合、 exec approvals/allowlist を修正します。

一般的なノードのエラーコード¶

• NODE_BACKGROUND_UNAVAILABLE → アプリがバックグラウンドです。フォアグラウンドにしてください。
• CAMERA_DISABLED → ノード設定でカメラのトグルが無効です。
• *_PERMISSION_REQUIRED → OS の権限が不足または拒否されています。
• LOCATION_DISABLED → 位置情報モードがオフです。
• LOCATION_PERMISSION_REQUIRED → 要求された位置情報モードが付与されていません。
• LOCATION_BACKGROUND_UNAVAILABLE → アプリがバックグラウンドですが、「使用中のみ」の権限しかありません。
• SYSTEM_RUN_DENIED: approval required → 実行リクエストに明示的な承認が必要です。
• SYSTEM_RUN_DENIED: allowlist miss → コマンドが許可リストモードによりブロックされています。

迅速な復旧ループ¶

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

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

• デバイスのペアリングを再承認します。
• ノードアプリを再度開きます（フォアグラウンド）。
• OS の権限を再付与します。
• 実行承認ポリシーを再作成 / 調整します。

関連:

• /nodes/index
• /nodes/camera
• /nodes/location-command
• /tools/exec-approvals
• /gateway/pairing