一般的なトラブルシューティング

openclaw statusopenclaw gateway statusopenclaw channels status --probeopenclaw pairing list --channel <channel> [--account <id>]openclaw logs --follow

正常な出力:

• Runtime: running
• Connectivity probe: ok
• Capability: read-only、write-capable、または admin-capable
• チャンネルはトランスポートが接続済みであること、および対応している場合は channels status --probe に works または audit ok を表示します
• 送信者が承認済みです（または DM ポリシーが open/allowlist です）

ログの特徴:

• drop guild message (mention required → Discord のメンションゲートによってメッセージがブロックされました。
• pairing request → 送信者が未承認で、DM ペアリングの承認を待っています。
• チャンネルログ内の blocked / allowlist → 送信者、ルーム、またはグループがフィルタリングされました。

詳細ページ: 応答がない、チャンネルのトラブルシューティング、ペアリング

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

正常な出力:

• openclaw gateway status に Dashboard: http://... が表示されます
• Connectivity probe: ok
• Capability: read-only、write-capable、または admin-capable
• ログに認証ループがありません

ログの特徴:

• device identity required → HTTP または非セキュアなコンテキストではデバイス認証を完了できません。
• origin not allowed → ブラウザの Origin は、Control UI の Gateway 接続先で許可されていません。
• canRetryWithDeviceToken=true を伴う AUTH_TOKEN_MISMATCH → ペアリング済みトークンのキャッシュされたスコープを再利用し、信頼済みデバイストークンによる再試行が 1 回自動的に行われる場合があります。
• その再試行後も unauthorized が繰り返される → トークンまたはパスワードが間違っている、認証モードが一致していない、またはペアリング済みデバイストークンが古くなっています。
• too many failed authentication attempts (retry later) → そのブラウザの Origin から繰り返し失敗したため、一時的にロックアウトされています。localhost の他のオリジンには別のバケットが使用されます。Tailscale Serve の同時再試行に関する注意事項については、ダッシュボード／Control UI の接続を参照してください。
• gateway connect failed: → UI が誤った URL またはポートを接続先としているか、Gateway に到達できません。

詳細ページ: ダッシュボード／Control UI の接続、Control UI、認証

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

正常な出力:

• Service: ... (loaded)
• Runtime: running
• Connectivity probe: ok
• Capability: read-only、write-capable、または admin-capable

ログの特徴:

• Gateway start blocked: set gateway.mode=local または existing config is missing gateway.mode → Gateway モードが remote になっているか、設定にローカルモードのスタンプがなく、修復が必要です。
• refusing to bind gateway ... without auth → 有効な認証経路（トークン／パスワード、または設定されている場合は trusted-proxy）がない状態で、非 loopback にバインドしています。
• another gateway instance is already listening または EADDRINUSE → ポートがすでに使用されています。

詳細ページ: Gateway サービスが実行されていない、バックグラウンドプロセス、設定

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

正常な出力:

• チャンネルトランスポートが接続済みです。
• ペアリング／許可リストのチェックに合格します。
• 必要な箇所でメンションが検出されます。

ログの特徴:

• mention required → グループのメンションゲートによって処理がブロックされました。
• pairing / pending → DM の送信者がまだ承認されていません。
• not_in_channel、missing_scope、Forbidden、401/403 → チャンネル権限トークンの問題です。

詳細ページ: チャンネルは接続済みだがメッセージが流れない、チャンネルのトラブルシューティング

openclaw statusopenclaw gateway statusopenclaw cron statusopenclaw cron listopenclaw cron runs --id <jobId> --limit 20openclaw logs --follow

正常な出力:

• cron status は、スケジューラーが有効で、次回の起動時刻が設定されていることを示します。
• cron runs は、最近の ok エントリを示します。
• Heartbeat が有効で、アクティブ時間内です。

ログシグネチャ：

• cron: scheduler disabled; jobs will not run automatically → cron が無効です。
• heartbeat skipped の理由が quiet-hours → 設定されたアクティブ時間外です。
• heartbeat skipped の理由が empty-heartbeat-file → Heartbeat モニターのスクラッチには、空白、コメント、ヘッダー、フェンス、または空のチェックリストのひな形しか含まれていません。
• heartbeat skipped の理由が alerts-disabled → showOk、showAlerts、useIndicator がすべてオフです。
• requests-in-flight → メインレーンがビジー状態のため、Heartbeat の起動が延期されました。
• unknown accountId → Heartbeat の配信先アカウントが存在しません。

詳細ページ：Cron と Heartbeat の配信、スケジュールされたタスク：トラブルシューティング、Heartbeat

openclaw statusopenclaw gateway statusopenclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw logs --follow

正常な出力：

• Node が接続済みかつペアリング済みとしてロール node に表示されます。
• 呼び出しているコマンドに対応する機能が存在します。
• ツールの権限状態が許可済みです。

ログシグネチャ：

• NODE_BACKGROUND_UNAVAILABLE → Node アプリをフォアグラウンドに移動してください。
• *_PERMISSION_REQUIRED → OS 権限が拒否されているか、付与されていません。
• SYSTEM_RUN_DENIED: approval required → exec の承認待ちです。
• SYSTEM_RUN_DENIED: allowlist miss → コマンドが exec の許可リストにありません。

詳細ページ：Node はペアリング済みだがツールが失敗する、Node のトラブルシューティング、Exec の承認

openclaw config get tools.exec.hostopenclaw config get tools.exec.securityopenclaw config get tools.exec.askopenclaw gateway restart

変更点：

• 未設定の tools.exec.host はデフォルトで auto になり、サンドボックスランタイムが有効な場合は sandbox、 それ以外の場合は gateway に解決されます。
• host=auto はルーティングのみを行います。プロンプトなしの動作は、Gateway/Node 上の security=full と ask=off によって決まります。
• 未設定の tools.exec.security は、gateway/node ではデフォルトで full になります。
• 未設定の tools.exec.ask はデフォルトで off になります。
• 承認が表示される場合は、ホストローカルまたはセッション単位の何らかのポリシーによって、 exec がこれらのデフォルトより厳しく制限されています。

現在の承認不要のデフォルトに戻す：

openclaw config set tools.exec.host gatewayopenclaw config set tools.exec.security fullopenclaw config set tools.exec.ask offopenclaw gateway restart

より安全な代替手段：

• 安定したホストルーティングには、tools.exec.host=gateway のみを設定します。
• 許可リストにない場合に確認を行うホスト exec には、security=allowlist と ask=on-miss を使用します。
• サンドボックスモードを有効にして、host=auto が sandbox に再び解決されるようにします。

ログシグネチャ：

• Approval required. → コマンドは /approve ... を待機しています。
• SYSTEM_RUN_DENIED: approval required → Node ホストの exec 承認待ちです。
• exec host=sandbox requires a sandbox runtime for this session → サンドボックスが暗黙的または明示的に選択されていますが、サンドボックスモードはオフです。

詳細ページ：Exec、Exec の承認、セキュリティ：監査で確認される項目

openclaw statusopenclaw gateway statusopenclaw browser statusopenclaw logs --followopenclaw doctor

正常な出力：

• ブラウザーのステータスに running: true と、選択されたブラウザー/プロファイルが表示されます。
• openclaw プロファイルが起動するか、user プロファイルがローカルの Chrome タブを検出します。

ログシグネチャ：

• unknown command "browser" → plugins.allow が設定されており、browser が除外されています。
• Failed to start Chrome CDP on port → ローカルブラウザーの起動に失敗しました。
• browser.executablePath not found → 設定されたバイナリパスが正しくありません。
• browser.cdpUrl must be http(s) or ws(s) → 設定された CDP URL でサポートされていないスキームが使用されています。
• browser.cdpUrl has invalid port → 設定された CDP URL のポートが無効または範囲外です。
• No Chrome tabs found for profile="user" → Chrome MCP 接続プロファイルで、ローカルの Chrome タブが開かれていません。
• Remote CDP for profile "<name>" is not reachable → 設定されたリモート CDP エンドポイントにこのホストから到達できません。
• Browser attachOnly is enabled ... not reachable → 接続専用プロファイルに稼働中の CDP ターゲットがありません。
• 接続専用またはリモート CDP プロファイルに古いビューポート/ダークモード/ロケール/オフラインのオーバーライドが残っている → openclaw browser stop --browser-profile <name> を実行すると、Gateway を再起動せずに制御セッションを閉じてエミュレーション状態を解除できます。

詳細ページ：ブラウザーツールが失敗する、ブラウザーコマンドまたはツールが見つからない、ブラウザー：Linux のトラブルシューティング、ブラウザー：WSL2/Windows リモート CDP のトラブルシューティング