Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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