Isolierte Browser-Profile mit OpenClaw verwalten

Kennst du das Problem? Du entwickelst einen Agenten und plötzlich vermischen sich Testdaten mit deinen privaten Browser-Tabs. Es ist extrem nervig, ständig Cookies zu löschen oder Angst zu haben, dass ein automatisierter Klick dein echtes Social-Media-Profil durcheinanderbringt.

Die Lösung ist eine strikte Trennung. Du brauchst eine Umgebung, in der dein Agent sich austoben kann, ohne deine tägliche Arbeit zu stören. OpenClaw bietet dafür ein verwaltetes Browser-System, das komplett isoliert von deinem Haupt-Browser läuft.

Voraussetzungen

• OpenClaw Gateway (lokal installiert)
• Ein Chromium-basierter Browser (Chrome, Brave, Edge oder Chromium)
• Zugriff auf die Konfigurationsdatei unter ~/.openclaw/openclaw.json

Schnellstart

In weniger als fünf Minuten hast du deinen eigenen, isolierten Browser am Start. Nutze diese Befehle, um direkt loszulegen:

openclaw browser --browser-profile openclaw status
openclaw browser --browser-profile openclaw start
openclaw browser --browser-profile openclaw open https://example.com
openclaw browser --browser-profile openclaw snapshot

Der richtige Modus: openclaw vs. chrome

Du hast die Wahl zwischen zwei Ansätzen. Ich empfehle für die meisten Automatisierungen das openclaw Profil, da es die sauberste Trennung bietet.

• openclaw: Ein verwalteter, isolierter Browser. Du brauchst keine Extension, da die Steuerung direkt über den Gateway läuft. Er hat standardmäßig einen orangefarbenen Akzent, damit du ihn sofort erkennst.
• chrome: Nutzt deinen normalen System-Browser via Extension Relay. Das ist sinnvoll, wenn du eine Extension in einem bestimmten Tab manuell verknüpfen willst.

Wenn du den isolierten Modus standardmäßig nutzen möchtest, setze in deiner Config browser.defaultProfile: "openclaw".

Konfiguration anpassen

Die Einstellungen verwaltest du in der Datei ~/.openclaw/openclaw.json. Hier ist ein Beispiel, wie eine vollständige Konfiguration aussieht:

{
  browser: {
    enabled: true,
    remoteCdpTimeoutMs: 1500,
    remoteCdpHandshakeTimeoutMs: 3000,
    defaultProfile: "chrome",
    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" },
      remote: { cdpUrl: "http://10.0.0.42:9222", color: "#00AA00" },
    },
  },
}

Hier sind ein paar wichtige Details zur Funktionsweise:

• Der Browser-Control-Service nutzt Ports, die von deinem gateway.port abgeleitet sind (Standard ist 18791).
• Falls du attachOnly: true setzt, startet OpenClaw niemals selbst einen Browser, sondern versucht nur, sich mit einem bereits laufenden zu verbinden.
• Die Farbe (color) hilft dir visuell zu unterscheiden, welches Profil gerade aktiv ist.
• OpenClaw sucht automatisch nach Chromium-Browsern in der Reihenfolge: System Default → Chrome → Brave → Edge → Chromium → Chrome Canary.

Fehlerbehebung

”Browser disabled” Fehlermeldung

Falls du diese Meldung erhältst, ist das Browser-Modul in deiner Konfiguration deaktiviert. Lösung: Setze enabled: true in der openclaw.json unter dem Key browser und starte den Gateway neu.

Fazit

Mit dem managed Browser hast du eine sichere Spielwiese für deine Agenten. Du kannst Tabs öffnen, Seiten lesen, klicken und tippen, ohne deine privaten Daten zu gefährden.

Hast du Fragen zur Einrichtung? Nutze den AI Setup Assistant für schnelle Hilfe.

Nächste Schritte

• Gateway API Reference
• Browser Extension Setup

