OpenClawダッシュボードが動かない時の修正方法：Web UI＆TUIガイド [2026年]

OpenClawダッシュボードが読み込めない、TUIが「gateway disconnected」と表示する、「Web login provider is not available」が表示される場合、このガイドですべての一般的な原因と修正方法を解説します。よくある問題から順に見ていきましょう。

「Web Login Provider Is Not Available」

これはダッシュボードで最も頻繁に報告されるエラーです。OpenClawのWebインターフェースがセッションを認証できないことを意味します。

原因1：ゲートウェイモードがLocalに設定されていない

Web UIが動作するには、ゲートウェイがローカルモードで実行される必要があります。

openclaw config get gateway.mode

local以外が返された場合、修正します：

openclaw config set gateway.mode "local"
openclaw restart

原因2：ゲートウェイが完全に起動していない

Web UIはゲートウェイプロセスに依存しています。ゲートウェイの起動が完了していない場合、ログインプロバイダーはまだ利用できません。

ログで準備完了シグナルを確認します：

openclaw logs --tail 30

[gateway] listening onを探してください。[entrypoint] Starting OpenClaw gatewayしか表示されない場合、ゲートウェイはまだ起動中です — 約40秒かかります。待ってから再試行してください。

原因3：ポート競合

別のプロセスがゲートウェイポート（デフォルト3001）を使用しています：

lsof -i :3001

別のプロセスがそのポートでリッスンしている場合、そのプロセスを停止するか、OpenClawのポートを変更します：

openclaw config set gateway.port 3002
openclaw restart

新しいポートでダッシュボードにアクセスします。

TUIが「Gateway Disconnected」を表示

TUI（ターミナルユーザーインターフェース）はローカルソケット経由でゲートウェイに接続します。「Gateway disconnected」はTUIがゲートウェイプロセスに到達できないことを意味します。

修正1：ゲートウェイを再起動

openclaw gateway stop
# 5秒待つ
openclaw gateway start

その後TUIを再起動：

openclaw

修正2：ゲートウェイが稼働中か確認

openclaw status

ゲートウェイが稼働していない場合、起動します：

openclaw gateway start

起動に失敗した場合、エラーを確認します：

openclaw logs --tail 50

修正3：古いPIDファイル

ゲートウェイプロセスが終了してもPIDファイルが残り、クリーンな再起動を妨げることがあります。

openclaw doctor --fix

これは古いPIDファイルを検出して削除し、ゲートウェイをクリーンに再起動します。

修正4：Docker固有のTUI問題

Dockerで実行している場合、TUIはコンテナ内のゲートウェイに接続する必要があります：

docker exec -it YOUR_CONTAINER_NAME openclaw

コンテナの外からTUIを実行しないでください — ゲートウェイソケットに到達できません。

ダッシュボードは読み込めるが空白ページ

原因1：JavaScriptエラー

ブラウザの開発者コンソール（F12またはCmd+Shift+J）を開いてエラーを確認します。一般的な問題：

• CORSエラー — ダッシュボードURLが設定されたゲートウェイURLと一致しない
• 混合コンテンツ — HTTPSでアクセスしているが、ゲートウェイがHTTP
• モジュール読み込みエラー — ブラウザキャッシュが古い

修正：ブラウザキャッシュをクリア

OpenClawのアップデート後の空白ダッシュボードページの最も一般的な原因は、古いキャッシュです。

1. ハードリフレッシュ：Ctrl+Shift+R（Windows/Linux）またはCmd+Shift+R（Mac）
2. それでも解決しない場合、サイトデータをクリア：
   • Chrome：設定 → プライバシー → 閲覧データの削除 → キャッシュされた画像とファイル
   • Firefox：設定 → プライバシー → データを消去 → キャッシュされたWebコンテンツ

原因2：不完全なアップデート

OpenClawを更新したがダッシュボードがまだ古いアセットを表示する場合：

# Dockerの場合
docker compose pull
docker compose up -d --force-recreate

# ベアメタルの場合
openclaw update
openclaw restart

ダッシュボードは読み込めるがゲートウェイに接続できない

ログインページまたはダッシュボードUIは表示されるが、「接続中...」または「接続失敗」と表示される場合。

原因1：ブラウザのゲートウェイURLが間違っている

ダッシュボードは設定に埋め込まれたゲートウェイURLに接続しようとします。期待と異なるURLからアクセスしている場合：

openclaw config get gateway.url

これがブラウザで使用しているURLと一致していることを確認します。https://openclaw.mydomain.comでOpenClawにアクセスしている場合、ゲートウェイURLが一致する必要があります。

原因2：リバースプロキシがWebSocketを転送していない

OpenClawはダッシュボードとゲートウェイ間のリアルタイム通信にWebSocket接続を使用します。多くのリバースプロキシ設定は、デフォルトでWebSocketトラフィックを転送しません^[1]。

CaddyはWebSocket転送を自動的に処理します — 追加設定不要です。

