Устранение неполадок WSL2 + Windows + удаленного Chrome CDP

​

Сначала выберите правильный режим браузера

​

Вариант 1: Прямой удаленный CDP из WSL2 в Windows

• Gateway остается внутри WSL2
• Chrome работает в Windows
• вам нужно, чтобы управление браузером пересекало границу WSL2/Windows

​

Вариант 2: Локальный для хоста Chrome MCP

• OpenClaw и Chrome находятся на одной машине
• вам нужно локальное состояние браузера с выполненным входом
• вам не нужен межхостовый транспорт браузера
• вам не нужны расширенные маршруты, доступные только через управляемый/прямой CDP, такие как responsebody, экспорт PDF, перехват загрузок или пакетные действия

​

Рабочая архитектура

• WSL2 запускает Gateway на 127.0.0.1:18789
• Windows открывает интерфейс управления в обычном браузере по адресу http://127.0.0.1:18789/
• Windows Chrome предоставляет CDP-эндпоинт на порту 9222
• WSL2 может достучаться до этого CDP-эндпоинта Windows
• OpenClaw указывает профиль браузера на адрес, доступный из WSL2

​

Почему эта настройка сбивает с толку

• WSL2 не может достучаться до CDP-эндпоинта Windows
• интерфейс управления открыт из небезопасного origin
• gateway.controlUi.allowedOrigins не совпадает с origin страницы
• отсутствует токен или pairing
• профиль браузера указывает на неправильный адрес

​

Критическое правило для интерфейса управления

​

Проверяйте по уровням

​

Уровень 1: Проверьте, что Chrome отдает CDP в Windows

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 возвращает JSON с метаданными Browser / Protocol-Version
• /json/list возвращает JSON (пустой массив допустим, если страницы не открыты)

• Windows еще не предоставляет порт для WSL2
• адрес неверен для стороны WSL2
• firewall / проброс порта / локальное проксирование все еще отсутствует

​

Уровень 3: Настройте правильный профиль браузера

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

• используйте адрес, доступный из WSL2, а не тот, который работает только в Windows
• оставьте attachOnly: true для внешне управляемых браузеров
• cdpUrl может быть http://, https://, ws:// или wss://
• используйте HTTP(S), когда хотите, чтобы OpenClaw обнаруживал /json/version
• используйте WS(S) только когда провайдер браузера дает прямой URL сокета DevTools
• проверьте тот же URL через curl, прежде чем ожидать успешной работы OpenClaw

​

Уровень 4: Отдельно проверьте уровень интерфейса управления

• origin страницы совпадает с тем, что ожидает gateway.controlUi.allowedOrigins
• token auth или pairing настроены правильно
• вы не отлаживаете проблему аутентификации интерфейса управления так, будто это проблема браузера

• Интерфейс управления

​

Уровень 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
  • проблема origin UI / secure context, а не проблема транспорта 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-эндпоинт ответил, но WebSocket DevTools все равно не удалось открыть
• устаревшие переопределения viewport / dark-mode / locale / offline после удаленной сессии
  • выполните openclaw browser stop --browser-profile remote
  • это закрывает активную сессию управления и освобождает состояние эмуляции Playwright/CDP без перезапуска gateway или внешнего браузера
• 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. Интерфейс управления: открываете ли вы http://127.0.0.1:18789/ вместо LAN IP?
5. Пытаетесь ли вы использовать existing-session через WSL2 и Windows вместо прямого удаленного CDP?

​

Практический вывод

• сначала проверьте эндпоинт Windows Chrome локально
• затем проверьте тот же эндпоинт из WSL2
• только после этого отлаживайте конфигурацию OpenClaw или аутентификацию интерфейса управления

​

Связанные материалы

• Браузер
• Вход в браузер
• Диагностика браузера в Linux