​

Усунення проблем WSL2 + Windows + віддаленого Chrome CDP

• OpenClaw Gateway працює всередині WSL2
• Chrome працює у Windows
• керування браузером має проходити через межу між WSL2 і Windows

​

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

​

Варіант 1: Сирий віддалений CDP з WSL2 до Windows

• Gateway залишається всередині WSL2
• Chrome працює у Windows
• вам потрібно, щоб керування браузером проходило через межу між WSL2 і Windows

​

Варіант 2: Host-local Chrome MCP

• OpenClaw і Chrome працюють на одній машині
• ви хочете використовувати локальний браузерний стан із входом у систему
• вам не потрібен крос-хостовий транспорт браузера
• вам не потрібні розширені маршрути лише для managed/raw-CDP, такі як responsebody, експорт PDF, перехоплення завантажень або пакетні дії

​

Робоча архітектура

• WSL2 запускає Gateway на 127.0.0.1:18789
• Windows відкриває Control UI у звичайному браузері за адресою http://127.0.0.1:18789/
• Windows Chrome надає кінцеву точку CDP на порту 9222
• WSL2 може дістатися цієї кінцевої точки Windows CDP
• OpenClaw спрямовує профіль браузера на адресу, доступну з WSL2

​

Чому ця конфігурація збиває з пантелику

• WSL2 не може дістатися кінцевої точки Windows CDP
• Control UI відкрито з небезпечного джерела
• gateway.controlUi.allowedOrigins не збігається з джерелом сторінки
• відсутній token або pairing
• профіль браузера вказує на неправильну адресу

​

Критичне правило для Control UI

​

Перевіряйте по шарах

​

Рівень 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: Окремо перевірте шар Control UI

• джерело сторінки збігається з тим, що очікує gateway.controlUi.allowedOrigins
• автентифікацію за token або pairing налаштовано правильно
• ви не налагоджуєте проблему автентифікації 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 / 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. Control UI: чи відкриваєте ви http://127.0.0.1:18789/, а не LAN IP?
5. Чи не намагаєтеся ви використовувати existing-session між WSL2 і Windows замість сирого віддаленого CDP?

​

Практичний висновок

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