​

Pemecahan masalah WSL2 + Windows + Chrome CDP jarak jauh

• OpenClaw Gateway berjalan di dalam WSL2
• Chrome berjalan di Windows
• kontrol browser harus melintasi batas WSL2/Windows

​

Pilih mode browser yang tepat terlebih dahulu

​

Opsi 1: CDP jarak jauh mentah dari WSL2 ke Windows

• Gateway tetap berada di dalam WSL2
• Chrome berjalan di Windows
• Anda memerlukan kontrol browser untuk melintasi batas WSL2/Windows

​

Opsi 2: Chrome MCP lokal host

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

​

Arsitektur yang berfungsi

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

​

Mengapa penyiapan 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 tidak ada
• profil browser menunjuk ke alamat yang salah

​

Aturan penting untuk UI Kontrol

​

Validasi secara berlapis

​

Lapisan 1: Verifikasi bahwa Chrome melayani 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 bahwa 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 tersebut ke WSL2
• alamatnya salah untuk sisi WSL2
• firewall / port forwarding / proxy lokal masih belum ada

​

Lapisan 3: Konfigurasikan profil browser 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 browser 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 browser memberi Anda URL socket 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
• auth token atau pairing dikonfigurasi dengan benar
• Anda tidak sedang men-debug masalah auth UI Kontrol seolah-olah itu masalah browser

• UI Kontrol

​

Lapisan 5: Verifikasi kontrol browser end-to-end

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

• tab terbuka di Chrome Windows
• openclaw browser tabs mengembalikan target
• aksi 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 auth
• 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 menjawab, tetapi WebSocket DevTools tetap tidak bisa dibuka
• override viewport / dark-mode / locale / offline yang basi setelah sesi jarak jauh
  • jalankan openclaw browser stop --browser-profile remote
  • ini menutup sesi kontrol aktif dan melepaskan status emulasi Playwright/CDP tanpa me-restart gateway atau browser eksternal
• gateway timeout after 1500ms
  • sering kali tetap merupakan masalah keterjangkauan CDP atau endpoint jarak jauh yang lambat/tidak dapat dijangkau
• No Chrome tabs found for profile="user"
  • profil Chrome MCP lokal dipilih ketika tidak ada tab lokal host yang tersedia

​

Daftar periksa 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 lintas WSL2 dan Windows alih-alih CDP jarak jauh mentah?

​

Inti praktis

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