`openclaw browser`

Verwalte OpenClaws Browser-Control-Server und f\u00fchre Browser-Aktionen aus (Tabs, Snapshots, Screenshots, Navigation, Klicks, Tippen).

Verwandte Themen:

Browser-Tool + API: Browser tool
Chrome-Extension-Relay: Chrome extension

H\u00e4ufige Flags

--url <gatewayWsUrl>: Gateway-WebSocket-URL (Standard aus Config).
--token <token>: Gateway-Token (falls erforderlich).
--timeout <ms>: Request-Timeout (ms).
--browser-profile <name>: Browser-Profil ausw\u00e4hlen (Standard aus Config).
--json: Maschinenlesbares Output (wo unterst\u00fctzt).

Schnellstart (lokal)

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

Profile

Profile sind benannte Browser-Routing-Konfigurationen. In der Praxis:

openclaw: Startet/verbindet sich mit einer dedizierten OpenClaw-verwalteten Chrome-Instanz (isoliertes User-Data-Dir).
chrome: Steuert deine bestehenden Chrome-Tab(s) \u00fcber das Chrome-Extension-Relay.

openclaw browser profiles
openclaw browser create-profile --name work --color "#FF5A36"
openclaw browser delete-profile --name work

Ein bestimmtes Profil verwenden:

openclaw browser --browser-profile work tabs

Tabs

openclaw browser tabs
openclaw browser open https://docs.openclaw.ai
openclaw browser focus <targetId>
openclaw browser close <targetId>

Snapshot / Screenshot / Aktionen

Snapshot:

openclaw browser snapshot

Screenshot:

openclaw browser screenshot

Navigation/Klick/Tippen (ref-basierte UI-Automatisierung):

openclaw browser navigate https://example.com
openclaw browser click <ref>
openclaw browser type <ref> "hello"

Dieser Modus l\u00e4sst den Agent einen bestehenden Chrome-Tab steuern, den du manuell verbindest (es gibt kein Auto-Attach).

Die Unpacked-Extension an einem stabilen Pfad installieren:

openclaw browser extension install
openclaw browser extension path

Dann Chrome -> chrome://extensions -> “Entwicklermodus” aktivieren -> “Entpackte Erweiterung laden” -> den angezeigten Ordner ausw\u00e4hlen.

Vollst\u00e4ndige Anleitung: Chrome extension

Remote-Browser-Steuerung (Node-Host-Proxy)

Wenn das Gateway auf einer anderen Maschine l\u00e4uft als der Browser, betreibe einen Node-Host auf der Maschine mit Chrome/Brave/Edge/Chromium. Das Gateway leitet Browser-Aktionen an diesen Node weiter (kein separater Browser-Control-Server n\u00f6tig).

Verwende gateway.nodes.browser.mode zur Steuerung des Auto-Routings und gateway.nodes.browser.node, um einen bestimmten Node festzulegen, wenn mehrere verbunden sind.

Sicherheit + Remote-Setup: Browser tool, Remote access, Tailscale, Security

openclaw browser