UI-Automatisierung auf macOS mit Peekaboo Bridge

UI-Automatisierung auf macOS ist oft ein mühsames Unterfangen. Du kämpfst mit TCC-Berechtigungen, die ständig zurückgesetzt werden, oder mit Tools, die keinen direkten Zugriff auf die Oberfläche erlauben, ohne das System unsicher zu machen. Wenn du versuchst, Workflows zu automatisieren, landest du meist in einem Chaos aus verschiedenen Apps und Skripten, die nicht sauber miteinander kommunizieren.

Ich empfehle dir, OpenClaw als Broker für die Peekaboo Bridge zu nutzen. Das ist die beste Lösung, um die peekaboo CLI zu verwenden und gleichzeitig die bestehenden Berechtigungen der macOS App zu nutzen, ohne alles doppelt konfigurieren zu müssen.

Voraussetzungen

• OpenClaw.app (fungiert als Host)
• peekaboo CLI (als Client)
• macOS mit aktiven TCC-Berechtigungen
• Zugriff auf das Terminal

Schnellstart

OpenClaw agiert als schlanker Broker. So setzt du das System in unter fünf Minuten auf:

1. Öffne OpenClaw.app auf deinem Mac.
2. Gehe zu Settings → Enable Peekaboo Bridge. OpenClaw startet nun einen lokalen UNIX socket server.
3. Die peekaboo CLI erkennt den Host automatisch.
4. Prüfe die Verbindung mit diesem Befehl:

peekaboo bridge status --verbose

Falls du einen spezifischen Pfad für den Socket erzwingen möchtest, kannst du diese Umgebungsvariable nutzen:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Discovery Order

Die peekaboo CLI sucht in dieser Reihenfolge nach verfügbaren Hosts:

1. Peekaboo.app (voller Funktionsumfang)
2. Claude.app (falls installiert)
3. OpenClaw.app (als schlanker Broker)
4. Andere verfügbare Hosts

Security & Snapshots

Die Bridge prüft die Code-Signaturen aller Aufrufer. Es wird eine Allowlist von TeamIDs erzwungen (Peekaboo Host TeamID und OpenClaw App TeamID). Anfragen haben ein Zeitlimit von etwa 10 Sekunden. Snapshots werden nur im Arbeitsspeicher abgelegt und laufen nach kurzer Zeit automatisch ab. Wenn du Daten länger behalten willst, musst du sie über den Client erneut erfassen.

Fehlerbehebung

• Fehler “bridge client is not authorized”: Stelle sicher, dass dein Client korrekt signiert ist. Wenn du im debug Modus arbeitest, kannst du die Prüfung mit PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 umgehen.
• Keine Hosts gefunden: Öffne entweder OpenClaw.app oder Peekaboo.app. Kontrolliere in den macOS-Systemeinstellungen, ob die erforderlichen Berechtigungen für die App erteilt wurden.

AI Setup Assistant

Nächste Schritte

• Peekaboo CLI Dokumentation
• OpenClaw Konfigurations-Guide