Nginxでは明示的なWebSocketヘッダーが必要です：

location / {
    proxy_pass http://127.0.0.1:3001;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

UpgradeとConnectionヘッダーは重要です。これがないと、WebSocket接続がサイレントに失敗し、ダッシュボードは読み込まれても接続されません。

原因3：Trusted Proxiesが設定されていない

OpenClawがリバースプロキシ（Caddy、Nginx、Traefik）の背後にある場合、以下を知らせる必要があります^[2]：

openclaw config set gateway.trustedProxies '["127.0.0.1"]'
openclaw restart

これがないと、セキュリティ監査がtrusted_proxies_missingをフラグし、一部の機能（Webクライアント検出を含む）がプロキシ経由で正しく動作しない場合があります。

デバイス承認が必要

新しいブラウザから接続する場合、OpenClawはデバイス承認を要求します。ダッシュボードが読み込まれるが「Device identity required」と表示される場合：

# 保留中のデバイスを一覧
openclaw devices list

# デバイスを承認
openclaw devices approve DEVICE_ID

Dockerの場合：

docker exec -it YOUR_CONTAINER_NAME openclaw devices approve DEVICE_ID

承認後、ブラウザページをリフレッシュします。

ブラウザ互換性

OpenClawのWebダッシュボードにはモダンブラウザが必要です。既知の問題：

プライベート/シークレットモード

ダッシュボードはプライベートブラウジングモードでも動作しますが、Cookieがセッション間で永続しないため、毎回デバイス承認が必要です。

干渉するブラウザ拡張機能

一部の拡張機能がダッシュボードを壊す可能性があります：

• 広告ブロッカー — WebSocket接続をブロックする場合があります。ダッシュボードドメインを許可リストに追加してください。
• プライバシー拡張機能（uBlock Origin、Privacy Badger）— ゲートウェイへの接続をブロックする場合があります。ドメインをホワイトリストに追加してください。
• VPN拡張機能 — 証明書の不一致を引き起こす可能性があります。ダッシュボードドメインでは無効にしてください。

HTTPS / SSL問題

「この接続は安全ではありません」

証明書の警告が表示される場合：

1. 自己署名証明書 — リバースプロキシが有効なTLS証明書を使用していません。Caddyを使用してLet's Encrypt証明書を自動取得してください。
2. 証明書期限切れ — 証明書の更新を確認。Caddyは自動更新。Certbotにはcronジョブが必要な場合があります。
3. ドメイン不一致 — 証明書がアクセスしているドメインと異なるドメイン用です。

混合コンテンツエラー

ダッシュボードがHTTPSで読み込まれるが、ゲートウェイにHTTPで接続しようとする場合：

openclaw config set gateway.url "https://your-domain.com"
openclaw restart

すべての接続は同じプロトコルを使用する必要があります。ダッシュボードをHTTPSで読み込んでゲートウェイにHTTPで接続することはできません。

最後の手段：フルリセット

他の方法がすべてうまくいかず、クリーンスタートが必要な場合：

# まずデータをバックアップ
cp -r /app/data /app/data-backup

# 診断ツールを実行
openclaw doctor --fix

# それでも壊れている場合、ファクトリーリセット（メモリは保持）
openclaw factory-reset --keep-memories

# 再起動
openclaw restart

完全な手順と何が保持され何が保持されないかについては、ファクトリーリセットガイドをご覧ください。

クイック診断チェックリスト

ダッシュボードが動作しない時にこのチェックリストを実行してください：

1. OpenClawは実行中か？ → openclaw status
2. ゲートウェイは準備完了か？ → ログで[gateway] listening onを確認
3. ポートにアクセスできるか？ → curl http://localhost:3001/health
4. リバースプロキシは正しく転送しているか？ → curl -I https://your-domain.com
5. Trusted Proxiesは設定されているか？ → openclaw config get gateway.trustedProxies
6. デバイスは承認済みか？ → openclaw devices list
7. ブラウザキャッシュは古くないか？ → ハードリフレッシュ（Ctrl+Shift+R）
8. ブラウザ拡張機能が干渉していないか？ → シークレットモードでテスト

インフラをスキップ

ほとんどのダッシュボード問題は、リバースプロキシの設定ミス、ポート競合、TLSセットアップの問題から生じます — OpenClawの実際の使用とは関係のないインフラの問題です。

ClawTankはリバースプロキシ、TLS、ポート割り当て、デバイス管理を自動的に処理します。OpenClawインスタンスは作成された瞬間から安定したHTTPS URLでアクセス可能です。プロキシ設定、ポートデバッグ、証明書管理は不要です。

参考文献

1. MDN Web Docs — WebSocket API
2. OpenClaw Reverse Proxy & Trusted Proxies Guide
3. OpenClaw Doctor Command Reference
4. OpenClaw Factory Reset Guide
5. Caddy — Reverse Proxy Documentation