Peekaboo Bridge (macOS UI-Automatisierung)

OpenClaw kann PeekabooBridge als lokalen, berechtigungsbasierten UI-Automatisierungs-Broker hosten. Damit kann das 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: Nutze das peekaboo CLI (keine separate openclaw ui ... Oberfläche).
  • UI: Visuelle Overlays bleiben in Peekaboo.app; OpenClaw ist nur ein schlanker Broker-Host.

Bridge aktivieren

In der macOS-App:

  • Settings → Enable Peekaboo Bridge

Wenn aktiviert, startet OpenClaw einen lokalen UNIX-Socket-Server. Bei Deaktivierung wird der Host gestoppt und peekaboo greift auf andere verfügbare Hosts zurück.

Client-Discovery-Reihenfolge

Peekaboo-Clients versuchen Hosts normalerweise in dieser Reihenfolge:

  1. Peekaboo.app (volle UX)
  2. Claude.app (falls installiert)
  3. OpenClaw.app (schlanker Broker)

Mit peekaboo bridge status --verbose siehst du, welcher Host aktiv ist und welcher Socket-Pfad verwendet wird. Du kannst das ü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 laufen automatisch nach kurzer Zeit ab. Wenn du sie länger behalten willst, erstelle sie vom Client aus neu.

Troubleshooting

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