WSL2 + Windows + रिमोट Chrome CDP समस्या निवारण

​

पहले सही ब्राउज़र मोड चुनें

​

विकल्प 1: WSL2 से Windows तक रॉ रिमोट CDP

​

विकल्प 2: होस्ट-लोकल Chrome MCP

​

कार्यशील आर्किटेक्चर

• WSL2, Gateway को 127.0.0.1:18789 पर चलाता है
• 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: सत्यापित करें कि Chrome Windows पर 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 पर उत्तर देता है, तो उस portproxy नियम को हटाएँ जो 127.0.0.1:9222 पर भी सुनता है। केवल 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",
      },
    },
  },
}

• WSL2 से पहुँच योग्य पते का उपयोग करें, न कि उसका जो केवल Windows पर काम करता है
• बाहरी रूप से प्रबंधित ब्राउज़र के लिए attachOnly: true बनाए रखें
• cdpUrl, http://, https://, ws://, या wss:// हो सकता है
• जब आप चाहते हैं कि OpenClaw /json/version खोजे, तब HTTP(S) का उपयोग करें
• WS(S) का उपयोग केवल तब करें जब ब्राउज़र प्रदाता आपको सीधा DevTools सॉकेट URL देता हो
• 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 समस्या निवारण