Browser Relay (Chrome-Erweiterung)

Was das Browser Relay macht

Die Browser Relay Chrome-Erweiterung verbindet deinen Browser mit deiner ClawHosters-Instanz, damit dein KI-Agent Browser-Tabs steuern kann. Seiten aufrufen, Buttons klicken, Formulare ausfüllen, Screenshots machen und Daten von beliebigen Websites extrahieren.

Ohne diese Erweiterung kann dein Agent nur über Messenger-Apps kommunizieren. Mit ihr bekommt dein Agent Augen und Hände fürs Web.

So funktioniert es

Die Erweiterung erstellt eine sichere WebSocket-Verbindung zwischen deinem Chrome-Browser und dem OpenClaw Relay-Server auf deiner Instanz:

1. Du verbindest einen Browser-Tab per Klick auf das Erweiterungs-Icon
2. Die Erweiterung verbindet sich über eine verschlüsselte Verbindung (wss://) mit dem Relay-Endpoint deiner Instanz
3. Dein KI-Agent sendet Chrome DevTools Protocol-Befehle durch das Relay
4. Die Erweiterung führt diese Befehle im verbundenen Tab aus und gibt die Ergebnisse zurück

Dein Agent kann nur Tabs sehen und steuern, die du explizit verbindest. Es passiert nichts automatisch.

Installation

Chrome Web Store (Demnächst verfügbar)

Die Erweiterung befindet sich aktuell im Review-Prozess für den Chrome Web Store. Sobald sie genehmigt ist, kannst du sie direkt von dort installieren.

Manuelle Installation (Jetzt verfügbar)

1. Lade die Erweiterung von GitHub herunter oder klone das Repository
2. Öffne chrome://extensions/ in deinem Browser
3. Aktiviere den Entwicklermodus (Schalter oben rechts)
4. Klicke auf Entpackte Erweiterung laden
5. Wähle den clawhosters-relay-Ordner aus

Das Erweiterungs-Icon erscheint in deiner Toolbar.

Einrichtung

1. Rechtsklick auf das Erweiterungs-Icon und Optionen wählen (oder auf das Zahnrad-Icon klicken)
2. Wähle Remote (ClawHosters) als Verbindungsmodus
3. Gib deine Instanz-URL ein (z.B. https://mybot.clawhosters.com)
4. Gib deinen Gateway-Token ein (findest du im Instanz-Dashboard unter Zugangsdaten)
5. Klicke auf Save

Eine grüne "Connected"-Meldung bestätigt, dass das Relay erreichbar ist.

Browser-Steuerung verwenden

Tab verbinden

Klicke auf das Erweiterungs-Icon bei einem beliebigen Tab. Das Badge wird grün und zeigt an, dass dieser Tab jetzt für deinen Agent sichtbar ist.

Befehle geben

Schreibe deinem Agent über Telegram, WhatsApp oder einen anderen verbundenen Kanal:

• "Geh auf wikipedia.de"
• "Suche nach 'OpenClaw Hosting' auf Google"
• "Fülle das Kontaktformular mit meinen Daten aus"
• "Mach einen Screenshot von dieser Seite"
• "Klicke auf den Registrieren-Button"

Dein Agent führt diese Aktionen im verbundenen Tab aus.

Tab trennen

Klicke erneut auf das Erweiterungs-Icon, um den Tab zu trennen. Das Badge verschwindet und dein Agent kann diesen Tab nicht mehr sehen oder steuern.

Verbindungsmodi

Modus	Wann verwenden	Verbindung
Remote (ClawHosters)	Deine Instanz läuft auf ClawHosters	wss:// verschlüsselte Verbindung
Lokal	OpenClaw läuft auf deinem eigenen Rechner	ws://127.0.0.1 Loopback

Der Remote-Modus ist der Standard für ClawHosters-Nutzer. Der lokale Modus funktioniert identisch zur offiziellen OpenClaw Chrome-Erweiterung.

Sicherheit

Das Relay nutzt mehrere Schutzebenen:

• TLS-Verschlüsselung — Alle Remote-Verbindungen nutzen wss:// (WebSocket über HTTPS)
• HMAC-Token-Authentifizierung — Das Relay validiert einen kryptografischen Token, der von deinem Gateway-Token abgeleitet wird
• Explizite Tab-Verbindung — Nur Tabs, die du manuell verbindest, sind zugänglich
• Keine Datenerfassung — Die Erweiterung sammelt keine Analysen, Telemetrie oder Browserdaten
• Open Source — Vollständiger Quellcode auf GitHub verfügbar

Fehlerbehebung

Rotes "!" Badge auf dem Erweiterungs-Icon

Der Relay-Server ist nicht erreichbar. Prüfe folgendes: - Deine Instanz läuft (nicht gestoppt oder pausiert) - Die Instanz-URL in den Erweiterungsoptionen ist korrekt - Der Gateway-Token stimmt mit deinen Instanz-Zugangsdaten überein

"Cannot reach relay" in den Optionen

• Überprüfe den Status deiner Instanz im ClawHosters-Dashboard
• Stelle sicher, dass du die vollständige URL inklusive https:// eingegeben hast
• Versuche die Optionsseite neu zu laden und erneut zu speichern

Tab reagiert nicht auf Agent-Befehle

• Prüfe, ob das Erweiterungs-Badge grün ist (Tab ist verbunden)
• Versuche den Tab zu trennen und erneut zu verbinden
• Manche Seiten blockieren Automatisierung (Banking-Seiten, Chrome-interne Seiten wie chrome://)

Erweiterung trennt sich häufig

Die Erweiterung verbindet sich automatisch neu, wenn die Verbindung abbricht. Bei häufigen Unterbrechungen: - Prüfe die Stabilität deiner Internetverbindung - Cloudflares WebSocket-Idle-Timeout beträgt 100 Sekunden — die Erweiterung sendet Keepalive-Pings, um dies zu verhindern

Datenschutz

Die Erweiterung kommuniziert ausschließlich zwischen deinem Browser und deiner ClawHosters-Instanz. Es werden keine Daten an Dritte gesendet. Kein Browserverlauf, keine Seiteninhalte und keine Zugangsdaten verlassen die sichere Relay-Verbindung.

Vollständige Datenschutzerklärung: PRIVACY.md