macOS companion app

Peekaboo-Brücke

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

Was dies ist (und was nicht)

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

Beziehung zu Computer Use

OpenClaw hat drei Pfade zur Desktop-Steuerung, die bewusst getrennt bleiben:

PeekabooBridge-Host: OpenClaw.app kann den lokalen PeekabooBridge-Socket hosten. Die peekaboo-CLI bleibt der Client und verwendet die macOS-Berechtigungen von OpenClaw.app für Peekaboo-Automatisierungsprimitive wie Screenshots, Klicks, Menüs, Dialoge, Dock-Aktionen und Fensterverwaltung.
Codex Computer Use: Das gebündelte codex-Plugin bereitet den Codex-App-Server vor, überprüft, dass der MCP-Server computer-use von Codex verfügbar ist, und lässt dann Codex während Turns im Codex-Modus native Tool-Aufrufe zur Desktop-Steuerung übernehmen. OpenClaw leitet diese Aktionen nicht über PeekabooBridge weiter.
Direktes cua-driver-MCP: OpenClaw kann den Upstream-Server cua-driver mcp von TryCua als normalen MCP-Server registrieren. Dadurch erhalten Agenten die eigenen Schemas und den pid/Fenster/Elementindex-Workflow des CUA-Treibers, ohne über den Codex-Marktplatz oder den PeekabooBridge-Socket zu routen.

Verwenden Sie Peekaboo, wenn Sie die breite macOS-Automatisierungsoberfläche und den berechtigungsbewussten Bridge-Host von OpenClaw.app benötigen. Verwenden Sie Codex Computer Use, wenn ein Agent im Codex-Modus sich auf das native Computer-Use-Plugin von Codex stützen soll. Verwenden Sie direktes cua-driver mcp, wenn Sie den CUA-Treiber jeder von OpenClaw verwalteten Runtime als normalen MCP-Server bereitstellen möchten.

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-Erkennungsreihenfolge

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:

bash

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

Sicherheit und Berechtigungen

Die Bridge validiert Code-Signaturen der Aufrufer; eine Zulassungsliste von TeamIDs wird durchgesetzt (Peekaboo-Host-TeamID + OpenClaw-App-TeamID).
Bevorzugen Sie für Bedienungshilfen die signierte Bridge-/App-Identität gegenüber einer generischen node-Runtime. Wenn Sie node Bedienungshilfen gewähren, kann jedes Paket, das von dieser Node-Ausführungsdatei gestartet wird, GUI-Automatisierungszugriff erben; siehe macOS-Berechtigungen.
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 Arbeitsspeicher gespeichert und laufen nach einem kurzen Zeitraum automatisch ab. Wenn Sie eine längere Aufbewahrung benötigen, erfassen Sie sie erneut vom Client aus.

Fehlerbehebung

Wenn peekaboo meldet, dass der „Bridge-Client nicht autorisiert ist“, stellen Sie sicher, dass der Client korrekt signiert ist, oder führen Sie den Host nur im Debug-Modus mit PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 aus.
Wenn keine Hosts gefunden werden, öffnen Sie eine der Host-Apps (Peekaboo.app oder OpenClaw.app) und bestätigen Sie, dass Berechtigungen gewährt wurden.

Verwandt

Was this useful?