Rozwiązywanie problemów z przeglądarką

Problem: nie udało się uruchomić Chrome CDP na porcie 18800

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

Główna przyczyna

W systemie Ubuntu i większości dystrybucji systemu Linux polecenie apt install chromium instaluje nakładkę snap, a nie rzeczywistą przeglądarkę:

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

Mechanizm izolacji AppArmor pakietu snap zakłóca sposób, w jaki OpenClaw uruchamia i monitoruje proces przeglądarki.

Inne częste błędy uruchamiania w systemie Linux:

• The profile appears to be in use by another Chromium process: nieaktualne pliki blokad Singleton* w katalogu zarządzanego profilu. OpenClaw usuwa te blokady i ponawia próbę jeden raz, gdy blokada wskazuje na zakończony proces lub proces na innym hoście.
• Missing X server or $DISPLAY: jawnie zażądano widocznej przeglądarki na hoście bez sesji pulpitu. Lokalne zarządzane profile w systemie Linux przechodzą w tryb bez interfejsu graficznego, gdy nie ustawiono ani DISPLAY, ani WAYLAND_DISPLAY. Jeśli ustawiono OPENCLAW_BROWSER_HEADLESS=0, browser.headless: false lub browser.profiles.<name>.headless: false, usuń to wymuszenie trybu z interfejsem, ustaw OPENCLAW_BROWSER_HEADLESS=1, uruchom Xvfb, wykonaj openclaw browser start --headless, aby jednorazowo uruchomić zarządzaną przeglądarkę, albo uruchom OpenClaw w rzeczywistej sesji pulpitu.

Rozwiązanie 1: zainstaluj Google Chrome (zalecane)

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  # w przypadku błędów zależności

Zaktualizuj ~/.openclaw/openclaw.json:

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

Rozwiązanie 2: użyj Chromium z pakietu snap w trybie wyłącznie dołączania

Jeśli musisz zachować Chromium z pakietu snap, skonfiguruj OpenClaw tak, aby dołączał do ręcznie uruchomionej przeglądarki zamiast ją uruchamiać:

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

Uruchom Chromium ręcznie:

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

Opcjonalnie skonfiguruj automatyczne uruchamianie za pomocą usługi użytkownika systemd:

# ~/.config/systemd/user/openclaw-browser.service[Unit]Description=OpenClaw Browser (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

Sprawdź działanie przeglądarki

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

Dokumentacja konfiguracji

Obie wartości limitu czasu muszą być dodatnimi liczbami całkowitymi nieprzekraczającymi 120000 ms; inne wartości są odrzucane podczas wczytywania konfiguracji. Na Raspberry Pi, starszych hostach VPS lub wolnych nośnikach zwiększ browser.localLaunchTimeoutMs, gdy Chrome potrzebuje więcej czasu na udostępnienie punktu końcowego HTTP CDP. Zwiększ browser.localCdpReadyTimeoutMs, gdy uruchomienie się powiedzie, ale polecenie openclaw browser start nadal zgłasza not reachable after start.

Problem: nie znaleziono kart Chrome dla profilu="user"

Używasz profilu user (existing-session / Chrome MCP) i nie ma otwartych kart, do których można się dołączyć.

Sposoby rozwiązania:

1. Zamiast tego użyj zarządzanej przeglądarki: openclaw browser --browser-profile openclaw start (lub ustaw browser.defaultProfile: "openclaw").
2. Pozostaw lokalną przeglądarkę Chrome uruchomioną z co najmniej jedną otwartą kartą, a następnie ponów próbę z --browser-profile user.

Uwagi:

• Profil user działa wyłącznie na hoście. Na serwerach z systemem Linux, w kontenerach lub na hostach zdalnych preferuj profile CDP.
• Profil user i inne profile existing-session współdzielą obecne ograniczenia Chrome MCP: wyłącznie działania oparte na referencjach, jeden plik na każde przesłanie, brak możliwości nadpisania timeoutMs dla okien dialogowych, brak wait --load networkidle oraz brak responsebody, eksportu do PDF, przechwytywania pobierania i działań wsadowych.
• Lokalne profile sterownika openclaw automatycznie przypisują cdpPort/cdpUrl; ustawiaj je ręcznie tylko dla zdalnego CDP.
• Zdalne profile CDP akceptują http://, https://, ws:// i wss://. Użyj HTTP(S) do wykrywania za pomocą /json/version albo WS(S), gdy usługa przeglądarki udostępnia bezpośredni adres URL gniazda DevTools.

Powiązane

• Przeglądarka
• Logowanie w przeglądarce
• Rozwiązywanie problemów ze zdalnym CDP przeglądarki w WSL2