การแก้ไขปัญหา WSL2 + Windows + 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.

​

เลือกโหมดเบราว์เซอร์ที่ถูกต้องก่อน

​

ตัวเลือก 1: CDP ระยะไกลแบบดิบจาก WSL2 ไปยัง Windows

• Gateway ยังคงอยู่ภายใน WSL2
• Chrome ทำงานบน Windows
• คุณต้องการให้การควบคุมเบราว์เซอร์ข้ามขอบเขต WSL2/Windows

​

ตัวเลือก 2: Chrome MCP แบบโลคัลบนโฮสต์

• OpenClaw และ Chrome อยู่บนเครื่องเดียวกัน
• คุณต้องการสถานะเบราว์เซอร์โลคัลที่ลงชื่อเข้าใช้แล้ว
• คุณไม่ต้องการการขนส่งเบราว์เซอร์ข้ามโฮสต์
• คุณไม่ต้องการเส้นทางขั้นสูงที่มีเฉพาะในแบบจัดการ/ดิบ-CDP เท่านั้น เช่น responsebody, การส่งออก PDF, การดักจับการดาวน์โหลด หรือการทำงานแบบกลุ่ม

​

สถาปัตยกรรมที่ทำงานได้

• WSL2 รัน Gateway บน 127.0.0.1:18789
• Windows เปิด UI ควบคุมในเบราว์เซอร์ปกติที่ http://127.0.0.1:18789/
• Windows Chrome เปิดเผยปลายทาง CDP บนพอร์ต 9222
• WSL2 สามารถเข้าถึงปลายทาง CDP ของ Windows นั้นได้
• OpenClaw ชี้โปรไฟล์เบราว์เซอร์ไปยังที่อยู่ที่เข้าถึงได้จาก WSL2

​

เหตุใดการตั้งค่านี้จึงทำให้สับสน

• WSL2 ไม่สามารถเข้าถึงปลายทาง CDP ของ Windows
• UI ควบคุมถูกเปิดจากต้นทางที่ไม่ปลอดภัย
• gateway.controlUi.allowedOrigins ไม่ตรงกับต้นทางของหน้า
• โทเค็นหรือการจับคู่หายไป
• โปรไฟล์เบราว์เซอร์ชี้ไปยังที่อยู่ผิด

​

กฎสำคัญสำหรับ 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
• ไฟร์วอลล์ / การส่งต่อพอร์ต / การพร็อกซีโลคัลยังขาดอยู่

​

ชั้นที่ 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: ตรวจสอบชั้น UI ควบคุมแยกต่างหาก

• ต้นทางของหน้าตรงกับที่ gateway.controlUi.allowedOrigins คาดไว้
• การยืนยันตัวตนด้วยโทเค็นหรือการจับคู่ถูกกำหนดค่าอย่างถูกต้อง
• คุณไม่ได้ดีบักปัญหาการยืนยันตัวตนของ UI ควบคุมราวกับเป็นปัญหาเบราว์เซอร์

• 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 / บริบทปลอดภัย ไม่ใช่ปัญหาการขนส่ง 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 ตอบกลับแล้ว แต่ยังไม่สามารถเปิด DevTools WebSocket ได้
• การแทนที่ 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. UI ควบคุม: คุณกำลังเปิด http://127.0.0.1:18789/ แทน IP บน LAN อยู่หรือไม่?
5. คุณกำลังพยายามใช้ existing-session ข้าม WSL2 กับ Windows แทน CDP ระยะไกลแบบดิบอยู่หรือไม่?

​

ข้อสรุปเชิงปฏิบัติ

• ตรวจสอบปลายทาง Windows Chrome แบบโลคัลก่อน
• ตรวจสอบปลายทางเดียวกันจาก WSL2 เป็นลำดับที่สอง
• จากนั้นจึงดีบักการกำหนดค่า OpenClaw หรือการยืนยันตัวตนของ UI ควบคุม

​

ที่เกี่ยวข้อง

• เบราว์เซอร์
• การเข้าสู่ระบบเบราว์เซอร์
• การแก้ปัญหาเบราว์เซอร์บน Linux