Peekaboo Bridge (macOS-UI-Automatisierung)¶

OpenClaw kann PeekabooBridge als lokalen, berechtigungsbewussten Broker für UI-Automatisierung hosten. Dadurch kann die peekaboo CLI die UI-Automatisierung steuern und dabei die TCC-Berechtigungen der macOS-App wiederverwenden.

Was das ist (und was nicht)¶

Host: OpenClaw.app kann als PeekabooBridge-Host fungieren.
Client: Verwenden Sie die peekaboo CLI (keine separate openclaw ui ...-Oberfläche).
UI: Visuelle Overlays verbleiben 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 greift auf andere verfügbare Hosts zurück.

Reihenfolge der Client-Erkennung¶

Peekaboo-Clients versuchen Hosts typischerweise in dieser Reihenfolge:

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

Verwenden Sie peekaboo bridge status --verbose, um zu sehen, welcher Host aktiv ist und welcher Socket-Pfad verwendet wird. Sie können dies überschreiben mit:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Sicherheit & Berechtigungen¶

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

Snapshot-Verhalten (Automatisierung)¶

Snapshots werden im Speicher abgelegt und verfallen automatisch nach kurzer Zeit. Wenn Sie eine längere Aufbewahrung benötigen, erfassen Sie diese erneut vom Client aus.

Fehlerbehebung¶

Wenn peekaboo „bridge client is not authorized“ meldet, stellen Sie sicher, dass der Client korrekt signiert ist, oder führen Sie den Host mit PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 nur im Debug-Modus aus.
Wenn keine Hosts gefunden werden, öffnen Sie eine der Host-Apps (Peekaboo.app oder OpenClaw.app) und bestätigen Sie, dass die Berechtigungen erteilt sind.