Tarayıcı sorunlarını giderme

​

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

{ "error": "Hata: \"openclaw\" profili için 18800 numaralı bağlantı noktasında Chrome CDP başlatılamadı." }

​

Temel neden

Not: 'chromium' yerine 'chromium-browser' seçiliyor
chromium-browser zaten en yeni sürümde (2:1snap1-0ubuntu2).

• The profile appears to be in use by another Chromium process: yönetilen profil dizinindeki eski Singleton* kilit dosyaları. Kilit, sonlanmış 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 olmayan bir ana makinede görünür bir tarayıcı açıkça istendi. 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 ç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.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt --fix-broken install -y  # bağımlılık hataları varsa

{
  "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

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

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

# ~/.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:blank
Restart=on-failure
RestartSec=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/start
curl -s http://127.0.0.1:18791/tabs

​

Yapılandırma referansı

​

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

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.

• user yalnızca ana makinede çalışır. 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ırlarını paylaşır: yalnızca referans odaklı eylemler, yükleme başına bir dosya, iletişim kutusu timeoutMs geçersiz kılmaları yok, wait --load networkidle yok ve responsebody, PDF dışa aktarma, indirme müdahalesi veya toplu eylemler yok.
• Yerel openclaw sürücü 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:// kabul eder. /json/version keşfi için HTTP(S) veya tarayıcı hizmetiniz size doğrudan DevTools yuva URL’si sağlıyorsa WS(S) kullanın.

​

İlgili

• Tarayıcı
• Tarayıcıda oturum açma
• Tarayıcı WSL2 sorun giderme