WSL2 + Windows + 원격 Chrome CDP 문제 해결

​

먼저 올바른 브라우저 모드 선택하기

​

옵션 1: WSL2에서 Windows로 원시 원격 CDP 사용

​

옵션 2: 호스트 로컬 Chrome MCP

​

정상 작동 아키텍처

• 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에서 접근 가능한 주소를 브라우저 프로필에 지정합니다

​

Control UI의 핵심 규칙

http://127.0.0.1:18789/

​

계층별 검증

​

계층 1: Windows에서 Chrome이 CDP를 제공하는지 확인

chrome.exe --remote-debugging-port=9222 --user-data-dir="$env:LOCALAPPDATA\OpenClaw\ChromeCDP"

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

​

portproxy를 변경하기 전에 IPv4 및 IPv6 진단하기

netstat -ano | findstr :9222
netsh interface portproxy show all
curl.exe http://127.0.0.1:9222/json/version
curl.exe http://[::1]:9222/json/version

• chrome.exe가 127.0.0.1에서 응답하면 127.0.0.1:9222에서도 수신하는 모든 portproxy 규칙을 제거하세요. WSL2에서 접근 가능한 Windows 어댑터 주소만 127.0.0.1로 전달하세요.
• chrome.exe가 [::1]에서만 응답하면 사용하지 않는 IPv4 주소로 전달하는 대신 v4tov6를 사용하여 WSL2에서 접근 가능한 리스너가 ::1을 가리키도록 하세요.
  netsh interface portproxy add v4tov6 listenaddress=WINDOWS_HOST_OR_IP listenport=9222 connectaddress=::1 connectport=9222
  

​

계층 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을 반환합니다(열린 페이지가 없으면 빈 배열이어도 됩니다)

​

계층 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 인증 문제를 브라우저 문제로 오인하여 디버깅하고 있지 않습니다

​

계층 5: 종단 간 브라우저 제어 확인

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

• Windows Chrome에서 탭이 열립니다
• browser tabs가 대상을 반환합니다
• 이후 작업(snapshot, screenshot, navigate)이 동일한 프로필에서 작동합니다

​

혼동하기 쉬운 일반적인 오류

​

빠른 분류 체크리스트

1. Windows: 127.0.0.1과 [::1] 중 어느 주소가 /json/version에 응답하며, 해당 리스너가 chrome.exe에 속합니까?
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. 원시 원격 CDP 대신 WSL2와 Windows 사이에서 existing-session을 사용하려고 합니까?

​

관련 문서

• 브라우저
• 브라우저 로그인
• 브라우저 Linux 문제 해결