openclaw browser

Beheer het browserbesturingsoppervlak van OpenClaw en voer browseracties uit (levenscyclus, profielen, tabbladen, snapshots, screenshots, navigatie, invoer, status-emulatie en foutopsporing).

Gerelateerd:

• Browsertool + API: Browsertool

Algemene vlaggen

• --url <gatewayWsUrl>: Gateway WebSocket-URL (standaard uit configuratie).
• --token <token>: Gateway-token (indien vereist).
• --timeout <ms>: time-out voor verzoek (ms).
• --expect-final: wacht op een definitieve Gateway-respons.
• --browser-profile <name>: kies een browserprofiel (standaard uit configuratie).
• --json: machineleesbare uitvoer (waar ondersteund).

Snel starten (lokaal)

openclaw browser profilesopenclaw browser --browser-profile openclaw startopenclaw browser --browser-profile openclaw open https://example.comopenclaw browser --browser-profile openclaw snapshot

Agents kunnen dezelfde gereedheidscontrole uitvoeren met browser({ action: "doctor" }).

Snelle probleemoplossing

Als start mislukt met not reachable after start, los dan eerst de CDP-gereedheid op. Als start en tabs slagen maar open of navigate mislukt, is het browserbesturingsvlak gezond en is de fout meestal het SSRF-beleid voor navigatie.

Minimale reeks:

openclaw browser --browser-profile openclaw doctoropenclaw browser --browser-profile openclaw startopenclaw browser --browser-profile openclaw tabsopenclaw browser --browser-profile openclaw open https://example.com

Gedetailleerde richtlijnen: Browserprobleemoplossing

Levenscyclus

openclaw browser statusopenclaw browser doctoropenclaw browser doctor --deepopenclaw browser startopenclaw browser start --headlessopenclaw browser stopopenclaw browser --browser-profile openclaw reset-profile

Opmerkingen:

• doctor --deep voegt een live snapshot-probe toe. Dit is nuttig wanneer de basis-CDP-gereedheid groen is, maar je bewijs wilt dat het huidige tabblad kan worden geïnspecteerd.
• Voor attachOnly en externe CDP-profielen sluit openclaw browser stop de actieve besturingssessie en wist tijdelijke emulatie-overschrijvingen, zelfs wanneer OpenClaw het browserproces niet zelf heeft gestart.
• Voor lokaal beheerde profielen stopt openclaw browser stop het gestarte browserproces.
• openclaw browser start --headless geldt alleen voor dat startverzoek en alleen wanneer OpenClaw een lokaal beheerde browser start. Het herschrijft browser.headless of de profielconfiguratie niet, en doet niets voor een browser die al actief is.
• Op Linux-hosts zonder DISPLAY of WAYLAND_DISPLAY draaien lokaal beheerde profielen automatisch headless, tenzij OPENCLAW_BROWSER_HEADLESS=0, browser.headless=false of browser.profiles.<name>.headless=false expliciet om een zichtbare browser vraagt.

Als de opdracht ontbreekt

Als openclaw browser een onbekende opdracht is, controleer dan plugins.allow in ~/.openclaw/openclaw.json.

Wanneer plugins.allow aanwezig is, vermeld dan de meegeleverde browser-Plugin expliciet, tenzij de configuratie al een hoofdblok browser heeft:

{  plugins: {    allow: ["telegram", "browser"],  },}

Een expliciet hoofdblok browser, bijvoorbeeld browser.enabled=true of browser.profiles.<name>, activeert ook de meegeleverde browser-Plugin onder een beperkende allowlist voor plugins.

Gerelateerd: Browsertool

Profielen

Profielen zijn benoemde browserrouteringsconfiguraties. In de praktijk:

• openclaw: start of koppelt aan een dedicated door OpenClaw beheerde Chrome-instantie (geïsoleerde gebruikersgegevensmap).
• user: bestuurt je bestaande aangemelde Chrome-sessie via Chrome DevTools MCP.
• aangepaste CDP-profielen: wijzen naar een lokaal of extern CDP-eindpunt.

openclaw browser profilesopenclaw browser create-profile --name work --color "#FF5A36"openclaw browser create-profile --name chrome-live --driver existing-sessionopenclaw browser create-profile --name remote --cdp-url https://browser-host.example.comopenclaw browser delete-profile --name work

Gebruik een specifiek profiel:

openclaw browser --browser-profile work tabs

Tabbladen

openclaw browser tabsopenclaw browser tab new --label docsopenclaw browser tab label t1 docsopenclaw browser tab select 2openclaw browser tab close 2openclaw browser open https://docs.openclaw.ai --label docsopenclaw browser focus docsopenclaw browser close t1

tabs retourneert eerst suggestedTargetId, daarna de stabiele tabId zoals t1, het optionele label en de ruwe targetId. Agents moeten suggestedTargetId teruggeven aan focus, close, snapshots en acties. Je kunt een label toewijzen met open --label, tab new --label of tab label; labels, tabblad-id's, ruwe target-id's en unieke target-id-voorvoegsels worden allemaal geaccepteerd. Wanneer Chromium het onderliggende ruwe target tijdens navigatie of het verzenden van een formulier vervangt, houdt OpenClaw de stabiele tabId/het label gekoppeld aan het vervangende tabblad wanneer het de overeenkomst kan bewijzen. Ruwe target-id's blijven vluchtig; gebruik bij voorkeur suggestedTargetId.

Snapshot / screenshot / acties

Snapshot:

