Probleemoplossing voor WSL2 + Windows + externe 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.

​

Kies eerst de juiste browsermodus

​

Optie 1: Ruwe externe CDP van WSL2 naar Windows

• de Gateway binnen WSL2 blijft
• Chrome op Windows draait
• je browserbesturing de grens tussen WSL2 en Windows moet laten oversteken

​

Optie 2: Host-lokale Chrome MCP

• OpenClaw en Chrome op dezelfde machine staan
• je de lokale ingelogde browserstatus wilt
• je geen cross-host browsertransport nodig hebt
• je geen geavanceerde beheerde/alleen-raw-CDP-routes nodig hebt, zoals responsebody, PDF- export, downloadinterceptie of batchacties

​

Werkende architectuur

• WSL2 draait de Gateway op 127.0.0.1:18789
• Windows opent de Control UI in een normale browser op http://127.0.0.1:18789/
• Windows Chrome stelt een CDP-eindpunt beschikbaar op poort 9222
• WSL2 kan dat Windows CDP-eindpunt bereiken
• OpenClaw wijst een browserprofiel naar het adres dat bereikbaar is vanuit WSL2

​

Waarom deze configuratie verwarrend is

• WSL2 kan het Windows CDP-eindpunt niet bereiken
• de Control UI wordt geopend vanaf een niet-beveiligde oorsprong
• gateway.controlUi.allowedOrigins komt niet overeen met de paginaoorsprong
• token of koppeling ontbreekt
• het browserprofiel wijst naar het verkeerde adres

​

Kritieke regel voor de Control UI

​

Valideer in lagen

​

Laag 1: Controleer of Chrome CDP aanbiedt op 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

​

Laag 2: Controleer of WSL2 dat Windows-eindpunt kan bereiken

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

• /json/version retourneert JSON met Browser / Protocol-Version-metadata
• /json/list retourneert JSON (een lege array is prima als er geen pagina’s open zijn)

• Windows stelt de poort nog niet beschikbaar aan WSL2
• het adres is verkeerd voor de WSL2-kant
• firewall / port forwarding / lokale proxying ontbreekt nog steeds

​

Laag 3: Configureer het juiste browserprofiel

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

• gebruik het vanuit WSL2 bereikbare adres, niet wat alleen op Windows werkt
• houd attachOnly: true aan voor extern beheerde browsers
• cdpUrl kan http://, https://, ws:// of wss:// zijn
• gebruik HTTP(S) wanneer je wilt dat OpenClaw /json/version ontdekt
• gebruik WS(S) alleen wanneer de browserprovider je een directe DevTools-socket-URL geeft
• test dezelfde URL met curl voordat je verwacht dat OpenClaw slaagt

​

Laag 4: Controleer de Control UI-laag afzonderlijk

• de paginaoorsprong komt overeen met wat gateway.controlUi.allowedOrigins verwacht
• tokenauthenticatie of koppeling is correct geconfigureerd
• je debugt geen authenticatieprobleem van de Control UI alsof het een browserprobleem is

• Control UI

​

Laag 5: Controleer end-to-end browserbesturing

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

• het tabblad opent in Windows Chrome
• openclaw browser tabs retourneert het doel
• latere acties (snapshot, screenshot, navigate) werken vanuit hetzelfde profiel

​

Vaak misleidende fouten

• control-ui-insecure-auth
  • UI-oorsprong / secure-context-probleem, geen CDP-transportprobleem
• token_missing
  • authenticatieconfiguratieprobleem
• pairing required
  • apparaatgoedkeuringsprobleem
• Remote CDP for profile "remote" is not reachable
  • WSL2 kan de geconfigureerde cdpUrl niet bereiken
• Browser attachOnly is enabled and CDP websocket for profile "remote" is not reachable
  • het HTTP-eindpunt antwoordde, maar de DevTools WebSocket kon nog steeds niet worden geopend
• verouderde viewport- / dark-mode- / locale- / offline-overschrijvingen na een externe sessie
  • voer openclaw browser stop --browser-profile remote uit
  • dit sluit de actieve besturingssessie en geeft Playwright/CDP-emulatiestatus vrij zonder de gateway of de externe browser opnieuw te starten
• gateway timeout after 1500ms
  • vaak nog steeds CDP-bereikbaarheid of een traag/onbereikbaar extern eindpunt
• No Chrome tabs found for profile="user"
  • lokaal Chrome MCP-profiel geselecteerd terwijl er geen host-lokale tabbladen beschikbaar zijn

​

Snelle triagechecklist

1. Windows: werkt curl http://127.0.0.1:9222/json/version?
2. WSL2: werkt curl http://WINDOWS_HOST_OR_IP:9222/json/version?
3. OpenClaw-configuratie: gebruikt browser.profiles.<name>.cdpUrl dat exacte vanuit WSL2 bereikbare adres?
4. Control UI: open je http://127.0.0.1:18789/ in plaats van een LAN-IP?
5. Probeer je existing-session over WSL2 en Windows te gebruiken in plaats van ruwe externe CDP?

​

Praktische conclusie

• controleer eerst lokaal het Windows Chrome-eindpunt
• controleer daarna hetzelfde eindpunt vanuit WSL2
• debug pas daarna OpenClaw-configuratie of Control UI-authenticatie

​

Gerelateerd

• Browser
• Browserlogin
• Probleemoplossing voor Browser op Linux