Browserproblemen oplossen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Probleem: “Failed to start Chrome CDP on port 18800”

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

​

Hoofdoorzaak

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

• The profile appears to be in use by another Chromium process betekent dat Chrome verouderde Singleton*-lockbestanden in de beheerde profielmap heeft gevonden. OpenClaw verwijdert die locks en probeert het eenmaal opnieuw wanneer de lock verwijst naar een dood proces of een proces op een andere host.
• Missing X server or $DISPLAY betekent dat er expliciet om een zichtbare browser is gevraagd op een host zonder desktopsessie. Standaard vallen lokale beheerde profielen op Linux nu terug op headless-modus wanneer DISPLAY en WAYLAND_DISPLAY allebei niet zijn ingesteld. Als je OPENCLAW_BROWSER_HEADLESS=0, browser.headless: false of browser.profiles.<name>.headless: false hebt ingesteld, verwijder dan die headed-override, stel OPENCLAW_BROWSER_HEADLESS=1 in, start Xvfb, voer openclaw browser start --headless uit voor een eenmalige beheerde start, of voer OpenClaw uit in een echte desktopsessie.

​

Oplossing 1: Installeer Google Chrome (Aanbevolen)

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

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

​

Oplossing 2: Gebruik Snap Chromium met alleen-koppelenmodus

1. Werk de configuratie bij:

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

2. Start Chromium handmatig:

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

3. Maak eventueel een systemd-gebruikersservice 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

​

Controleren of de browser werkt

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

​

Configuratiereferentie

​

Probleem: “No Chrome tabs found for profile=“user""

1. Gebruik de beheerde browser: openclaw browser start --browser-profile openclaw (of stel browser.defaultProfile: "openclaw" in).
2. Gebruik Chrome MCP: zorg ervoor dat lokale Chrome actief is met minstens één open tabblad, en probeer het daarna opnieuw met --browser-profile user.

• user is alleen voor de host. Geef voor Linux-servers, containers of externe hosts de voorkeur aan CDP-profielen.
• user / andere existing-session-profielen behouden de huidige Chrome MCP-beperkingen: ref-gestuurde acties, hooks voor uploaden van één bestand, geen overrides voor dialoogtime-outs, geen wait --load networkidle, en geen responsebody, PDF-export, download- interceptie of batchacties.
• Lokale openclaw-profielen wijzen cdpPort/cdpUrl automatisch toe; stel die alleen in voor externe CDP.
• Externe CDP-profielen accepteren http://, https://, ws:// en wss://. Gebruik HTTP(S) voor /json/version-detectie, of WS(S) wanneer je browser- service je een directe DevTools-socket-URL geeft.

​

Gerelateerd

• Browser
• Browseraanmelding
• Browser WSL2-probleemoplossing