OpenClaw Chrome Extension: Steuere deine Browser-Tabs direkt

Kennst du das? Du hast alle Logins und Sessions in deinem normalen Browser-Fenster perfekt eingerichtet, aber dein KI-Agent startet immer ein komplett leeres, separates Browser-Profil. Das Hin- und Herkopieren von Cookies oder das manuelle Einloggen in Automatisierungs-Umgebungen nervt und hält dich auf. Du willst, dass der Agent dort arbeitet, wo du dich bereits befindest.

Die OpenClaw Chrome Extension löst genau dieses Problem. Sie fungiert als Relay und erlaubt es dem Agenten, deine existierenden Tabs zu steuern, anstatt ein isoliertes Profil zu nutzen. Du entscheidest per Knopfdruck, welchen Tab du freigibst.

Voraussetzungen

• Eine laufende OpenClaw-Instanz (Gateway oder Node)
• Chrome Browser
• Terminal-Zugriff
• Grundverständnis von Chrome Extensions

Schnellstart

In weniger als fünf Minuten hast du die Extension einsatzbereit:

1. Extension installieren: Lade die Extension-Dateien in einen stabilen lokalen Pfad:

   openclaw browser extension install

2. Pfad finden: Lass dir den Installationspfad anzeigen:

   openclaw browser extension path

3. In Chrome laden:

   • Öffne chrome://extensions.
   • Aktiviere den „Developer mode“ (Entwicklermodus).
   • Klicke auf „Load unpacked“ (Entpackte Erweiterung laden) und wähle den Ordner aus Schritt 2.

4. Anheften und Aktivieren: Pinne die Extension in deiner Toolbar. Gehe auf den Tab, den du steuern möchtest, und klicke auf das Icon. Das Badge zeigt ON, wenn die Verbindung steht.

5. Testen: Nutze die CLI, um die Tabs aufzulisten:

   openclaw browser --browser-profile chrome tabs

So funktioniert das Browser-Relay

Das System besteht aus drei Komponenten, die nahtlos zusammenarbeiten: Der Browser control service (Gateway oder Node) stellt die API bereit. Der Local relay server fungiert als Brücke auf http://127.0.0.1:18792. Die Chrome MV3 extension nutzt chrome.debugger, um CDP-Nachrichten zwischen dem Browser und dem Relay zu tunneln.

Updates ohne Build-Step

Die Extension wird als statische Datei innerhalb des OpenClaw npm-Pakets ausgeliefert. Wenn du OpenClaw aktualisierst, musst du nur zwei Dinge tun:

• Führe openclaw browser extension install erneut aus.
• Klicke in chrome://extensions auf „Reload“ bei der OpenClaw Extension.

Profile und Konfiguration

OpenClaw kommt mit einem vordefinierten Profil namens chrome, das direkt auf das Relay zugreift. Du kannst es in Tools so ansprechen:

• Agent Tool: browser mit profile="chrome"

Falls du einen anderen Port oder Namen benötigst, erstelle ein eigenes Profil:

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

Remote Gateway und Node Hosts

Wenn dein Gateway auf derselben Maschine wie dein Chrome läuft, startet der Relay-Server automatisch. Falls dein Gateway jedoch auf einem entfernten Server läuft, musst du einen Node Host auf deinem lokalen Rechner (wo Chrome läuft) starten. Das Gateway leitet die Befehle dann an diesen lokalen Node weiter.

Sandboxing einschränken

Standardmäßig greifen sandboxed Sessions oft auf einen isolierten Sandbox-Browser zu. Wenn dein Agent deine echten Tabs steuern soll, musst du das explizit erlauben:

{
  agents: {
    defaults: {
      sandbox: {
        browser: {
          allowHostControl: true,
        },
      },
    },
  },
}

Prüfe deine Einstellungen im Zweifel mit openclaw sandbox explain.

Sicherheitshinweise

Die Nutzung der Extension ist mächtig, bringt aber Risiken mit sich. Du gibst dem Modell quasi deine “Hände” für deinen Browser.

• Die Extension nutzt chrome.debugger. Ein Agent kann in deinem Namen klicken, tippen und alle Daten lesen, auf die dein eingeloggter Account Zugriff hat.
• Es gibt keine Isolation wie bei einem separaten Profil.
• Nutze am besten ein dediziertes Chrome-Profil für die Arbeit mit dem Relay.
• Halte Gateway und Nodes in einem geschützten Netzwerk (z. B. Tailscale) und vermeide es, Relay-Ports per LAN (0.0.0.0) freizugeben.

Fehlerbehebung

Das Badge der Extension zeigt dir sofort, was los ist:

• ON: Alles bereit, OpenClaw kann diesen Tab steuern.
• …: Verbindung zum lokalen Relay wird aufgebaut.
• !: Relay nicht erreichbar.

Lösung bei ! : Stelle sicher, dass das Gateway oder der Node Host lokal läuft. Überprüfe die „Options“-Seite der Extension; dort siehst du Details zur Erreichbarkeit des Relays.

Brauchst du Hilfe bei der Einrichtung? Nutze den AI Setup Assistant.

Nächste Schritte

• Browser Tool Übersicht
• Security Audit
• Tailscale Setup