Tarayıcı sorunlarını giderme

Sorun: 18800 numaralı bağlantı noktasında Chrome CDP başlatılamadı

{ "error": "Error: Failed to start Chrome CDP on port 18800 for profile \"openclaw\"." }

Temel neden

Ubuntu'da ve çoğu Linux dağıtımında apt install chromium, gerçek bir tarayıcı yerine bir snap sarmalayıcısı yükler:

Note, selecting 'chromium-browser' instead of 'chromium'chromium-browser is already the newest version (2:1snap1-0ubuntu2).

Snap'in AppArmor kısıtlaması, OpenClaw'un tarayıcı işlemini başlatma ve izleme biçimini engeller.

Diğer yaygın Linux başlatma hataları:

• The profile appears to be in use by another Chromium process: yönetilen profil dizinindeki eski Singleton* kilit dosyaları. Kilit, artık çalışmayan veya farklı bir ana makinedeki işleme işaret ettiğinde OpenClaw bu kilitleri kaldırır ve bir kez yeniden dener.
• Missing X server or $DISPLAY: masaüstü oturumu bulunmayan bir ana makinede görünür bir tarayıcı açıkça istenmiştir. Hem DISPLAY hem de WAYLAND_DISPLAY ayarlanmamışsa yerel yönetilen profiller Linux'ta başsız moda geri döner. OPENCLAW_BROWSER_HEADLESS=0, browser.headless: false veya browser.profiles.<name>.headless: false ayarladıysanız bu görünür mod geçersiz kılmasını kaldırın, OPENCLAW_BROWSER_HEADLESS=1 ayarlayın, Xvfb başlatın, tek seferlik yönetilen başlatma için openclaw browser start --headless komutunu çalıştırın veya OpenClaw'u gerçek bir masaüstü oturumunda çalıştırın.

Çözüm 1: Google Chrome'u yükleyin (önerilen)

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.debsudo dpkg -i google-chrome-stable_current_amd64.debsudo apt --fix-broken install -y  # bağımlılık hataları varsa

~/.openclaw/openclaw.json dosyasını güncelleyin:

{  "browser": {    "enabled": true,    "executablePath": "/usr/bin/google-chrome-stable",    "headless": true,    "noSandbox": true  }}

Çözüm 2: snap Chromium'u yalnızca bağlanma modunda kullanın

Snap Chromium'u kullanmaya devam etmeniz gerekiyorsa OpenClaw'u tarayıcıyı başlatmak yerine elle başlatılan bir tarayıcıya bağlanacak şekilde yapılandırın:

{  "browser": {    "enabled": true,    "attachOnly": true,    "headless": true,    "noSandbox": true  }}

Chromium'u elle başlatın:

chromium-browser --headless --no-sandbox --disable-gpu \  --remote-debugging-port=18800 \  --user-data-dir=$HOME/.openclaw/browser/openclaw/user-data \  about:blank &

İsteğe bağlı olarak bir systemd kullanıcı hizmetiyle otomatik başlatın:

# ~/.config/systemd/user/openclaw-browser.service[Unit]Description=OpenClaw Tarayıcısı (Chrome CDP)After=network.target [Service]ExecStart=/snap/bin/chromium --headless --no-sandbox --disable-gpu --remote-debugging-port=18800 --user-data-dir=%h/.openclaw/browser/openclaw/user-data about:blankRestart=on-failureRestartSec=5 [Install]WantedBy=default.target

systemctl --user enable --now openclaw-browser.service

Tarayıcının çalıştığını doğrulayın

curl -s http://127.0.0.1:18791/ | jq '{running, pid, chosenBrowser}'curl -s -X POST http://127.0.0.1:18791/startcurl -s http://127.0.0.1:18791/tabs

Yapılandırma başvurusu

Her iki zaman aşımı değeri de 120000 ms'ye kadar pozitif tam sayı olmalıdır; diğer değerler yapılandırma yüklenirken reddedilir. Raspberry Pi, eski VPS ana makineleri veya yavaş depolama birimlerinde Chrome'un CDP HTTP uç noktasını kullanıma sunması daha uzun sürüyorsa browser.localLaunchTimeoutMs değerini artırın. Başlatma başarılı olduğu hâlde openclaw browser start komutu hâlâ not reachable after start bildiriyorsa browser.localCdpReadyTimeoutMs değerini artırın.

Sorun: profile="user" için Chrome sekmesi bulunamadı

user (existing-session / Chrome MCP) profilini kullanıyorsunuz ve bağlanılabilecek açık sekme yok.

Düzeltme seçenekleri:

1. Bunun yerine yönetilen tarayıcıyı kullanın: openclaw browser --browser-profile openclaw start (veya browser.defaultProfile: "openclaw" ayarlayın).
2. Yerel Chrome'u en az bir açık sekmeyle çalışır durumda tutun, ardından --browser-profile user ile yeniden deneyin.

Notlar:

• user yalnızca ana makinede kullanılabilir. Linux sunucularında, konteynerlerde veya uzak ana makinelerde bunun yerine CDP profillerini tercih edin.
• user ve diğer existing-session profilleri mevcut Chrome MCP sınırlamalarını paylaşır: yalnızca referans odaklı eylemler, yükleme başına bir dosya, iletişim kutularında timeoutMs geçersiz kılması yok, wait --load networkidle yok ve yanıt gövdesi, PDF dışa aktarma, indirme yakalama veya toplu eylemler yoktur.
• Yerel openclaw sürücüsü profilleri cdpPort/cdpUrl değerlerini otomatik olarak atar; bunları yalnızca uzak CDP için elle ayarlayın.
• Uzak CDP profilleri http://, https://, ws:// ve wss:// protokollerini kabul eder. /json/version keşfi için HTTP(S), tarayıcı hizmetiniz doğrudan bir DevTools soket URL'si sağlıyorsa WS(S) kullanın.

İlgili

• Tarayıcı
• Tarayıcıda oturum açma
• Tarayıcı WSL2 sorunlarını giderme