Problemen oplossen voor de browser (Linux)¶

Probleem: "Failed to start Chrome CDP on port 18800"¶

De browserbesturingsserver van OpenClaw kan Chrome/Brave/Edge/Chromium niet starten met de fout:

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

Oorzaak¶

Op Ubuntu (en veel Linux-distributies) is de standaard Chromium-installatie een snap-pakket. De AppArmor-beperking van snap verstoort hoe OpenClaw het browserproces start en bewaakt.

De opdracht apt install chromium installeert een stubpakket dat doorverwijst naar snap:

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

Dit is GEEN echte browser — het is slechts een wrapper.

Oplossing 1: Google Chrome installeren (aanbevolen)¶

Installeer het officiële Google Chrome .deb-pakket, dat niet door snap wordt gesandboxed:

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  # if there are dependency errors

Werk daarna je OpenClaw-config bij (~/.openclaw/openclaw.json):

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

Oplossing 2: Snap Chromium gebruiken met Attach-Only-modus¶

Als je snap Chromium moet gebruiken, configureer OpenClaw dan om zich te koppelen aan een handmatig gestarte browser:

1. Config bijwerken:

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

2. Chromium handmatig starten:

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

3. Optioneel een systemd-gebruikersservice maken om Chrome automatisch te starten:

# ~/.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:blank
Restart=on-failure
RestartSec=5

[Install]
WantedBy=default.target

Inschakelen met: systemctl --user enable --now openclaw-browser.service

Controleren of de browser werkt¶

Status controleren:

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

Browsen testen:

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

Config-referentie¶

Probleem: "Chrome extension relay is running, but no tab is connected"¶

Je gebruikt het profiel chrome (extension relay). Dit verwacht dat de OpenClaw browserextensie is gekoppeld aan een actieve tab.

Oplossingsopties:

1. Gebruik de beheerde browser: openclaw browser start --browser-profile openclaw (of stel browser.defaultProfile: "openclaw" in).
2. Gebruik de extension relay: installeer de extensie, open een tab en klik op het OpenClaw-extensie-icoon om deze te koppelen.

Notities:

• Het profiel chrome gebruikt waar mogelijk je standaard Chromium-systeembrowser.
• Lokale profielen openclaw wijzen automatisch cdpPort/cdpUrl toe; stel die alleen in voor externe CDP.