---
title: "Brave und Chromium-Browser mit OpenClaw nutzen"
description: "So konfigurierst du lokale Browser, Remote-CDP-Verbindungen und Browserless-Instanzen für deine Automatisierungen."
---

Kennst du das? Du willst ein Tool automatisieren, aber es erkennt deinen Browser nicht oder die Pfade passen einfach nicht. Statt direkt loszulegen, suchst du in Config-Dateien nach dem richtigen Executable-Pfad oder kämpfst mit komplexen Remote-Verbindungen.

Es ist nervig, wenn die Toolchain nicht mit dem Browser harmoniert, den du eigentlich nutzen willst. OpenClaw macht dir das Leben hier leichter, egal ob du lokal arbeitest oder Browser in der Cloud ansteuerst.

## Voraussetzungen

- Einen Chromium-basierten Browser (Brave, Chrome oder Edge)
- OpenClaw Gateway oder Node host
- (Optional) API Key für Browserless

## Schnellstart

Wenn dein Standard-Browser auf Chromium basiert, nutzt OpenClaw ihn automatisch. Falls du einen spezifischen Pfad erzwingen willst, kannst du `browser.executablePath` überschreiben.

Nutze dafür die CLI:

```bash
openclaw config set browser.executablePath "/usr/bin/google-chrome"

Oder bearbeite deine Konfiguration direkt für dein Betriebssystem:

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

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

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

Local vs. Remote Control

Du hast drei Möglichkeiten, wie OpenClaw deine Browser-Instanzen steuert:

• Local control (default): Das Gateway startet den Loopback-Control-Service und öffnet einen lokalen Browser.
• Remote control (node host): Du lässt einen Node host auf der Maschine laufen, auf der sich der Browser befindet. Das Gateway leitet die Befehle per Proxy weiter.
• Remote CDP: Setze browser.profiles.<name>.cdpUrl (oder browser.cdpUrl), um dich mit einem entfernten Chromium-Browser zu verbinden. In diesem Fall startet OpenClaw keinen lokalen Browser.

Remote CDP URLs unterstützen Authentifizierung via Query-Tokens oder HTTP Basic auth:

• https://provider.example?token=<token>
• https://user:pass@provider.example

OpenClaw behält diese Daten bei Aufrufen von /json/* Endpoints und beim Verbinden mit dem CDP WebSocket bei. Ich empfehle dir, Tokens über Umgebungsvariablen oder Secrets Manager zu verwalten, statt sie direkt in die Config zu schreiben.

Node Browser Proxy (Zero-Config Default)

Wenn du einen Node host auf der Maschine nutzt, auf der dein Browser installiert ist, kann OpenClaw Browser-Tool-Calls automatisch an diesen Node routen. Das ist der Standardweg für Remote Gateways und erfordert keine extra Browser-Konfiguration.

Beachte dabei:

• Der Node host stellt seinen lokalen Browser-Control-Server über einen proxy command bereit.
• Profile werden aus der browser.profiles Config des Nodes geladen.
• Du kannst das deaktivieren, wenn du es nicht brauchst:
  • Auf dem Node: nodeHost.browserProxy.enabled=false
  • Auf dem Gateway: gateway.nodes.browser.mode="off"

Browserless (Hosted Remote CDP)

Browserless ist ein Cloud-Service, der CDP-Endpunkte über HTTPS anbietet. Du kannst ein OpenClaw-Profil direkt auf einen Browserless-Endpunkt ausrichten.

Beispiel-Konfiguration:

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

Ersetze <BROWSERLESS_API_KEY> durch deinen echten Token und wähle den passenden Region-Endpunkt aus der Browserless-Dokumentation.

Profiles (Multi-Browser)

OpenClaw unterstützt verschiedene benannte Profile für deine Routing-Konfigurationen:

• openclaw-managed: Eine eigene Chromium-Instanz mit separatem User-Data-Verzeichnis und CDP-Port.
• remote: Eine explizite CDP-URL für Browser, die woanders laufen.
• extension relay: Deine existierenden Chrome-Tabs via lokalem Relay und Chrome-Extension.

Hier sind einige Standard-Einstellungen:

• Das openclaw-Profil wird automatisch erstellt, falls es fehlt.
• Das chrome-Profil ist für das Extension Relay vordefiniert (Standard: http://127.0.0.1:18792).
• Lokale CDP-Ports werden standardmäßig im Bereich 18800–18899 vergeben.
• Wenn du ein Profil löschst, landet das lokale Datenverzeichnis im Papierkorb.

Alle Endpoints akzeptieren den Parameter ?profile=<name>, in der CLI nutzt du --browser-profile.

Security

Sicherheit ist wichtig, besonders wenn du Browser fernsteuerst. Hier sind die Kernpunkte:

• Die Browser-Steuerung ist “loopback-only”. Der Zugriff erfolgt nur über die Authentifizierung des Gateways oder das Node-Pairing.
• Halte das Gateway und die Node hosts in einem privaten Netzwerk (z. B. Tailscale) und vermeide öffentliche Erreichbarkeit.
• Behandle Remote CDP URLs und Tokens wie Passwörter.
• Nutze bevorzugt HTTPS-Endpunkte und kurzlebige Tokens.

Fehlerbehebung

• Browser wird nicht gefunden: Wenn die Automatik versagt, setze browser.executablePath manuell in der Config oder via CLI, wie im Quick Start gezeigt.
• Auth-Probleme bei Remote CDP: Stelle sicher, dass Tokens nicht durch Config-Commits geleakt werden. Nutze Umgebungsvariablen für die cdpUrl.

Fragen zur Einrichtung? Nutze den AI Setup Assistant.

Nächste Schritte

• Gateway Configuration
• Node Host Setup
• CLI Reference
• Chrome Extension Relay

Du kennst das Problem: Du hast alle deine Logins, Cookies und aktiven Sessions bereits in deinem normalen Browser offen. Wenn du ein Automatisierung-Tool startest, öffnet es oft eine komplett neue, leere Browser-Instanz. Du musst dich überall neu anmelden und verlierst den Kontext deiner Arbeit. Das nervt und hält den Workflow auf.

OpenClaw löst das elegant. Du kannst deine existierenden Chrome-Tabs direkt ansteuern, ohne eine separate Instanz zu starten. Das Ganze läuft über ein lokales CDP Relay und eine Chrome Extension. So behältst du die volle Kontrolle und nutzt deine gewohnte Umgebung.

## Voraussetzungen

- **Lokal laufender Gateway**: Entweder auf derselben Maschine oder ein Node Host auf der Browser-Maschine.
- **Relay Server**: Ein lokaler Server, der auf `http://127.0.0.1:18792` hört (Standard-Loopback).
- **OpenClaw Browser Relay Extension**: Muss manuell im Browser aktiviert werden.
- **Playwright**: Erforderlich für fortgeschrittene Aktionen wie Screenshots, Snapshots oder PDF-Erstellung.

