Browser (beheerd door OpenClaw)

OpenClaw kan een speciaal Chrome/Brave/Edge/Chromium-profiel uitvoeren dat door de agent wordt bestuurd. Het werkt via een kleine lokale besturingsservice binnen de Gateway (alleen loopback) en is geïsoleerd van je persoonlijke browser.

• Zie het als een afzonderlijke browser die alleen voor de agent bestemd is. Het openclaw-profiel komt nooit in aanraking met je persoonlijke browserprofiel.
• De agent opent tabbladen, leest pagina's, klikt en typt binnen deze geïsoleerde omgeving.
• Het ingebouwde user-profiel maakt in plaats daarvan via Chrome DevTools MCP verbinding met je echte aangemelde Chrome-sessie.

Wat je krijgt

• Een afzonderlijk browserprofiel met de naam openclaw (standaard met een oranje accent).
• Deterministisch tabbladbeheer (weergeven/openen/focussen/sluiten).
• Agentacties (klikken/typen/slepen/selecteren), momentopnamen, schermafbeeldingen, pdf's.
• Door Playwright ondersteunde profielen slaan navigaties rechtstreeks naar bijlagen op in de beheerde downloadmap en retourneren na validatie van het beleid voor de uiteindelijke URL { url, suggestedFilename, path }-metagegevens.
• Door Playwright ondersteunde agentacties retourneren een downloads-array met dezelfde beheerde metagegevens wanneer de actie onmiddellijk een of meer downloads start.
• Een meegeleverde browser-automation-skill die agents de herstellus voor momentopnamen, stabiele tabbladen, verouderde verwijzingen en handmatige blokkades leert wanneer de browser- plugin is ingeschakeld.
• Optionele ondersteuning voor meerdere profielen (openclaw, work, remote, ...).

Deze browser is niet je dagelijkse browser. Het is een veilig, geïsoleerd oppervlak voor agentautomatisering en verificatie.

Op macOS kun je cookies expliciet vanuit een systeemprofiel van een browser uit de Chrome-familie naar een afzonderlijk beheerd profiel kopiëren. De beheerde browser gebruikt nog steeds een eigen map voor gebruikersgegevens; alleen de geselecteerde cookies worden gekopieerd en lokale opslag en IndexedDB blijven achter. Zie Profielen of de CLI-referentie voor openclaw browser voor importopdrachten en beperkingen.

Snel aan de slag

openclaw browser --browser-profile openclaw doctoropenclaw browser --browser-profile openclaw doctor --deepopenclaw browser --browser-profile openclaw statusopenclaw browser --browser-profile openclaw startopenclaw browser --browser-profile openclaw open https://example.comopenclaw browser --browser-profile openclaw snapshot

"Browser disabled" betekent dat de plugin of browser.enabled is uitgeschakeld; zie Configuratie en Pluginbeheer.

Als openclaw browser volledig ontbreekt of de agent zegt dat de browsertool niet beschikbaar is, ga dan naar Ontbrekende browseropdracht of -tool.

Pluginbeheer

De standaardtool browser is een meegeleverde plugin. Schakel deze uit om hem te vervangen door een andere plugin die dezelfde toolnaam browser registreert:

{  plugins: {    entries: {      browser: {        enabled: false,      },    },  },}

Voor de standaardinstellingen zijn zowel plugins.entries.browser.enabled als browser.enabled=true vereist. Als je alleen de plugin uitschakelt, worden de openclaw browser-CLI, de Gateway-methode browser.request, de agenttool en de besturingsservice als één geheel verwijderd; je browser.*-configuratie blijft intact voor een vervanging.

Na wijzigingen in de browserconfiguratie moet de Gateway opnieuw worden gestart, zodat de plugin zijn service opnieuw kan registreren.

Richtlijnen voor agents

Opmerking over toolprofielen: tools.profile: "coding" bevat web_search en web_fetch, maar niet de volledige tool browser. Voeg browser in de profielfase toe om de agent of een gestarte subagent browserautomatisering te laten gebruiken:

{  tools: {    profile: "coding",    alsoAllow: ["browser"],  },}

Gebruik voor één agent agents.entries.*.tools.alsoAllow: ["browser"]. Alleen tools.subagents.tools.allow: ["browser"] is niet voldoende, omdat het beleid voor subagents na de profielfiltering wordt toegepast.

De browserplugin wordt geleverd met twee niveaus van richtlijnen voor agents:

• De beschrijving van de tool browser bevat het compacte contract dat altijd geldt: kies het juiste profiel, houd verwijzingen op hetzelfde tabblad, gebruik tabId/labels om tabbladen te kiezen en laad de browserskill voor werk met meerdere stappen.
• De meegeleverde skill browser-automation bevat de uitgebreidere werklus: controleer eerst de status/tabbladen, geef taak-tabbladen een label, maak een momentopname vóór een actie, maak opnieuw een momentopname na wijzigingen in de gebruikersinterface, herstel verouderde verwijzingen eenmaal en meld blokkades door aanmelden/2FA/captcha of camera/microfoon als handmatige actie in plaats van te gokken.

Met plugins meegeleverde skills worden in de beschikbare skills van de agent vermeld wanneer de plugin is ingeschakeld. De volledige skill-instructies worden op aanvraag geladen, zodat routinematige beurten niet de volledige tokenkosten met zich meebrengen.

