Pemecahan masalah WSL2 + Windows + Chrome CDP jarak jauh

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.

​

Pilih mode peramban yang tepat terlebih dahulu

​

Opsi 1: CDP remote mentah dari WSL2 ke Windows

• Gateway tetap berada di dalam WSL2
• Chrome berjalan di Windows
• Anda perlu kontrol peramban melintasi batas WSL2/Windows

​

Opsi 2: Chrome MCP lokal-host

• OpenClaw dan Chrome berada di mesin yang sama
• Anda menginginkan status peramban lokal yang sudah masuk
• Anda tidak memerlukan transport peramban lintas-host
• Anda tidak memerlukan rute lanjutan khusus managed/raw-CDP seperti responsebody, ekspor PDF, intersepsi unduhan, atau tindakan batch

​

Arsitektur yang berfungsi

• WSL2 menjalankan Gateway di 127.0.0.1:18789
• Windows membuka UI Kontrol di peramban normal pada http://127.0.0.1:18789/
• Windows Chrome mengekspos endpoint CDP pada port 9222
• WSL2 dapat menjangkau endpoint CDP Windows tersebut
• OpenClaw mengarahkan profil peramban ke alamat yang dapat dijangkau dari WSL2

​

Mengapa pengaturan ini membingungkan

• WSL2 tidak dapat menjangkau endpoint CDP Windows
• UI Kontrol dibuka dari origin yang tidak aman
• gateway.controlUi.allowedOrigins tidak cocok dengan origin halaman
• token atau pairing hilang
• profil peramban mengarah ke alamat yang salah

​

Aturan penting untuk UI Kontrol

​

Validasi berlapis

​

Lapisan 1: Verifikasi Chrome menyajikan CDP di 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

​

Lapisan 2: Verifikasi WSL2 dapat menjangkau endpoint Windows tersebut

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

• /json/version mengembalikan JSON dengan metadata Browser / Protocol-Version
• /json/list mengembalikan JSON (array kosong tidak masalah jika tidak ada halaman yang terbuka)

• Windows belum mengekspos port ke WSL2
• alamatnya salah untuk sisi WSL2
• firewall / port forwarding / proxy lokal masih belum ada

​

Lapisan 3: Konfigurasikan profil peramban yang benar

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

• gunakan alamat yang dapat dijangkau WSL2, bukan yang hanya berfungsi di Windows
• pertahankan attachOnly: true untuk peramban yang dikelola secara eksternal
• cdpUrl dapat berupa http://, https://, ws://, atau wss://
• gunakan HTTP(S) saat Anda ingin OpenClaw menemukan /json/version
• gunakan WS(S) hanya saat penyedia peramban memberi Anda URL soket DevTools langsung
• uji URL yang sama dengan curl sebelum mengharapkan OpenClaw berhasil

​

Lapisan 4: Verifikasi lapisan UI Kontrol secara terpisah

• origin halaman cocok dengan yang diharapkan gateway.controlUi.allowedOrigins
• autentikasi token atau pairing dikonfigurasi dengan benar
• Anda tidak sedang men-debug masalah autentikasi UI Kontrol seolah-olah itu masalah peramban

• UI Kontrol

​

Lapisan 5: Verifikasi kontrol peramban end-to-end

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

• tab terbuka di Windows Chrome
• openclaw browser tabs mengembalikan target
• tindakan berikutnya (snapshot, screenshot, navigate) berfungsi dari profil yang sama

​

Error umum yang menyesatkan

• control-ui-insecure-auth
  • masalah origin UI / secure-context, bukan masalah transport CDP
• token_missing
  • masalah konfigurasi autentikasi
• pairing required
  • masalah persetujuan perangkat
• Remote CDP for profile "remote" is not reachable
  • WSL2 tidak dapat menjangkau cdpUrl yang dikonfigurasi
• Browser attachOnly is enabled and CDP websocket for profile "remote" is not reachable
  • endpoint HTTP merespons, tetapi WebSocket DevTools masih tidak dapat dibuka
• override viewport / dark-mode / locale / offline yang usang setelah sesi remote
  • jalankan openclaw browser stop --browser-profile remote
  • ini menutup sesi kontrol aktif dan melepaskan status emulasi Playwright/CDP tanpa memulai ulang gateway atau peramban eksternal
• gateway timeout after 1500ms
  • sering kali masih terkait keterjangkauan CDP atau endpoint remote yang lambat/tidak terjangkau
• No Chrome tabs found for profile="user"
  • profil Chrome MCP lokal dipilih saat tidak ada tab lokal-host yang tersedia

​

Checklist triase cepat

1. Windows: apakah curl http://127.0.0.1:9222/json/version berfungsi?
2. WSL2: apakah curl http://WINDOWS_HOST_OR_IP:9222/json/version berfungsi?
3. Konfigurasi OpenClaw: apakah browser.profiles.<name>.cdpUrl menggunakan alamat persis yang dapat dijangkau WSL2 itu?
4. UI Kontrol: apakah Anda membuka http://127.0.0.1:18789/ alih-alih IP LAN?
5. Apakah Anda mencoba menggunakan existing-session melintasi WSL2 dan Windows alih-alih CDP remote mentah?

​

Kesimpulan praktis

• verifikasi endpoint Windows Chrome secara lokal terlebih dahulu
• verifikasi endpoint yang sama dari WSL2 berikutnya
• baru kemudian debug konfigurasi OpenClaw atau autentikasi UI Kontrol

​

Terkait

• Peramban
• Login peramban
• Pemecahan masalah peramban Linux