WSL2 + Windows + uzak Chrome CDP sorun giderme

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.

​

Önce doğru tarayıcı modunu seçin

​

Seçenek 1: WSL2’den Windows’a ham uzak CDP

• Gateway WSL2 içinde kalıyorsa
• Chrome Windows üzerinde çalışıyorsa
• tarayıcı denetiminin WSL2/Windows sınırını geçmesi gerekiyorsa

​

Seçenek 2: Ana makine yerelinde Chrome MCP

• OpenClaw ve Chrome aynı makinedeyse
• yerel oturum açılmış tarayıcı durumunu istiyorsanız
• ana makineler arası tarayıcı aktarımına ihtiyacınız yoksa
• responsebody, PDF dışa aktarma, indirme yakalama veya toplu eylemler gibi gelişmiş yönetilen/yalnızca ham CDP rotalarına ihtiyacınız yoksa

​

Çalışan mimari

• WSL2, Gateway’i 127.0.0.1:18789 üzerinde çalıştırır
• Windows, Denetim UI’ını normal bir tarayıcıda http://127.0.0.1:18789/ adresinde açar
• Windows Chrome, 9222 bağlantı noktasında bir CDP uç noktası sunar
• WSL2 bu Windows CDP uç noktasına erişebilir
• OpenClaw, bir tarayıcı profilini WSL2’den erişilebilen adrese yönlendirir

​

Bu kurulum neden kafa karıştırıcıdır

• WSL2, Windows CDP uç noktasına erişemeyebilir
• Denetim UI güvenli olmayan bir kökenden açılmış olabilir
• gateway.controlUi.allowedOrigins sayfa kökeniyle eşleşmeyebilir
• token veya eşleme eksik olabilir
• tarayıcı profili yanlış adrese işaret ediyor olabilir

​

Denetim UI için kritik kural

​

Katmanlar halinde doğrulayın

​

Katman 1: Chrome’un Windows üzerinde CDP sunduğunu doğrulayın

chrome.exe --remote-debugging-port=9222

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

​

Katman 2: WSL2’nin bu Windows uç noktasına erişebildiğini doğrulayın

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

• /json/version, Browser / Protocol-Version meta verileri içeren JSON döndürür
• /json/list, JSON döndürür (açık sayfa yoksa boş dizi de uygundur)

• Windows bağlantı noktasını henüz WSL2’ye açmıyordur
• adres WSL2 tarafı için yanlıştır
• güvenlik duvarı / bağlantı noktası yönlendirme / yerel proxy hâlâ eksiktir

​

Katman 3: Doğru tarayıcı profilini yapılandırın

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

• yalnızca Windows’ta çalışan adresi değil, WSL2’den erişilebilen adresi kullanın
• harici olarak yönetilen tarayıcılar için attachOnly: true değerini koruyun
• cdpUrl, http://, https://, ws:// veya wss:// olabilir
• OpenClaw’ın /json/version keşfetmesini istediğinizde HTTP(S) kullanın
• WS(S)‘yi yalnızca tarayıcı sağlayıcısı size doğrudan DevTools soket URL’si verdiğinde kullanın
• OpenClaw’ın başarılı olmasını beklemeden önce aynı URL’yi curl ile test edin

​

Katman 4: Denetim UI katmanını ayrı doğrulayın

• sayfa kökeni gateway.controlUi.allowedOrigins değerinin beklediğiyle eşleşiyor
• token kimlik doğrulaması veya eşleme doğru yapılandırılmış
• bir Denetim UI kimlik doğrulaması sorununu tarayıcı sorunuymuş gibi ayıklamıyorsunuz

• Denetim UI

​

Katman 5: Uçtan uca tarayıcı denetimini doğrulayın

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

• sekme Windows Chrome’da açılır
• openclaw browser tabs hedefi döndürür
• sonraki eylemler (snapshot, screenshot, navigate) aynı profilden çalışır

​

Yaygın yanıltıcı hatalar

• control-ui-insecure-auth
  • UI kökeni / güvenli bağlam sorunu, CDP aktarım sorunu değil
• token_missing
  • kimlik doğrulama yapılandırması sorunu
• pairing required
  • cihaz onayı sorunu
• Remote CDP for profile "remote" is not reachable
  • WSL2 yapılandırılmış cdpUrl adresine erişemiyor
• Browser attachOnly is enabled and CDP websocket for profile "remote" is not reachable
  • HTTP uç noktası yanıt verdi, ancak DevTools WebSocket hâlâ açılamadı
• uzak bir oturumdan sonra eski görünüm alanı / koyu mod / yerel ayar / çevrimdışı geçersiz kılmaları
  • openclaw browser stop --browser-profile remote çalıştırın
  • bu, Gateway’i veya harici tarayıcıyı yeniden başlatmadan etkin denetim oturumunu kapatır ve Playwright/CDP emülasyon durumunu serbest bırakır
• gateway timeout after 1500ms
  • çoğu zaman hâlâ CDP erişilebilirliği veya yavaş/erişilemeyen uzak uç nokta sorunudur
• No Chrome tabs found for profile="user"
  • ana makine yerelinde kullanılabilir sekme yokken yerel Chrome MCP profili seçilmiştir

​

Hızlı triyaj kontrol listesi

1. Windows: curl http://127.0.0.1:9222/json/version çalışıyor mu?
2. WSL2: curl http://WINDOWS_HOST_OR_IP:9222/json/version çalışıyor mu?
3. OpenClaw yapılandırması: browser.profiles.<name>.cdpUrl tam olarak bu WSL2’den erişilebilen adresi mi kullanıyor?
4. Denetim UI: LAN IP’si yerine http://127.0.0.1:18789/ adresini mi açıyorsunuz?
5. Ham uzak CDP yerine WSL2 ile Windows arasında existing-session kullanmaya mı çalışıyorsunuz?

​

Pratik çıkarım

• önce Windows Chrome uç noktasını yerelde doğrulayın
• ardından aynı uç noktayı WSL2’den doğrulayın
• ancak bundan sonra OpenClaw yapılandırmasını veya Denetim UI kimlik doğrulamasını ayıklayın

​

İlgili

• Tarayıcı
• Tarayıcı oturum açma
• Tarayıcı Linux sorun giderme