openclaw browser snapshotopenclaw browser snapshot --urls

Screenshot:

openclaw browser screenshotopenclaw browser screenshot --full-pageopenclaw browser screenshot --ref e12openclaw browser screenshot --labels

Opmerkingen:

• --full-page is alleen voor pagina-opnamen; het kan niet worden gecombineerd met --ref of --element.
• existing-session- / user-profielen ondersteunen paginascreenshots en --ref-screenshots uit snapshot-uitvoer, maar geen CSS---element-screenshots.
• --labels legt huidige snapshotrefs over de screenshot heen.
• snapshot --urls voegt gevonden linkbestemmingen toe aan AI-snapshots, zodat agents directe navigatiedoelen kunnen kiezen in plaats van alleen op basis van linktekst te gokken.

Navigeren/klikken/typen (op refs gebaseerde UI-automatisering):

openclaw browser navigate https://example.comopenclaw browser click <ref>openclaw browser click-coords 120 340openclaw browser type <ref> "hello"openclaw browser press Enteropenclaw browser hover <ref>openclaw browser scrollintoview <ref>openclaw browser drag <startRef> <endRef>openclaw browser select <ref> OptionA OptionBopenclaw browser fill --fields '[{"ref":"1","value":"Ada"}]'openclaw browser wait --text "Done"openclaw browser evaluate --fn '(el) => el.textContent' --ref <ref>

Actieresponsen retourneren de huidige ruwe targetId na door een actie getriggerde paginavervanging wanneer OpenClaw het vervangende tabblad kan bewijzen. Scripts moeten nog steeds suggestedTargetId/labels opslaan en doorgeven voor langlopende workflows.

Bestands- en dialooghulpen:

openclaw browser upload /tmp/openclaw/uploads/file.pdf --ref <ref>openclaw browser waitfordownloadopenclaw browser download <ref> report.pdfopenclaw browser dialog --accept

Beheerde Chrome-profielen slaan gewone door klikken getriggerde downloads op in de OpenClaw-downloadmap (/tmp/openclaw/downloads standaard, of de geconfigureerde tijdelijke root). Gebruik waitfordownload of download wanneer de agent op een specifiek bestand moet wachten en het pad moet teruggeven; die expliciete wachters bezitten de volgende download.

Status en opslag

Viewport + emulatie:

openclaw browser resize 1280 720openclaw browser set viewport 1280 720openclaw browser set offline onopenclaw browser set media darkopenclaw browser set timezone Europe/Londonopenclaw browser set locale en-GBopenclaw browser set geo 51.5074 -0.1278 --accuracy 25openclaw browser set device "iPhone 14"openclaw browser set headers '{"x-test":"1"}'openclaw browser set credentials myuser mypass

Cookies + opslag:

openclaw browser cookiesopenclaw browser cookies set session abc123 --url https://example.comopenclaw browser cookies clearopenclaw browser storage local getopenclaw browser storage local set token abc123openclaw browser storage session clear

Foutopsporing

openclaw browser console --level erroropenclaw browser pdfopenclaw browser responsebody "**/api"openclaw browser highlight <ref>openclaw browser errors --clearopenclaw browser requests --filter apiopenclaw browser trace startopenclaw browser trace stop --out trace.zip

Bestaande Chrome via MCP

Gebruik het ingebouwde user-profiel, of maak je eigen existing-session-profiel:

openclaw browser --browser-profile user tabsopenclaw browser create-profile --name chrome-live --driver existing-sessionopenclaw browser create-profile --name brave-live --driver existing-session --user-data-dir "~/Library/Application Support/BraveSoftware/Brave-Browser"openclaw browser --browser-profile chrome-live tabs

Dit pad is alleen voor de host. Gebruik in plaats daarvan een CDP-profiel voor Docker, headless servers, Browserless of andere externe opstellingen.

Huidige beperkingen van existing-session:

• door snapshots gestuurde acties gebruiken refs, geen CSS-selectors
• browser.actionTimeoutMs zet ondersteunde act-verzoeken standaard op 60000 ms wanneer aanroepers timeoutMs weglaten; timeoutMs per aanroep heeft nog steeds voorrang.
• click is alleen linksklikken
• type ondersteunt slowly=true niet
• press ondersteunt delayMs niet
• hover, scrollintoview, drag, select, fill en evaluate weigeren time-outoverschrijvingen per aanroep
• select ondersteunt slechts één waarde
• wait --load networkidle wordt niet ondersteund
• bestandsuploads vereisen --ref / --input-ref, ondersteunen geen CSS---element en ondersteunen momenteel één bestand tegelijk
• dialooghaken ondersteunen --timeout niet
• screenshots ondersteunen pagina-opnamen en --ref, maar geen CSS---element
• responsebody, downloadonderschepping, PDF-export en batchacties vereisen nog steeds een beheerde browser of een ruw CDP-profiel

Externe browserbesturing (node-hostproxy)

Als de Gateway op een andere machine draait dan de browser, voer dan een node-host uit op de machine met Chrome/Brave/Edge/Chromium. De Gateway proxyt browseracties naar die node (geen afzonderlijke browserbesturingsserver vereist).

Gebruik gateway.nodes.browser.mode om automatische routering te beheren en gateway.nodes.browser.node om een specifieke node vast te zetten als er meerdere zijn verbonden.

Beveiliging + externe installatie: Browsertool, Externe toegang, Tailscale, Beveiliging

Gerelateerd

• CLI-referentie
• Browser