WSL2 + Windows + リモート Chrome CDP のトラブルシューティング

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.

​

まず適切なブラウザーモードを選ぶ

​

オプション 1: WSL2 から Windows への raw remote CDP

• Gateway が WSL2 内にある
• Chrome が Windows 上で実行されている
• ブラウザー制御が WSL2/Windows 境界を越える必要がある

​

オプション 2: ホストローカル Chrome MCP

• OpenClaw と Chrome が同じマシン上にある
• ローカルのサインイン済みブラウザー状態を使いたい
• クロスホストのブラウザー転送が不要
• responsebody、PDF エクスポート、ダウンロードのインターセプト、バッチアクションのような高度な managed/raw-CDP 専用ルートが不要

​

動作するアーキテクチャ

• WSL2 が 127.0.0.1:18789 で Gateway を実行する
• Windows が通常のブラウザーで http://127.0.0.1:18789/ の Control UI を開く
• Windows Chrome がポート 9222 で CDP エンドポイントを公開する
• WSL2 からその Windows CDP エンドポイントに到達できる
• OpenClaw が WSL2 から到達可能なアドレスをブラウザープロファイルに指定する

​

この構成が分かりにくい理由

• WSL2 から Windows CDP エンドポイントに到達できない
• Control UI が非セキュアなオリジンから開かれている
• gateway.controlUi.allowedOrigins がページオリジンと一致しない
• トークンまたはペアリングが欠けている
• ブラウザープロファイルが間違ったアドレスを指している

​

Control UI の重要なルール

​

階層ごとに検証する

​

レイヤー 1: Chrome が Windows 上で CDP を提供していることを確認する

chrome.exe --remote-debugging-port=9222

curl http://127.0.0.1:9222/json/version
curl http://127.0.0.1:9222/json/list

​

レイヤー 2: WSL2 からその Windows エンドポイントに到達できることを確認する

curl http://WINDOWS_HOST_OR_IP:9222/json/version
curl http://WINDOWS_HOST_OR_IP:9222/json/list

• /json/version が Browser / Protocol-Version メタデータを含む JSON を返す
• /json/list が JSON を返す（ページが開いていない場合は空配列で問題ありません）

• Windows がまだ WSL2 にポートを公開していない
• WSL2 側にとってアドレスが間違っている
• ファイアウォール / ポート転送 / ローカルプロキシがまだ不足している

​

レイヤー 3: 正しいブラウザープロファイルを設定する

{
  browser: {
    enabled: true,
    defaultProfile: "remote",
    profiles: {
      remote: {
        cdpUrl: "http://WINDOWS_HOST_OR_IP:9222",
        attachOnly: true,
        color: "#00AA00",
      },
    },
  },
}

• Windows 上でしか動かないアドレスではなく、WSL2 から到達可能なアドレスを使う
• 外部管理ブラウザーでは attachOnly: true を維持する
• cdpUrl は http://、https://、ws://、または wss:// にできる
• OpenClaw に /json/version を検出させたい場合は HTTP(S) を使う
• ブラウザープロバイダーが直接 DevTools ソケット URL を提供する場合のみ WS(S) を使う
• OpenClaw の成功を期待する前に、同じ URL を curl でテストする

​

レイヤー 4: Control UI レイヤーを別に確認する

• ページオリジンが gateway.controlUi.allowedOrigins の期待と一致している
• トークン認証またはペアリングが正しく設定されている
• Control UI 認証問題をブラウザー問題としてデバッグしていない

• Control UI

​

レイヤー 5: エンドツーエンドのブラウザー制御を確認する

openclaw browser open https://example.com --browser-profile remote
openclaw browser tabs --browser-profile remote

• タブが Windows Chrome で開く
• openclaw browser tabs がターゲットを返す
• 後続のアクション（snapshot、screenshot、navigate）が同じプロファイルから動作する

​

誤解を招きやすい一般的なエラー

• control-ui-insecure-auth
  • UI オリジン / セキュアコンテキストの問題であり、CDP 転送の問題ではない
• token_missing
  • 認証設定の問題
• pairing required
  • デバイス承認の問題
• Remote CDP for profile "remote" is not reachable
  • WSL2 から設定済みの cdpUrl に到達できない
• Browser attachOnly is enabled and CDP websocket for profile "remote" is not reachable
  • HTTP エンドポイントは応答したが、DevTools WebSocket をまだ開けなかった
• リモートセッション後の古い viewport / dark-mode / locale / offline オーバーライド
  • openclaw browser stop --browser-profile remote を実行する
  • これは Gateway や外部ブラウザーを再起動せずに、アクティブな制御セッションを閉じ、Playwright/CDP エミュレーション状態を解放する
• gateway timeout after 1500ms
  • 多くの場合、まだ CDP 到達性または低速/到達不能なリモートエンドポイントの問題
• No Chrome tabs found for profile="user"
  • ホストローカルのタブが利用できない場所でローカル Chrome MCP プロファイルが選択されている

​

高速トリアージチェックリスト

1. Windows: curl http://127.0.0.1:9222/json/version は動作しますか?
2. WSL2: curl http://WINDOWS_HOST_OR_IP:9222/json/version は動作しますか?
3. OpenClaw 設定: browser.profiles.<name>.cdpUrl はその正確な WSL2 到達可能アドレスを使っていますか?
4. Control UI: LAN IP ではなく http://127.0.0.1:18789/ を開いていますか?
5. raw remote CDP ではなく、WSL2 と Windows をまたいで existing-session を使おうとしていますか?

​

実践的な要点

• まず Windows Chrome エンドポイントをローカルで確認する
• 次に同じエンドポイントを WSL2 から確認する
• その後でのみ OpenClaw 設定または Control UI 認証をデバッグする

​

関連

• ブラウザー
• ブラウザーログイン
• Browser Linux トラブルシューティング