## Schnellstart

In 5 Minuten bist du startklar. Folge einfach diesen Schritten:

1. **Extension laden**:
   Installiere die Extension als "unpacked" Version über die CLI:
   ```bash
   openclaw browser extension install

2. Im Browser aktivieren:

   • Gehe zu chrome://extensions in deinem Chrome.
   • Aktiviere den “Developer mode” (Entwicklermodus).
   • Klicke auf “Load unpacked” (Entpackte Erweiterung laden).
   • Wähle das Verzeichnis aus, das dir der Befehl openclaw browser extension path ausgibt.
   • Pinne die Extension in deiner Toolbar.

3. Tab verbinden: Klicke auf das OpenClaw Browser Relay Icon in dem Tab, den du steuern möchtest. Das Badge zeigt ON an. Die Extension verbindet sich nicht automatisch; du entscheidest, welcher Tab gesteuert wird.

4. Nutzen:

   • Über die CLI: openclaw browser --browser-profile chrome tabs
   • Über ein Agent Tool: Nutze das browser Tool mit dem Parameter profile="chrome".

Falls du einen eigenen Namen oder Port bevorzugst, erstelle ein eigenes Profil:

openclaw browser create-profile \
  --name my-chrome \
  --driver extension \
  --cdp-url http://127.0.0.1:18792 \
  --color "#00AA00"

Fehlerbehebung

Hier sind Lösungen für Probleme, die im Betrieb auftreten können:

• Playwright Fehlermeldung: Wenn du Playwright is not available in this gateway build siehst, fehlen wichtige Treiber. Installiere das vollständige playwright Paket (nicht nur playwright-core) und starte den Gateway neu. Ohne Playwright funktionieren ARIA Snapshots und Screenshots im Extension-Modus nicht.
• Docker Installation: Vermeide npx playwright im Docker-Container, da dies zu Konflikten führen kann. Nutze stattdessen die CLI:

  docker compose run --rm openclaw-cli \
    node /app/node_modules/playwright-core/cli.js install chromium

• Sandboxed Sessions: Wenn dein Agent in einer Sandbox läuft, blockiert er standardmäßig den Zugriff auf den Host-Browser. Um das zu ändern, setze agents.defaults.sandbox.browser.allowHostControl: true und verwende target="host" beim Aufruf des Tools.
• Verbindung trennen: Klicke einfach erneut auf das Extension-Icon, um den Tab vom Relay zu trennen.

Isolation und Browser-Wahl

OpenClaw achtet darauf, dass deine Daten sicher bleiben. Es wird ein Dedicated user data dir verwendet, sodass dein persönliches Browser-Profil unberührt bleibt. Zudem werden Dedicated ports genutzt, um Kollisionen mit anderen Entwickler-Workflows (die oft Port 9222 nutzen) zu vermeiden. Die Steuerung der Tabs erfolgt deterministisch über die targetId.

Beim lokalen Start sucht OpenClaw in dieser Reihenfolge nach verfügbaren Browsern:

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

Du kannst diesen Pfad jederzeit mit browser.executablePath überschreiben.

Control API

Für lokale Integrationen bietet der Gateway eine HTTP API an. Alle Endpunkte akzeptieren den Query-Parameter ?profile=<name>.

Hier sind einige wichtige Endpunkte:

• Status & Steuerung: GET /, POST /start, POST /stop
• Tabs: GET /tabs, POST /tabs/open, POST /tabs/focus, DELETE /tabs/:targetId
• Interaktionen: POST /navigate, POST /act, POST /screenshot, GET /snapshot
• State: GET /cookies, POST /cookies/set, GET /storage/:kind
• Settings: POST /set/geolocation, POST /set/timezone, POST /set/locale, POST /set/headers

Das System nutzt intern einen Control Server, der HTTP-Anfragen annimmt und via CDP mit Chromium-basierten Browsern kommuniziert. Playwright wird als Layer obenauf gesetzt, um komplexe Aktionen wie Klicks oder PDF-Exporte stabil auszuführen.

Hast du Fragen zum Setup oder brauchst Hilfe bei der Konfiguration? AI Setup Assistant

Nächste Schritte

• Chrome extension Dokumentation
• Docker Installation Guide

Kennst du das? Du versuchst, eine Browser-Automatisierung zu debuggen, und musst ständig zwischen Code-Editor, Terminal und dem eigentlichen Browser-Fenster hin- und herwechseln. Es ist frustrierend, wenn man nicht mal eben schnell den aktuellen Status prüfen oder eine Interaktion testen kann, ohne gleich ein komplettes Script auszuführen.

Mit der openclaw CLI kannst du deinen Browser direkt aus der Konsole steuern. Das spart Zeit und macht das Testen von Workflows deutlich direkter. Hier ist die Übersicht, wie du das Tool effizient nutzt.

Voraussetzungen

• Installiertes openclaw
• Playwright (empfohlen für den Standard --format ai bei Snapshots)

Schnellstart

In weniger als 5 Minuten hast du die Basics im Griff. Alle Befehle unterstützen das Flag --browser-profile <name> für spezifische Profile und --json für eine maschinenlesbare Ausgabe.

# Browser starten und Status prüfen
openclaw browser start
openclaw browser status

# Eine URL öffnen
openclaw browser open https://example.com

# Einen Screenshot zur Kontrolle machen
openclaw browser screenshot

CLI Befehlsübersicht

Basics

Hier verwaltest du die Instanz und die Tabs.

• openclaw browser status
• openclaw browser start
• openclaw browser stop
• openclaw browser tabs
• openclaw browser tab
• openclaw browser tab new
• openclaw browser tab select 2
• openclaw browser tab close 2
• openclaw browser open https://example.com
• openclaw browser focus abcd1234
• openclaw browser close abcd1234

Inspection

Nutze diese Befehle, um den aktuellen Zustand der Seite zu analysieren.

• openclaw browser screenshot
• openclaw browser screenshot --full-page
• openclaw browser screenshot --ref 12
• openclaw browser screenshot --ref e12
• openclaw browser snapshot
• openclaw browser snapshot --format aria --limit 200
• openclaw browser snapshot --interactive --compact --depth 6
• openclaw browser snapshot --efficient
• openclaw browser snapshot --labels
• openclaw browser snapshot --selector "#main" --interactive
• openclaw browser snapshot --frame "iframe#main" --interactive
• openclaw browser console --level error
• openclaw browser errors --clear
• openclaw browser requests --filter api --clear
• openclaw browser pdf
• openclaw browser responsebody "**/api" --max-chars 5000

Actions

Führe Interaktionen auf der Seite aus. Wichtig: Aktionen wie click oder type benötigen eine ref aus einem vorherigen snapshot (entweder numerisch wie 12 oder eine Role-Ref wie e12). CSS-Selektoren werden für Aktionen absichtlich nicht unterstützt.

• openclaw browser navigate https://example.com
• openclaw browser resize 1280 720
• openclaw browser click 12 --double
• openclaw browser click e12 --double
• openclaw browser type 23 "hello" --submit
• openclaw browser press Enter
• openclaw browser hover 44
• openclaw browser scrollintoview e12
• openclaw browser drag 10 11
• openclaw browser select 9 OptionA OptionB
• openclaw browser download e12 /tmp/report.pdf
• openclaw browser waitfordownload /tmp/report.pdf
• openclaw browser upload /tmp/file.pdf
• openclaw browser fill --fields '[{"ref":"1","type":"text","value":"Ada"}]'
• openclaw browser dialog --accept
• openclaw browser wait --text "Done"
• openclaw browser wait "#main" --url "**/dash" --load networkidle --fn "window.ready===true"
• openclaw browser evaluate --fn '(el) => el.textContent' --ref 7
• openclaw browser highlight e12
• openclaw browser trace start
• openclaw browser trace stop

State Management

Verwalte Cookies, Storage und Browser-Einstellungen.

• openclaw browser cookies
• openclaw browser cookies set session abc123 --url "https://example.com"
• openclaw browser cookies clear
• openclaw browser storage local get
• openclaw browser storage local set theme dark
• openclaw browser storage session clear
• openclaw browser set offline on
• openclaw browser set headers --json '{"X-Debug":"1"}'
• openclaw browser set credentials user pass
• openclaw browser set credentials --clear
• openclaw browser set geo 37.7749 -122.4194 --origin "https://example.com"
• openclaw browser set geo --clear
• openclaw browser set media dark
• openclaw browser set timezone America/New_York
• openclaw browser set locale en-US
• openclaw browser set device "iPhone 14"

Fehlerbehebung

Uploads oder Dialoge funktionieren nicht

Befehle wie upload und dialog sind sogenannte arming calls. Du musst sie ausführen, bevor du den Click oder Tastendruck auslöst, der den File-Chooser oder den Dialog öffnet.

Snapshot-Formate verstehen

• --format ai: (Standard, wenn Playwright installiert ist) Liefert einen AI-Snapshot mit numerischen Referenzen (aria-ref="<n>").
• --format aria: Liefert den Accessibility Tree ohne Referenzen (nur zur Inspektion).
• --efficient: Ein Preset für kompakte Snapshots (interactive + compact + depth + geringere maxChars). Du kannst dies als Default in der Gateway configuration unter browser.snapshotDefaults.mode: "efficient" setzen.
• --interactive: Erzeugt eine flache Liste interaktiver Elemente. Das ist der beste Weg, um Referenzen für Aktionen zu finden.
• --labels: Erzeugt einen Screenshot mit überlagerten Ref-Labels (Ausgabe: MEDIA:<path>).

Iframe-Scoping

Wenn du mit Iframes arbeitest, nutze --frame "<iframe selector>". Dies beschränkt den Snapshot auf den Iframe und ermöglicht die Nutzung von Role-Refs wie e12.

---

Du hast Fragen zu einem spezifischen Flag? Frag unseren AI Setup Assistant.

Nächste Schritte

• Gateway configuration

Kennst du das? Du versuchst ein Element zu automatisieren, aber die Selektoren ändern sich ständig oder das Timing haut nicht hin. Es nervt, wenn Skripte wegen kleiner UI-Änderungen direkt umkippen und man ständig CSS-Pfade nachbessern muss.

OpenClaw löst das Problem, indem es dir Snapshots gibt, die auf logischen Referenzen basieren statt auf fragilen DOM-Pfaden. Ich empfehle dir, so oft wie möglich mit Role-basierten Refs zu arbeiten, da sie die Absicht deines Codes viel besser widerspiegeln.

Voraussetzungen

• Einen konfigurierten OpenClaw Browser-Profile (behandle diesen als sensibel, da er Sessions enthalten kann).
• Zugriff auf das Gateway oder den Node-Host (am besten via Loopback oder Tailnet).

Schnellstart

In 5 Minuten zu stabilen Klicks:

1. Snapshot erstellen: Erzeuge eine Liste der interaktiven Elemente.

   openclaw browser snapshot

2. Aktion ausführen: Nutze die numerische Ref aus dem Output für eine Aktion.

   openclaw browser click 12

Snapshots und Refs

OpenClaw unterstützt zwei verschiedene Styles für Snapshots:

• AI snapshot (numerische Refs): openclaw browser snapshot (Standard; --format ai)
  • Output: Ein Text-Snapshot mit numerischen Refs.
  • Aktionen: openclaw browser click 12, openclaw browser type 23 "hello".
  • Intern wird die Ref über Playwrights aria-ref aufgelöst.
• Role snapshot (Role-Refs wie e12): openclaw browser snapshot --interactive (oder --compact, --depth, --selector, --frame)
  • Output: Eine rollenbasierte Liste/Baumstruktur mit [ref=e12] (optional mit [nth=1]).
  • Aktionen: openclaw browser click e12, openclaw browser highlight e12.
  • Intern wird die Ref via getByRole(...) aufgelöst (plus nth() bei Duplikaten).
  • Nutze --labels, um einen Viewport-Screenshot mit überlagerten e12-Labels zu erhalten.

Wichtiges Verhalten der Refs:

• Refs sind nicht stabil über Navigationen hinweg. Wenn etwas fehlschlägt, führe snapshot neu aus und nutze eine frische Ref.
• Wenn der Role-Snapshot mit --frame erstellt wurde, sind die Role-Refs auf diesen iframe begrenzt, bis der nächste Role-Snapshot erstellt wird.

Wait Power-ups

Du kannst auf viel mehr warten als nur auf Zeit oder Text:

• Warten auf URL (Playwright Glob-Support): openclaw browser wait --url "**/dash"
• Warten auf Load State: openclaw browser wait --load networkidle
• Warten auf JS Predicate: openclaw browser wait --fn "window.ready===true"
• Warten auf Sichtbarkeit eines Selectors: openclaw browser wait "#main"

Du kannst diese Bedingungen kombinieren:

openclaw browser wait "#main" \
  --url "**/dash" \
  --load networkidle \
  --fn "window.ready===true" \
  --timeout-ms 15000

Debug Workflows

Wenn eine Aktion fehlschlägt (z. B. “not visible”, “strict mode violation”, “covered”), gehe so vor:

1. openclaw browser snapshot --interactive
2. Nutze click <ref> / type <ref> (nutze im interaktiven Modus bevorzugt Role-Refs).
3. Falls es immer noch hakt: openclaw browser highlight <ref>, um zu sehen, was Playwright anvisiert.
4. Falls sich die Seite merkwürdig verhält:
   • openclaw browser errors --clear
   • openclaw browser requests --filter api --clear
5. Für tiefes Debugging einen Trace aufnehmen:
   • openclaw browser trace start
   • Fehler reproduzieren
   • openclaw browser trace stop (gibt den Pfad TRACE:<path> aus)

JSON Output

Für Scripting und strukturierte Tools nutzt du --json.

Beispiele:

openclaw browser status --json
openclaw browser snapshot --interactive --json
openclaw browser requests --filter api --json
openclaw browser cookies --json

Role-Snapshots in JSON enthalten refs sowie einen stats-Block (Lines, Chars, Refs, Interactive), damit Tools die Payload-Größe und Dichte einschätzen können.

State und Environment Knobs

Diese Befehle sind nützlich für Workflows, bei denen sich die Seite wie “X” verhalten soll:

• Cookies: cookies, cookies set, cookies clear
• Storage: storage local|session get|set|clear
• Offline-Modus: set offline on|off
• Headers: set headers --json '{"X-Debug":"1"}' (oder --clear)
• HTTP Basic Auth: set credentials user pass (oder --clear)
• Geolocation: set geo <lat> <lon> --origin "https://example.com" (oder --clear)
• Media: set media dark|light|no-preference|none
• Timezone / Locale: set timezone ..., set locale ...
• Device / Viewport:
  • set device "iPhone 14" (Playwright Device Presets)
  • set viewport 1280 720

Security & Privacy

• Das OpenClaw Browser-Profil kann eingeloggte Sessions enthalten. Behandle es als sensibel.
• browser act kind=evaluate, openclaw browser evaluate und wait --fn führen beliebiges JavaScript im Kontext der Seite aus. Prompt Injection kann dies steuern. Deaktiviere es mit browser.evaluateEnabled=false, falls du es nicht brauchst.
• Für Logins und Anti-Bot-Hinweise (X/Twitter etc.) schau dir Browser login + X/Twitter posting an.
• Halte den Gateway/Node-Host privat (nur Loopback oder Tailnet).
• Remote CDP Endpoints sind mächtig; tunnel und schütze sie.

Agent Tools + Control-Logik

Der Agent erhält ein Tool für die Browser-Automatisierung:

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

So wird es gemappt:

• browser snapshot liefert einen stabilen UI-Baum (AI oder ARIA).
• browser act nutzt die Snapshot ref IDs für click/type/drag/select.
• browser screenshot erfasst Pixel (ganze Seite oder Element).
• browser akzeptiert:
  • profile: Wählt ein benanntes Browser-Profil (openclaw, chrome oder remote CDP).
  • target (sandbox | host | node): Wählt den Ort, an dem der Browser läuft.
  • In Sandboxed Sessions erfordert target: "host" die Einstellung agents.defaults.sandbox.browser.allowHostControl=true.
  • Wenn target fehlt: Sandbox-Sessions nutzen standardmäßig sandbox, andere host.
  • Wenn ein Browser-fähiger Node verbunden ist, kann das Tool automatisch dorthin routen, außer du fixierst target="host" oder target="node".

Das hält den Agenten deterministisch und vermeidet brüchige Selektoren.

Fehlerbehebung

Bei Linux-spezifischen Problemen (besonders bei Snap Chromium) findest du Hilfe unter Browser troubleshooting.

Bei weiteren Fragen wende dich an den AI Setup Assistant.

Nächste Schritte

• Browser login + X/Twitter posting
• Browser troubleshooting