Browser-Fehlerbehebung (Linux)

Problem: „Failed to start Chrome CDP on port 18800“

Der Browser-Steuerungs-Server von OpenClaw startet Chrome/Brave/Edge/Chromium nicht und meldet:


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

Ursache

Unter Ubuntu (und vielen Linux-Distributionen) ist die Standard-Chromium-Installation ein Snap-Paket. Die AppArmor-Einschränkung von Snap stört, wie OpenClaw den Browser-Prozess startet und überwacht. Der Befehl apt install chromium installiert ein Stub-Paket, das auf Snap umleitet:


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

Das ist KEIN echter Browser — nur ein Wrapper.

Lösung 1: Google Chrome installieren (empfohlen)

Das offizielle Google-Chrome-.deb-Paket installieren, das nicht von Snap sandboxed wird:


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  # bei Abhängigkeitsfehlern

Dann die OpenClaw-Config anpassen (~/.clawdbot/openclaw.json):


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

Lösung 2: Snap-Chromium im Attach-Only-Modus nutzen

Wenn du Snap-Chromium nutzen musst, OpenClaw so konfigurieren, dass es sich an einen manuell gestarteten Browser anhängt:

Config anpassen:


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

Chromium manuell starten:


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

Optional: systemd-User-Service zum automatischen Start von Chrome anlegen:


# ~/.config/systemd/user/clawd-browser.service
[Unit]
Description=Clawd Browser (Chrome CDP)
After=network.target

[Service]
ExecStart=/snap/bin/chromium --headless --no-sandbox --disable-gpu --remote-debugging-port=18800 --user-data-dir=%h/.clawdbot/browser/clawd/user-data about:blank
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

Aktivieren mit: systemctl --user enable --now clawd-browser.service

Prüfen, ob der Browser funktioniert

Status prüfen:


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

Surfen testen:


curl -s -X POST http://127.0.0.1:18791/start
curl -s http://127.0.0.1:18791/tabs

Config-Referenz

Option	Beschreibung	Standard
`browser.enabled`	Browser-Steuerung aktivieren	`true`
`browser.executablePath`	Pfad zur Chromium-Browser-Binary (Chrome/Brave/Edge/Chromium)	automatisch (bevorzugt Standard-Browser bei Chromium-basiert)
`browser.headless`	Ohne GUI laufen	`false`
`browser.noSandbox`	Flag `--no-sandbox` setzen (bei einigen Linux-Setups nötig)	`false`
`browser.attachOnly`	Browser nicht starten, nur an bestehenden anhängen	`false`
`browser.cdpPort`	Chrome DevTools Protocol Port	`18800`

Problem: „Chrome extension relay is running, but no tab is connected“

Du nutzt das Profil chrome (Extension-Relay). Es erwartet, dass die OpenClaw-Browser-Extension an einen lebenden Tab angehängt ist. Optionen:

Verwalteten Browser nutzen: openclaw browser start --browser-profile clawd (oder browser.defaultProfile: "clawd" setzen).
Extension-Relay nutzen: Extension installieren, Tab öffnen und auf das OpenClaw-Extension-Icon klicken zum Anhängen.

Hinweise:

Das Profil chrome nutzt wenn möglich deinen System-Standard-Chromium-Browser.
Lokale clawd-Profile vergeben cdpPort/cdpUrl automatisch; nur bei Remote-CDP setzen.