Peekaboo-Brücke

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 dies 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 bleiben in Peekaboo.app; OpenClaw ist ein schlanker Broker-Host.

# Verhältnis 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 nutzt 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, ob Codex’ computer-use MCP-Server verfügbar ist, und lässt dann Codex während Durchläufen im Codex-Modus native Tool-Aufrufe zur Desktop-Steuerung übernehmen. OpenClaw leitet diese Aktionen nicht über PeekabooBridge weiter.
• Direktes cua-driver MCP: OpenClaw kann TryCuas Upstream-Server cua-driver mcp als normalen MCP-Server registrieren. Dadurch erhalten Agenten die eigenen Schemas des CUA-Treibers und den PID-/Fenster-/Elementindex-Workflow, ohne über den Codex Marketplace 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 Codex’ natives Computer-Use-Plugin stützen soll. Verwenden Sie direktes cua-driver mcp, wenn Sie den CUA-Treiber für jede von OpenClaw verwaltete Runtime als normalen MCP-Server verfügbar machen 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:

1. Peekaboo.app (vollständige UX)
2. Claude.app (falls installiert)
3. 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 und Berechtigungen

• Die Bridge validiert Code-Signaturen des Aufrufers; eine Allowlist von TeamIDs wird erzwungen (Peekaboo-Host-TeamID + OpenClaw-App-TeamID).
• Anfragen laufen nach etwa 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 den Snapshot erneut vom Client aus.

# Fehlerbehebung

• Wenn peekaboo meldet: „bridge client is not authorized“, stellen Sie sicher, dass der Client ordnungsgemäß 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 die Berechtigungen erteilt wurden.

# Verwandte Themen

• macOS-App
• macOS-Berechtigungen