Ontbrekende browseropdracht of -tool

Als openclaw browser na een upgrade onbekend is, browser.request ontbreekt of de agent meldt dat de browsertool niet beschikbaar is, is de gebruikelijke oorzaak een plugins.allow-lijst waarin browser ontbreekt en er geen browser-configuratieblok op rootniveau bestaat. Voeg dit toe:

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

Een expliciet browser-blok op rootniveau (een willekeurige sleutel onder browser, zoals browser.enabled=true of browser.profiles.<name>) activeert de meegeleverde browserplugin zelfs bij een beperkende plugins.allow, overeenkomstig het gedrag van de configuratie van meegeleverde kanalen. plugins.entries.browser.enabled=true en tools.alsoAllow: ["browser"] vervangen op zichzelf het lidmaatschap van de toelatingslijst niet. Door plugins.allow volledig te verwijderen, wordt ook de standaardinstelling hersteld.

Profielen: openclaw, user, chrome

• openclaw: beheerde, geïsoleerde browser (geen extensie vereist).
• user: ingebouwd Chrome DevTools MCP-verbindingsprofiel voor je echte aangemelde Chrome-sessie. Chrome toont de eerste keer dat OpenClaw verbinding maakt een blokkerende prompt "Allow remote debugging?", dus er moet iemand bij de computer aanwezig zijn.
• chrome: ingebouwd Chrome-extensie-profiel voor je echte aangemelde Chrome-sessie. Werkt vanaf een telefoon zonder dat er iemand achter het bureau zit, omdat het tabbladen aanstuurt via de OpenClaw-browserextensie in plaats van de poort voor foutopsporing op afstand. Er verschijnt dus geen prompt "Allow remote debugging?".

Voor aanroepen van de browsertool door agents:

• Standaard: gebruik de geïsoleerde openclaw-browser.
• Geef de voorkeur aan profile="chrome" (extensie) wanneer bestaande aangemelde sessies belangrijk zijn en de gebruiker niet bij de computer is (Telegram, WhatsApp enzovoort).
• Geef de voorkeur aan profile="user" (Chrome MCP) wanneer bestaande aangemelde sessies belangrijk zijn en de gebruiker bij de computer is om de verbindingsprompt goed te keuren.
• profile is de expliciete overschrijving wanneer je een specifieke browsermodus wilt.

Stel browser.defaultProfile: "openclaw" in als je standaard de beheerde modus wilt gebruiken.

Configuratie

Browserinstellingen staan in ~/.openclaw/openclaw.json.

