استكشاف أخطاء WSL2 وWindows وChrome CDP البعيد وإصلاحها

​

اختر وضع المتصفح الصحيح أولًا

​

الخيار 1: اتصال CDP خام عن بُعد من WSL2 إلى Windows

​

الخيار 2: Chrome MCP محلي على المضيف

​

البنية العاملة

• يشغّل WSL2‏ Gateway على 127.0.0.1:18789
• يفتح Windows‏ Control UI في متصفح عادي على http://127.0.0.1:18789/
• يعرض Chrome على Windows نقطة نهاية CDP على المنفذ 9222
• يستطيع WSL2 الوصول إلى نقطة نهاية CDP تلك على Windows
• يوجّه OpenClaw ملف تعريف للمتصفح إلى العنوان الذي يمكن الوصول إليه من WSL2

​

قاعدة بالغة الأهمية لـ Control UI

http://127.0.0.1:18789/

​

التحقق حسب الطبقات

​

الطبقة 1: تحقق من أن Chrome يقدّم CDP على Windows

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

​

شخّص IPv4 وIPv6 قبل تغيير portproxy

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. وجّه فقط عنوان محوّل Windows الذي يمكن لـ WSL2 الوصول إليه إلى 127.0.0.1.
• إذا استجاب chrome.exe على [::1] فقط، فوجّه المستمع الذي يمكن لـ WSL2 الوصول إليه نحو ::1 باستخدام v4tov6 بدلًا من التوجيه إلى عنوان IPv4 غير مستخدم:
  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 بيانات JSON تتضمن بيانات Browser / Protocol-Version الوصفية
• يعيد /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://
• استخدم HTTP(S) عندما تريد من OpenClaw اكتشاف /json/version
• استخدم WS(S) فقط عندما يزوّدك موفّر المتصفح بعنوان URL مباشر لمقبس DevTools
• اختبر عنوان URL نفسه باستخدام curl قبل توقع نجاح OpenClaw

​

الطبقة 4: تحقق من طبقة Control UI بصورة منفصلة

• تطابق أصل الصفحة مع ما يتوقعه gateway.controlUi.allowedOrigins
• ضبط مصادقة الرمز المميز أو الاقتران بصورة صحيحة
• أنك لا تشخّص مشكلة مصادقة في Control UI وكأنها مشكلة في المتصفح

​

الطبقة 5: تحقق من التحكم في المتصفح من البداية إلى النهاية

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

• تُفتح علامة التبويب في Chrome على Windows
• يعيد 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: هل تفتح http://127.0.0.1:18789/ بدلًا من عنوان IP للشبكة المحلية؟
5. هل تحاول استخدام existing-session عبر WSL2 وWindows بدلًا من CDP الخام عن بُعد؟

​

ذو صلة

• المتصفح
• تسجيل الدخول إلى المتصفح
• استكشاف أخطاء المتصفح على Linux وإصلاحها