`openclaw browser`

Verwalte OpenClaws Browser-Steuerungsserver und führe Browser-Aktionen aus (Tabs, Snapshots, Screenshots, Navigation, Klicks, Texteingabe).

Verwandte Themen:

Browser Tool + API: Browser Tool
Chrome Extension Relay: Chrome Extension

Allgemeine Flags

--url <gatewayWsUrl>: Gateway WebSocket URL (Standard aus der Config).
--token <token>: Gateway Token (falls erforderlich).
--timeout <ms>: Request-Timeout (ms).
--browser-profile <name>: Browser-Profil auswählen (Standard aus der Config).
--json: maschinenlesbare Ausgabe (wo unterstützt).

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 oder verbindet sich mit einer dedizierten, von OpenClaw verwalteten Chrome-Instanz (isoliertes User-Data-Verzeichnis).
chrome: steuert deine bestehenden Chrome-Tabs über 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

Navigieren/Klicken/Tippen (ref-basierte UI-Automatisierung):

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

In diesem Modus kann der Agent einen bestehenden Chrome-Tab steuern, den du manuell ankoppelst (es erfolgt kein automatisches Ankoppeln).

Installiere die entpackte Extension in einen festen Pfad:

openclaw browser extension install
openclaw browser extension path

Dann in Chrome: chrome://extensions aufrufen, “Entwicklermodus” aktivieren, “Entpackte Erweiterung laden” klicken und den angezeigten Ordner auswählen.

Vollständige Anleitung: Chrome Extension

Remote-Browser-Steuerung (Node Host Proxy)

Wenn das Gateway auf einem anderen Rechner läuft als der Browser, starte einen Node Host auf dem Rechner mit Chrome/Brave/Edge/Chromium. Das Gateway leitet Browser-Aktionen an diesen Node weiter (kein separater Browser-Steuerungsserver nötig).

Mit gateway.nodes.browser.mode steuerst du das Auto-Routing, und mit gateway.nodes.browser.node kannst du einen bestimmten Node festlegen, falls mehrere verbunden sind.

Sicherheit + Remote-Setup: Browser Tool, Remote-Zugriff, Tailscale, Sicherheit

openclaw browser