{  browser: {    enabled: true, // standaard: true    evaluateEnabled: true, // standaard: true; false schakelt act:evaluate uit (willekeurige JS)    ssrfPolicy: {      // dangerouslyAllowPrivateNetwork: true, // alleen aanmelden voor vertrouwde toegang tot privénetwerken      // hostnameAllowlist: ["*.example.com", "example.com"],      // allowedHostnames: ["localhost"],    },    // cdpUrl: "http://127.0.0.1:18792", // verouderde overschrijving voor één profiel    tabCleanup: {      enabled: true, // standaard: true    },    // snapshotDefaults: { mode: "efficient" }, // standaardmodus voor momentopnamen wanneer de aanroeper er geen opgeeft    defaultProfile: "openclaw",    color: "#FF4500",    headless: false,    noSandbox: false,    attachOnly: false,    executablePath: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",    profiles: {      openclaw: { cdpPort: 18800, color: "#FF4500" },      work: {        cdpPort: 18801,        color: "#0066CC",        headless: true,        executablePath: "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",      },      user: {        driver: "existing-session",        attachOnly: true,        color: "#00AA00",      },      brave: {        driver: "existing-session",        attachOnly: true,        userDataDir: "~/Library/Application Support/BraveSoftware/Brave-Browser",        color: "#FB542B",      },      remote: { cdpUrl: "http://10.0.0.42:9222", color: "#00AA00" },    },  },}

browser.snapshotDefaults.mode: "efficient" wijzigt de standaardextractiemodus snapshot wanneer een aanroeper geen expliciete snapshotFormat of mode doorgeeft; zie API voor browserbesturing voor opties voor momentopnamen per aanroep.

Eigenaarschap van tabbladopschoning

Het opschonen van sessietabbladen is alleen van toepassing op tabbladen die door de OpenClaw-browsertool met action: "open" zijn gemaakt. OpenClaw neemt geen tabbladen over die al geopend waren, door de gebruiker zijn geopend of waarvan het eigenaarschap anderszins onbekend is. Het browser.tabCleanup-blok beheert periodieke opschoonrondes voor inactiviteit en limieten voor primaire sessies; uitschakeling hiervan schakelt expliciete opschoning tijdens de levenscyclus van sessies niet uit.

Voor lokale openacties op de host wordt het eigenaarschap met een stabiel native CDP-doel en een stabiele browser- identiteit opgeslagen in de gedeelde SQLite-status. Deze records blijven behouden na een herstart van de Gateway en blijven in aanmerking komen voor /new en andere opschoning tijdens de levenscyclus van sessies; opschoning tijdens de levenscyclus van sessies omvat het beëindigen van subagent-, cron- en ACP-sessies. Records waarvan het toolgerichte doel het native CDP-doel is, blijven na een herstart ook in aanmerking komen voor opschoonrondes voor inactiviteit en limieten per sessie. Chrome MCP-doelhandles zijn proceslokaal, dus koude records van bestaande sessies wachten op levenscyclusopschoning in plaats van het risico te lopen dat een opschoonronde voor inactiviteit wordt uitgevoerd op activiteit die na een herstart niet veilig kan worden toegeschreven. Dit duurzame pad kan door OpenClaw beheerde profielen, reguliere externe CDP-profielen en bestaande-sessieprofielen met een expliciete cdpUrl omvatten, mits OpenClaw zowel het native doel als een stabiele browseridentiteit kan bepalen. Voordat een duurzaam record wordt gesloten, controleert OpenClaw of het geconfigureerde profiel en de browserinstantie nog steeds overeenkomen.

Chrome MCP --autoConnect, CDP-eindpunten waarvan het /json/version-antwoord geen stabiele browseridentiteit bevat en openacties waarvan het native doel niet kan worden bepaald, blijven proceslokale tracking op basis van beste inspanning. Ze kunnen worden opgeschoond terwijl dat Gateway-proces actief is, maar worden na een herstart van de Gateway niet automatisch gesloten. Tabbladen die openstonden voordat duurzame tracking beschikbaar was, worden niet met terugwerkende kracht overgenomen; sluit die tabbladen handmatig.

Opschoning vindt plaats op basis van beste inspanning en garandeert niet dat elk in aanmerking komend tabblad onmiddellijk wordt gesloten. Bij een tijdelijke fout tijdens de eigendomscontrole of het sluiten blijft duurzame opschoning in behandeling voor een latere nieuwe poging. Nieuwe pogingen zijn niet onbeperkt: wanneer de browser onbereikbaar blijft en het tabblad langer dan een dag niet is gebruikt, wordt de trackingrij verwijderd, zodat de duurzame opslag niet kan vollopen met tabbladen die nooit meer kunnen worden geverifieerd.

Visuele verwerking van schermafbeeldingen (ondersteuning voor modellen met alleen tekst)

Wanneer het hoofdmodel alleen tekst ondersteunt (geen ondersteuning voor beeld/multimodaliteit), retourneren browser- schermafbeeldingen afbeeldingsblokken die het model niet kan lezen. Browserschermafbeeldingen gebruiken de bestaande configuratie voor beeldinterpretatie opnieuw, zodat een afbeeldingsmodel dat voor mediabegrip is geconfigureerd schermafbeeldingen als tekst kan beschrijven zonder browserspecifieke modelinstellingen.

{  tools: {    media: {      image: {        models: [          { provider: "bytedance", model: "doubao-seed-2.0-pro" },          // Voeg terugvalkandidaten toe; het eerste succes wint          { provider: "openai", model: "gpt-4o" },        ],      },      // Gedeelde mediamodellen werken ook wanneer ze voor beeldondersteuning zijn gelabeld.      // models: [{ provider: "openai", model: "gpt-4o", capabilities: ["image"] }],    },  },  agents: {    defaults: {      // Bestaande standaardwaarden voor afbeeldingsmodellen worden ook gerespecteerd.      // imageModel: { primary: "openai/gpt-4o" },    },  },}

Hoe het werkt:

1. De agent roept browser screenshot aan en er wordt zoals gebruikelijk een afbeelding op schijf vastgelegd.
2. De browsertool vraagt de bestaande runtime voor afbeeldingsbegrip of deze de schermafbeelding kan beschrijven met geconfigureerde media-afbeeldingsmodellen, gedeelde mediamodellen, standaardwaarden voor afbeeldingsmodellen of een door authenticatie ondersteunde afbeeldingsprovider.
3. Het vision-model retourneert een tekstuele beschrijving, die wordt omhuld met wrapExternalContent (beveiliging tegen promptinjectie) en aan de agent wordt geretourneerd als een tekstblok in plaats van een afbeeldingsblok.
4. Als afbeeldingsbegrip niet beschikbaar is, wordt overgeslagen of mislukt, valt de browser terug op het retourneren van het oorspronkelijke afbeeldingsblok.

Afbeeldingsblokken van schermafbeeldingen zijn privéresultaten van tools: de agent kan ze inspecteren, maar OpenClaw voegt ze niet automatisch toe aan antwoorden in kanalen. Om een schermafbeelding te delen, vraag je de agent deze expliciet met de berichtentool te verzenden.

Gebruik de bestaande velden tools.media.image / tools.media.models voor model- fallbacks, time-outs, bytelimieten, profielen en instellingen voor providerverzoeken.

Als het actieve hoofdmodel vision al ondersteunt en er geen expliciet model voor afbeeldingsbegrip is geconfigureerd, behoudt OpenClaw het normale afbeeldingsresultaat zodat het hoofdmodel de schermafbeelding rechtstreeks kan lezen.

Brave of een andere Chromium-gebaseerde browser gebruiken

Als je standaardbrowser van het systeem op Chromium is gebaseerd (Chrome/Brave/Edge/enz.), gebruikt OpenClaw deze automatisch. Stel browser.executablePath in om automatische detectie te overschrijven. Waarden voor executablePath op het hoogste niveau en per profiel accepteren ~ voor de thuismap van je besturingssysteem:

openclaw config set browser.executablePath "/usr/bin/google-chrome"openclaw config set browser.profiles.work.executablePath "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome"

Of stel dit per platform in de configuratie in:

{browser: {executablePath: "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",},}

{browser: {executablePath: "C:\\Program Files\\BraveSoftware\\Brave-Browser\\Application\\brave.exe",},}

{browser: {executablePath: "/usr/bin/brave-browser",},}

executablePath per profiel is alleen van invloed op lokaal beheerde profielen die OpenClaw start. existing-session-profielen koppelen in plaats daarvan aan een reeds actieve browser en externe CDP-profielen gebruiken de browser achter cdpUrl.

Lokale versus externe besturing

• Lokale besturing (standaard): de Gateway start de loopbackbesturingsservice en kan een lokale browser starten.
• Externe besturing (Node-host): voer een Node-host uit op de machine waarop de browser staat; de Gateway proxyt browseracties ernaartoe.
• Externe CDP: stel browser.profiles.<name>.cdpUrl (of browser.cdpUrl) in om aan een externe Chromium-gebaseerde browser te koppelen. In dit geval start OpenClaw geen lokale browser.
• Stel voor extern beheerde CDP-services op loopback (bijvoorbeeld Browserless in Docker, gepubliceerd op 127.0.0.1) ook attachOnly: true in. Loopback-CDP zonder attachOnly wordt behandeld als een lokaal, door OpenClaw beheerd browserprofiel.
• headless is alleen van invloed op lokaal beheerde profielen die OpenClaw start. Het herstart of wijzigt geen browsers voor bestaande sessies of externe CDP.
• executablePath volgt dezelfde regel voor lokaal beheerde profielen. Als je dit wijzigt voor een actief lokaal beheerd profiel, wordt dat profiel gemarkeerd voor herstart/reconciliatie, zodat bij de volgende start het nieuwe binaire bestand wordt gebruikt.

Het stopgedrag verschilt per profielmodus:

• lokaal beheerde profielen: openclaw browser stop stopt het browserproces dat OpenClaw heeft gestart
• profielen voor alleen-koppelen en externe CDP: openclaw browser stop sluit de actieve besturingssessie en heft Playwright-/CDP-emulatieoverschrijvingen op (viewport, kleurenschema, locale, tijdzone, offlinemodus en vergelijkbare status), ook al heeft OpenClaw geen browserproces gestart

Externe CDP-URL's kunnen authenticatie bevatten:

• Querytokens (bijv. https://provider.example?token=<token>)
• HTTP Basic-authenticatie (bijv. https://user:pass@provider.example)

OpenClaw behoudt de authenticatie bij het aanroepen van /json/*-eindpunten en bij het verbinden met de CDP-WebSocket. Geef voor tokens de voorkeur aan omgevingsvariabelen of geheimenbeheerders in plaats van ze vast te leggen in configuratiebestanden.

Node-browserproxy (standaard zonder configuratie)

Als je een nodehost uitvoert op de machine waarop je browser staat, kan OpenClaw aanroepen van browsertools automatisch naar die node routeren zonder aanvullende browserconfiguratie. Dit is het standaardpad voor externe Gateways.

Opmerkingen:

• De nodehost stelt zijn lokale browserbesturingsserver beschikbaar via een proxyopdracht.
• Profielen zijn afkomstig uit de eigen browser.profiles-configuratie van de node (hetzelfde als lokaal).
• De proxyopdracht staat nooit permanente profielwijzigingen toe (create-profile, delete-profile, reset-profile), ongeacht allowProfiles; breng die wijzigingen rechtstreeks op de node aan.
• nodeHost.browserProxy.allowProfiles is optioneel. Laat dit leeg voor het verouderde/standaardgedrag: alle geconfigureerde profielen blijven bereikbaar via de proxy.
• Als je nodeHost.browserProxy.allowProfiles instelt, behandelt OpenClaw dit als een grens volgens het principe van minimale bevoegdheden die beperkt op welke profielnamen de proxy zich richt.
• Schakel dit uit als je het niet wilt:
  • Op de node: nodeHost.browserProxy.enabled=false
  • Op de Gateway: gateway.nodes.browser.mode="off" (accepteert ook "auto" om één verbonden browsernode te kiezen, of "manual" om een expliciete nodeparameter te vereisen)

Browserless (gehoste externe CDP)

Browserless is een gehoste Chromium-service die CDP-verbindings-URL's via HTTPS en WebSocket beschikbaar stelt. OpenClaw kan beide vormen gebruiken, maar voor een extern browserprofiel is de rechtstreekse WebSocket-URL uit de verbindingsdocumentatie van Browserless de eenvoudigste optie.

Voorbeeld:

{  browser: {    enabled: true,    defaultProfile: "browserless",    profiles: {      browserless: {        cdpUrl: "wss://production-sfo.browserless.io?token=<BROWSERLESS_API_KEY>",        color: "#00AA00",      },    },  },}

Opmerkingen:

• Vervang <BROWSERLESS_API_KEY> door je echte Browserless-token.
• Kies het regionale eindpunt dat overeenkomt met je Browserless-account (zie hun documentatie).
• Als Browserless je een HTTPS-basis-URL geeft, kun je deze omzetten naar wss:// voor een rechtstreekse CDP-verbinding of de HTTPS-URL behouden en OpenClaw /json/version laten detecteren.

Browserless Docker op dezelfde host

Wanneer Browserless zelf wordt gehost in Docker en OpenClaw op de host wordt uitgevoerd, behandel je Browserless als een extern beheerde CDP-service:

{  browser: {    enabled: true,    defaultProfile: "browserless",    profiles: {      browserless: {        cdpUrl: "ws://127.0.0.1:3000",        attachOnly: true,        color: "#00AA00",      },    },  },}

Het adres in browser.profiles.browserless.cdpUrl moet bereikbaar zijn vanuit het OpenClaw-proces. Browserless moet ook een overeenkomend bereikbaar eindpunt publiceren; stel EXTERNAL van Browserless in op dezelfde van buitenaf voor OpenClaw bereikbare WebSocket-basis, zoals ws://127.0.0.1:3000, ws://browserless:3000 of een stabiel privé-adres op het Docker- netwerk. Als /json/version webSocketDebuggerUrl retourneert dat verwijst naar een adres dat OpenClaw niet kan bereiken, kan CDP HTTP in orde lijken terwijl het koppelen via WebSocket nog steeds mislukt.

Laat attachOnly niet uitgeschakeld voor een Browserless-profiel op het loopback-adres. Zonder attachOnly behandelt OpenClaw de loopback-poort als een lokaal beheerd browserprofiel en kan het melden dat de poort in gebruik is maar niet het eigendom van OpenClaw is.

Rechtstreekse WebSocket-CDP-providers

Sommige gehoste browserdiensten bieden een rechtstreeks WebSocket-eindpunt in plaats van de standaard HTTP-gebaseerde CDP-detectie (/json/version). OpenClaw accepteert drie vormen van CDP-URL's en kiest automatisch de juiste verbindingsstrategie:

• HTTP(S)-detectie - http://host[:port] of https://host[:port]. OpenClaw roept /json/version aan om de WebSocket-debugger-URL te detecteren en maakt vervolgens verbinding. Geen terugval naar WebSocket.
• Rechtstreekse WebSocket-eindpunten - ws://host[:port]/devtools/<kind>/<id> of wss://... met een /devtools/browser|page|worker|shared_worker|service_worker/<id>- pad. OpenClaw maakt rechtstreeks verbinding via een WebSocket-handshake en slaat /json/version volledig over.
• Kale WebSocket-hoofdeindpunten - ws://host[:port] of wss://host[:port] zonder /devtools/...-pad (bijvoorbeeld Browserless, Browserbase). OpenClaw probeert eerst HTTP- detectie via /json/version (waarbij het schema wordt genormaliseerd naar http/https); als de detectie een webSocketDebuggerUrl retourneert, wordt deze gebruikt, anders valt OpenClaw terug op een rechtstreekse WebSocket-handshake bij het kale hoofdeindpunt. Als het gepubliceerde WebSocket-eindpunt de CDP-handshake weigert maar het geconfigureerde kale hoofdeindpunt deze accepteert, valt OpenClaw ook terug op dat hoofdeindpunt. Hierdoor kan een kale ws:// die naar een lokale Chrome verwijst toch verbinding maken, omdat Chrome WebSocket- upgrades alleen accepteert op het specifieke pad per doel uit /json/version, terwijl gehoste providers hun WebSocket-hoofdeindpunt nog steeds kunnen gebruiken wanneer hun detectie- eindpunt een kortlevende URL publiceert die niet geschikt is voor Playwright CDP.

openclaw browser doctor gebruikt dezelfde logica met eerst detectie en daarna terugval naar WebSocket als het koppelen tijdens runtime, zodat een URL met een kaal hoofdeindpunt die met succes verbinding maakt niet door diagnostiek als onbereikbaar wordt gemeld.

Browserbase

Browserbase is een cloudplatform voor het uitvoeren van headless browsers met ingebouwde CAPTCHA-oplossing, stealthmodus en residentiële proxy's.

{  browser: {    enabled: true,    defaultProfile: "browserbase",    profiles: {      browserbase: {        cdpUrl: "wss://connect.browserbase.com?apiKey=<BROWSERBASE_API_KEY>",        color: "#F97316",      },    },  },}

Opmerkingen:

• Meld je aan en kopieer je API Key vanuit het Overview dashboard.
• Vervang <BROWSERBASE_API_KEY> door je echte Browserbase-API-sleutel.
• Browserbase maakt automatisch een browsersessie aan bij het maken van de WebSocket-verbinding, dus er is geen handmatige stap nodig om een sessie aan te maken.
• Zie prijzen voor de huidige limieten van de gratis versie en betaalde abonnementen.
• Zie de Browserbase-documentatie voor de volledige API- referentie, SDK-handleidingen en integratievoorbeelden.

Notte

Notte is een cloudplatform voor het uitvoeren van headless browsers met ingebouwde stealth, residentiële proxy's en een CDP-native WebSocket-gateway.

{  browser: {    enabled: true,    defaultProfile: "notte",    profiles: {      notte: {        cdpUrl: "wss://us-prod.notte.cc/sessions/connect?token=<NOTTE_API_KEY>",        color: "#7C3AED",      },    },  },}

Opmerkingen:

• Meld je aan en kopieer je API Key vanaf de instellingenpagina van de console.
• Vervang <NOTTE_API_KEY> door je echte Notte-API-sleutel.
• Notte maakt automatisch een browsersessie aan bij het maken van de WebSocket-verbinding, dus er is geen handmatige stap nodig om een sessie aan te maken. De sessie wordt vernietigd wanneer de WebSocket-verbinding wordt verbroken.
• Zie prijzen voor de huidige limieten van de gratis versie en betaalde abonnementen.
• Zie de Notte-documentatie voor de volledige API-referentie, SDK- handleidingen en integratievoorbeelden.

Beveiliging

Kernpunten:

• Browserbesturing is alleen via loopback beschikbaar; toegang verloopt via de authenticatie van de Gateway of het koppelen van nodes.
• De zelfstandige HTTP-API voor de loopback-browser gebruikt alleen authenticatie met een gedeeld geheim: bearer-authenticatie met het Gateway-token, x-openclaw-password of HTTP Basic-authenticatie met het geconfigureerde Gateway-wachtwoord.
• Identiteitsheaders van Tailscale Serve en gateway.auth.mode: "trusted-proxy" authenticeren deze zelfstandige HTTP-API voor de loopback-browser niet.
• Als browserbesturing is ingeschakeld en geen authenticatie met een gedeeld geheim is geconfigureerd, genereert OpenClaw bij het opstarten automatisch een aanmeldgegeven voor browserbesturing en slaat dit permanent op: een token wanneer gateway.auth.mode gelijk is aan none, of een wachtwoord wanneer dit trusted-proxy is (opgeslagen via gateway.auth.password, zodat loopback-clients buiten het proces dit kunnen achterhalen). Automatische generatie wordt overgeslagen wanneer al een expliciet tekenreeksaanmeldgegeven voor die modus is geconfigureerd, of wanneer gateway.auth.mode gelijk is aan password.
• Configureer gateway.auth.token, gateway.auth.password, OPENCLAW_GATEWAY_TOKEN of OPENCLAW_GATEWAY_PASSWORD expliciet als je een stabiel geheim wilt dat je zelf beheert in plaats van het gegenereerde geheim.

Tips voor externe CDP:

• Geef waar mogelijk de voorkeur aan versleutelde eindpunten (HTTPS of WSS) en kortlevende tokens.
• Vermijd het rechtstreeks opnemen van langlevende tokens in configuratiebestanden.
• Houd de Gateway en eventuele nodehosts op een privénetwerk (Tailscale); vermijd openbare blootstelling.
• Behandel externe CDP-URL's/tokens als geheimen; geef de voorkeur aan omgevingsvariabelen of een geheimenbeheerder.

Profielen (meerdere browsers)

OpenClaw ondersteunt meerdere benoemde profielen (routeringsconfiguraties). Profielen kunnen zijn:

• beheerd door OpenClaw: een speciale Chromium-gebaseerde browserinstantie met een eigen map voor gebruikersgegevens + CDP-poort
• extern: een expliciete CDP-URL (Chromium-gebaseerde browser die elders wordt uitgevoerd)
• bestaande sessie: je bestaande Chrome-profiel via automatische verbinding met Chrome DevTools MCP

Standaardwaarden:

• Het openclaw-profiel wordt automatisch aangemaakt als het ontbreekt.
• Het user-profiel is ingebouwd voor koppeling aan een bestaande sessie via Chrome MCP.
• Naast user zijn bestaande-sessieprofielen optioneel; maak ze aan met --driver existing-session.
• Lokale CDP-poorten worden standaard toegewezen uit 18800-18899.
• Bij het verwijderen van een profiel wordt de lokale gegevensmap naar de prullenmand verplaatst.

Alle besturingseindpunten accepteren ?profile=<name>; de CLI gebruikt --browser-profile.

Bestaande sessie via Chrome DevTools MCP

OpenClaw kan ook via de officiële Chrome DevTools MCP-server koppelen aan een actief Chromium-gebaseerd browserprofiel. Hierdoor worden de tabbladen en aanmeldstatus hergebruikt die al in dat browserprofiel zijn geopend.

Officiële achtergrond- en configuratiereferenties:

• Chrome for Developers: Chrome DevTools MCP gebruiken met je browsersessie
• README van Chrome DevTools MCP

Ingebouwd profiel: user. Maak je eigen aangepaste bestaande-sessieprofiel aan als je een andere naam, kleur of map voor browsergegevens wilt.

Standaard gebruikt het ingebouwde user-profiel automatische verbinding via Chrome MCP, die zich richt op het standaard lokale Google Chrome-profiel. Gebruik userDataDir voor Brave, Edge, Chromium of een niet-standaard Chrome-profiel. ~ wordt uitgebreid naar de thuismap van je besturingssysteem:

{  browser: {    profiles: {      brave: {        driver: "existing-session",        attachOnly: true,        userDataDir: "~/Library/Application Support/BraveSoftware/Brave-Browser",        color: "#FB542B",      },    },  },}

Vervolgens in de overeenkomende browser:

1. Open de inspectiepagina van die browser voor foutopsporing op afstand.
2. Schakel foutopsporing op afstand in.
3. Laat de browser actief en keur de verbindingsprompt goed wanneer OpenClaw koppelt.

Veelgebruikte inspectiepagina's:

• Chrome: chrome://inspect/#remote-debugging
• Brave: brave://inspect/#remote-debugging
• Edge: edge://inspect/#remote-debugging

Snelle test voor live koppeling:

openclaw browser --browser-profile user startopenclaw browser --browser-profile user statusopenclaw browser --browser-profile user tabsopenclaw browser --browser-profile user snapshot --format ai

Zo ziet een geslaagd resultaat eruit:

• status toont driver: existing-session
• status toont transport: chrome-mcp
• status toont running: true
• tabs vermeldt je reeds geopende browsertabbladen
• snapshot retourneert verwijzingen van het geselecteerde actieve tabblad

Wat je moet controleren als koppelen niet werkt:

• de Chromium-gebaseerde doelbrowser heeft versie 144+
• foutopsporing op afstand is ingeschakeld op de inspectiepagina van die browser
• de browser heeft de toestemmingsprompt voor koppelen getoond en je hebt deze geaccepteerd
• als Chrome is gestart met een expliciete --remote-debugging-port, stel browser.profiles.<name>.cdpUrl dan in op dat DevTools-eindpunt in plaats van te vertrouwen op automatisch verbinden door Chrome MCP
• openclaw doctor migreert oude extensiegebaseerde browserconfiguratie en controleert of Chrome lokaal is geïnstalleerd voor standaardprofielen met automatisch verbinden, maar kan foutopsporing op afstand niet voor je inschakelen in de browser

Gebruik door agents:

• Gebruik profile="user" wanneer je de aangemelde browserstatus van de gebruiker nodig hebt.
• Als je een aangepast profiel voor een bestaande sessie gebruikt, geef je die expliciete profielnaam door.
• Kies deze modus alleen wanneer de gebruiker achter de computer zit om de koppelingsprompt goed te keuren.
• De Gateway- of Node-host kan npx chrome-devtools-mcp@latest --autoConnect starten.

Opmerkingen:

• Dit pad heeft een hoger risico dan het geïsoleerde profiel openclaw, omdat het binnen je aangemelde browsersessie kan handelen.
• OpenClaw start de browser niet voor dit stuurprogramma; het maakt alleen verbinding.
• OpenClaw gebruikt hier de officiële --autoConnect-flow van Chrome DevTools MCP. Als userDataDir is ingesteld, wordt deze doorgegeven om die map met gebruikersgegevens te gebruiken.
• Een bestaande sessie kan worden gekoppeld op de geselecteerde host of via een verbonden browser-Node. Als Chrome elders draait en er geen browser-Node is verbonden, gebruik je in plaats daarvan CDP op afstand of een Node-host.
• Chrome MCP-doelen en snapshotverwijzingen zijn beperkt tot één MCP-subproces. Nadat dat proces opnieuw is gestart, voer je browser tabs opnieuw uit, selecteer je expliciet een nieuw doel vóór doelspecifiek werk en maak je een nieuwe snapshot voordat je verwijzingen gebruikt. Elke verwijzing is alleen geldig voor het bijbehorende doel en de nieuwste snapshot. Oude aliassen worden niet overgedragen naar een vervangend tabblad, zelfs niet wanneer de URL overeenkomt.
• Chrome DevTools MCP routeert paginatools momenteel via een proceslokale numerieke pagina- ID. Procesgebonden handles voorkomen hergebruik na vervanging van een subproces, maar een vervanging van de browsercontext binnen hetzelfde proces tussen opeenvolgende toolaanroepen kan een actie nog steeds op een ander doel richten. Volledig atomaire routering vereist upstreamondersteuning van paginatools voor stabiele doel-ID's.

Aangepaste Chrome MCP-start

Overschrijf per profiel de gestarte Chrome DevTools MCP-server wanneer de standaard- npx chrome-devtools-mcp@latest-flow niet is wat je wilt (offline hosts, vastgezette versies, meegeleverde binaire bestanden):

Wanneer cdpUrl is ingesteld op een profiel voor een bestaande sessie, slaat OpenClaw --autoConnect over en stuurt het eindpunt automatisch door naar Chrome MCP:

• http(s)://... → --browserUrl <url> (DevTools-eindpunt voor HTTP-detectie).
• ws(s)://... → --wsEndpoint <url> (directe CDP-WebSocket).

Eindpuntvlaggen en userDataDir kunnen niet worden gecombineerd: wanneer cdpUrl is ingesteld, wordt userDataDir genegeerd bij het starten van Chrome MCP, omdat Chrome MCP verbinding maakt met de actieve browser achter het eindpunt in plaats van een profielmap te openen.

Isolatiegaranties

• Speciale map met gebruikersgegevens: raakt je persoonlijke browserprofiel nooit aan.
• Speciale poorten: vermijdt 9222 om botsingen met ontwikkelworkflows te voorkomen.
• Deterministische tabbladbesturing: tabs retourneert eerst suggestedTargetId, daarna stabiele tabId-handles zoals t1, optionele labels en de onbewerkte targetId. Agents moeten suggestedTargetId hergebruiken; onbewerkte ID's blijven beschikbaar voor foutopsporing en compatibiliteit.

Browserselectie

Bij lokaal starten kiest OpenClaw de eerste beschikbare optie:

1. Chrome
2. Brave
3. Edge
4. Chromium
5. Chrome Canary

Je kunt dit overschrijven met browser.executablePath.

Platforms:

• macOS: controleert /Applications en ~/Applications.
• Linux: controleert gebruikelijke locaties van Chrome/Brave/Edge/Chromium onder /usr/bin, /snap/bin, /opt/google, /opt/brave.com, /usr/lib/chromium en /usr/lib/chromium-browser, plus door Playwright beheerde Chromium onder PLAYWRIGHT_BROWSERS_PATH of ~/.cache/ms-playwright.
• Windows: controleert gebruikelijke installatielocaties.

Besturings-API (optioneel)

Voor scripts en foutopsporing biedt de Gateway een kleine HTTP-besturings-API die alleen via loopback bereikbaar is, plus een bijbehorende openclaw browser-CLI (snapshots, verwijzingen, uitgebreide wachtmogelijkheden, JSON-uitvoer, foutopsporingsworkflows). Zie API voor browserbesturing voor de volledige referentie.

Problemen oplossen

Zie voor Linux-specifieke problemen (vooral met snap Chromium) Browserproblemen oplossen.

Zie voor gesplitste hostconfiguraties met een WSL2-Gateway en Chrome op Windows Problemen oplossen met WSL2 + Windows + Chrome CDP op afstand.

CDP-opstartfout versus SSRF-blokkering bij navigatie

Dit zijn verschillende foutklassen die naar verschillende codepaden verwijzen.

• Een CDP-opstart- of gereedheidsfout betekent dat OpenClaw niet kan bevestigen dat het browserbesturingsvlak gezond is.
• Een SSRF-blokkering bij navigatie betekent dat het browserbesturingsvlak gezond is, maar dat een doel voor paginanavigatie door beleid wordt geweigerd.

Veelvoorkomende voorbeelden:

• CDP-opstart- of gereedheidsfout:
  • Chrome CDP websocket for profile "openclaw" is not reachable after start
  • Remote CDP for profile "<name>" is not reachable at <cdpUrl>
  • Port <port> is in use for profile "<name>" but not by openclaw wanneer een externe CDP-service op loopback is geconfigureerd zonder attachOnly: true
• SSRF-blokkering bij navigatie:
  • open, navigate, snapshots of flows voor het openen van tabbladen mislukken met een browser-/netwerkbeleidsfout, terwijl start en tabs nog steeds werken

Gebruik deze minimale reeks om de twee te onderscheiden:

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

De resultaten interpreteren:

• Als start mislukt met not reachable after start, los dan eerst problemen met de CDP-gereedheid op.
• Als start slaagt maar tabs mislukt, is het besturingsvlak nog steeds niet gezond. Behandel dit als een CDP-bereikbaarheidsprobleem, niet als een probleem met paginanavigatie.
• Als start en tabs slagen maar open of navigate mislukt, is het browserbesturingsvlak actief en ligt de fout in het navigatiebeleid of bij de doelpagina.
• Als start, tabs en open allemaal slagen, is het basispad voor beheerde browserbesturing gezond.

Belangrijke gedragsdetails:

• De browserconfiguratie gebruikt standaard een fail-closed SSRF-beleidsobject, zelfs wanneer je browser.ssrfPolicy niet configureert.
• Voor het lokale beheerde loopbackprofiel openclaw slaan CDP-statuscontroles bewust de handhaving van browser-SSRF-bereikbaarheid over voor het lokale besturingsvlak van OpenClaw zelf.
• Navigatiebeveiliging staat hiervan los. Een geslaagd resultaat van start of tabs betekent niet dat een later doel van open of navigate is toegestaan.

Beveiligingsrichtlijnen:

• Versoepel het browser-SSRF-beleid standaard niet.
• Geef de voorkeur aan beperkte hostuitzonderingen zoals hostnameAllowlist of allowedHostnames boven brede toegang tot privénetwerken.
• Gebruik dangerouslyAllowPrivateNetwork: true alleen in bewust vertrouwde omgevingen waar browsertoegang tot privénetwerken vereist en beoordeeld is.

Agenttools + werking van de besturing

De agent krijgt één tool voor browserautomatisering:

• browser - doctor/status/start/stop/tabs/open/focus/close/snapshot/screenshot/navigate/act

Toewijzing:

• browser snapshot retourneert een stabiele UI-boom (AI of ARIA).
• browser act gebruikt de ref-ID's van de momentopname om te klikken, typen, slepen en selecteren.
• browser screenshot legt pixels vast (volledige pagina, element of gelabelde referenties).
• browser doctor controleert of de Gateway, Plugin, het profiel, de browser en het tabblad gereed zijn.
• browser accepteert:
  • profile om een benoemd browserprofiel te kiezen (openclaw, chrome of externe CDP).
  • target (sandbox | host | node) om te selecteren waar de browser zich bevindt.
  • In sandboxsessies vereist target: "host" agents.defaults.sandbox.browser.allowHostControl=true.
  • Als target wordt weggelaten: sandboxsessies gebruiken standaard sandbox, sessies zonder sandbox gebruiken standaard host.
  • Als een Node met browserondersteuning is verbonden, kan de tool er automatisch naartoe routeren, tenzij je target="host" of target="node" vastzet.

Dit houdt de agent deterministisch en voorkomt kwetsbare selectors.

Gerelateerd

• Overzicht van tools - alle beschikbare agenttools
• Sandboxing - browserbesturing in sandboxomgevingen
• Beveiliging - risico's en hardening van browserbesturing