Peekaboo Bridge (macOS-UI-Automatisierung)

OpenClaw kann PeekabooBridge als lokalen, berechtigungsgesteuerten UI-Automatisierungs-Broker hosten. Das ermöglicht es der peekaboo-CLI, UI-Automatisierung auszuführen und dabei die TCC-Berechtigungen der macOS-App wiederzuverwenden.

Was das ist (und was nicht)

Host: OpenClaw.app kann als PeekabooBridge-Host fungieren.
Client: Verwende die peekaboo-CLI (keine separate openclaw ui ...-Oberfläche).
UI: Visuelle Overlays bleiben in Peekaboo.app; OpenClaw ist ein schlanker Broker-Host.

Bridge aktivieren

In der macOS-App:

Einstellungen → Peekaboo Bridge aktivieren

Wenn aktiviert, startet OpenClaw einen lokalen UNIX-Socket-Server. Wenn deaktiviert, wird der Host gestoppt und peekaboo fällt auf andere verfügbare Hosts zurück.

Client-Discovery-Reihenfolge

Peekaboo-Clients versuchen Hosts typischerweise in dieser Reihenfolge:

Peekaboo.app (vollständige UX)
Claude.app (falls installiert)
OpenClaw.app (schlanker Broker)

Verwende peekaboo bridge status --verbose, um zu sehen, welcher Host aktiv ist und welcher Socket-Pfad verwendet wird. Du kannst überschreiben mit:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Sicherheit & Berechtigungen

Die Bridge validiert Aufrufer-Code-Signaturen; eine Allowlist von TeamIDs wird durchgesetzt (Peekaboo-Host-TeamID + OpenClaw-App-TeamID).
Anfragen laufen nach ~10 Sekunden ab.
Falls erforderliche Berechtigungen fehlen, gibt die Bridge eine klare Fehlermeldung zurück, anstatt die Systemeinstellungen zu öffnen.

Snapshot-Verhalten (Automatisierung)

Snapshots werden im Speicher gehalten und laufen nach einem kurzen Zeitfenster automatisch ab. Wenn du längere Aufbewahrung brauchst, erfasse erneut vom Client.

Fehlerbehebung

Falls peekaboo „bridge client is not authorized” meldet, stelle sicher, dass der Client ordnungsgemäß signiert ist, oder starte den Host mit PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 nur im Debug-Modus.
Falls keine Hosts gefunden werden, öffne eine der Host-Apps (Peekaboo.app oder OpenClaw.app) und bestätige, dass Berechtigungen erteilt sind.