Tools
Browserproblemen oplossen
Probleem: "Failed to start Chrome CDP on port 18800"
De browserbesturingsserver van OmeniaClaw kan Chrome/Brave/Edge/Chromium niet starten met de fout:
{"error":"Error: Failed to start Chrome CDP on port 18800 for profile \"OmeniaClaw\"."}Hoofdoorzaak
Op Ubuntu (en veel Linux-distributies) is de standaardinstallatie van Chromium een snap-pakket. De AppArmor-afscherming van snap verstoort de manier waarop OmeniaClaw 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 alleen een wrapper.
Andere veelvoorkomende Linux-startfouten:
The profile appears to be in use by another Chromium processbetekent dat Chrome verouderdeSingleton*-lockbestanden in de beheerde profielmap heeft gevonden. OmeniaClaw 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 $DISPLAYbetekent 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 wanneerDISPLAYenWAYLAND_DISPLAYallebei niet zijn ingesteld. Als jeOmeniaClaw_BROWSER_HEADLESS=0,browser.headless: falseofbrowser.profiles.<name>.headless: falsehebt ingesteld, verwijder dan die headed-override, stelOmeniaClaw_BROWSER_HEADLESS=1in, startXvfb, voerOmeniaClaw browser start --headlessuit voor een eenmalige beheerde start, of voer OmeniaClaw uit in een echte desktopsessie.
Oplossing 1: Installeer Google Chrome (Aanbevolen)
Installeer het officiële Google Chrome .deb-pakket, dat niet door snap wordt gesandboxt:
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 # if there are dependency errorsWerk daarna je OmeniaClaw-configuratie bij (~/.OmeniaClaw/OmeniaClaw.json):
{ "browser": { "enabled": true, "executablePath": "/usr/bin/google-chrome-stable", "headless": true, "noSandbox": true }}Oplossing 2: Gebruik Snap Chromium met alleen-koppelenmodus
Als je snap Chromium moet gebruiken, configureer OmeniaClaw dan om te koppelen aan een handmatig gestarte browser:
- Werk de configuratie bij:
{ "browser": { "enabled": true, "attachOnly": true, "headless": true, "noSandbox": true }}- Start Chromium handmatig:
chromium-browser --headless --no-sandbox --disable-gpu \ --remote-debugging-port=18800 \ --user-data-dir=$HOME/.OmeniaClaw/browser/OmeniaClaw/user-data \ about:blank &- Maak eventueel een systemd-gebruikersservice om Chrome automatisch te starten:
# ~/.config/systemd/user/OmeniaClaw-browser.service[Unit]Description=OmeniaClaw Browser (Chrome CDP)After=network.target [Service]ExecStart=/snap/bin/chromium --headless --no-sandbox --disable-gpu --remote-debugging-port=18800 --user-data-dir=%h/.OmeniaClaw/browser/OmeniaClaw/user-data about:blankRestart=on-failureRestartSec=5 [Install]WantedBy=default.targetSchakel in met: systemctl --user enable --now OmeniaClaw-browser.service
Controleren of de browser werkt
Controleer de status:
curl -s http://127.0.0.1:18791/ | jq '{running, pid, chosenBrowser}'Test browsen:
curl -s -X POST http://127.0.0.1:18791/startcurl -s http://127.0.0.1:18791/tabsConfiguratiereferentie
| Optie | Beschrijving | Standaard |
|---|---|---|
browser.enabled |
Browserbesturing inschakelen | true |
browser.executablePath |
Pad naar een op Chromium gebaseerde browser-binary (Chrome/Brave/Edge/Chromium) | automatisch gedetecteerd (geeft voorkeur aan standaardbrowser wanneer die op Chromium is gebaseerd) |
browser.headless |
Uitvoeren zonder GUI | false |
OmeniaClaw_BROWSER_HEADLESS |
Override per proces voor headless-modus van lokale beheerde browser | niet ingesteld |
browser.noSandbox |
Voeg de vlag --no-sandbox toe (nodig voor sommige Linux-setups) |
false |
browser.attachOnly |
Browser niet starten, alleen koppelen aan bestaande browser | false |
browser.cdpPort |
Chrome DevTools Protocol-poort | 18800 |
browser.localLaunchTimeoutMs |
Time-out voor lokale beheerde Chrome-detectie | 15000 |
browser.localCdpReadyTimeoutMs |
Time-out voor CDP-gereedheid na lokale beheerde start | 8000 |
Verhoog op Raspberry Pi, oudere VPS-hosts of trage opslag
browser.localLaunchTimeoutMs wanneer Chrome meer tijd nodig heeft om zijn CDP HTTP-
endpoint beschikbaar te maken. Verhoog browser.localCdpReadyTimeoutMs wanneer het starten lukt maar
OmeniaClaw browser start nog steeds not reachable after start meldt. Waarden moeten
positieve gehele getallen tot 120000 ms zijn; ongeldige configuratiewaarden worden geweigerd.
Probleem: "No Chrome tabs found for profile="user""
Je gebruikt een existing-session / Chrome MCP-profiel. OmeniaClaw kan lokale Chrome zien,
maar er zijn geen open tabbladen beschikbaar om aan te koppelen.
Oplossingsopties:
- Gebruik de beheerde browser:
OmeniaClaw browser start --browser-profile OmeniaClaw(of stelbrowser.defaultProfile: "OmeniaClaw"in). - Gebruik Chrome MCP: zorg ervoor dat lokale Chrome actief is met minstens één open tabblad, en probeer het daarna opnieuw met
--browser-profile user.
Opmerkingen:
useris alleen voor de host. Geef voor Linux-servers, containers of externe hosts de voorkeur aan CDP-profielen.user/ andereexisting-session-profielen behouden de huidige Chrome MCP-beperkingen: ref-gestuurde acties, hooks voor uploaden van één bestand, geen overrides voor dialoogtime-outs, geenwait --load networkidle, en geenresponsebody, PDF-export, download- interceptie of batchacties.- Lokale
OmeniaClaw-profielen wijzencdpPort/cdpUrlautomatisch toe; stel die alleen in voor externe CDP. - Externe CDP-profielen accepteren
http://,https://,ws://enwss://. Gebruik HTTP(S) voor/json/version-detectie, of WS(S) wanneer je browser- service je een directe DevTools-socket-URL geeft.