Ponte Peekaboo

OpenClaw può ospitare PeekabooBridge come broker locale di automazione dell'interfaccia utente, consapevole dei permessi. Questo permette alla CLI peekaboo di pilotare l'automazione dell'interfaccia utente riutilizzando i permessi TCC dell'app macOS.

# Che cos'è (e che cosa non è)

• Host: OpenClaw.app può fungere da host PeekabooBridge.
• Client: usa la CLI peekaboo (nessuna superficie openclaw ui ... separata).
• UI: gli overlay visivi restano in Peekaboo.app; OpenClaw è un host broker sottile.

# Relazione con Computer Use

OpenClaw ha tre percorsi di controllo desktop, e restano intenzionalmente separati:

• Host PeekabooBridge: OpenClaw.app può ospitare il socket locale PeekabooBridge. La CLI peekaboo resta il client e usa i permessi macOS di OpenClaw.app per le primitive di automazione Peekaboo come screenshot, clic, menu, finestre di dialogo, azioni del Dock e gestione delle finestre.
• Codex Computer Use: il Plugin codex incluso prepara il server dell'app Codex, verifica che il server MCP computer-use di Codex sia disponibile, e quindi consente a Codex di possedere le chiamate agli strumenti nativi di controllo desktop durante i turni in modalità Codex. OpenClaw non inoltra tali azioni tramite PeekabooBridge.
• MCP cua-driver diretto: OpenClaw può registrare il server cua-driver mcp upstream di TryCua come normale server MCP. Questo fornisce agli agenti gli schemi propri del driver CUA e il flusso di lavoro pid/finestra/indice-elemento senza instradare tramite il marketplace Codex o il socket PeekabooBridge.

Usa Peekaboo quando vuoi l'ampia superficie di automazione macOS e l'host bridge di OpenClaw.app consapevole dei permessi. Usa Codex Computer Use quando un agente in modalità Codex deve affidarsi al Plugin nativo di Codex per computer-use. Usa cua-driver mcp diretto quando vuoi esporre il driver CUA a qualsiasi runtime gestito da OpenClaw come normale server MCP.

# Abilitare il bridge

Nell'app macOS:

• Impostazioni → Abilita Peekaboo Bridge

Quando è abilitato, OpenClaw avvia un server socket UNIX locale. Se è disabilitato, l'host viene arrestato e peekaboo ripiegherà su altri host disponibili.

# Ordine di rilevamento dei client

I client Peekaboo in genere provano gli host in questo ordine:

1. Peekaboo.app (UX completa)
2. Claude.app (se installata)
3. OpenClaw.app (broker sottile)

Usa peekaboo bridge status --verbose per vedere quale host è attivo e quale percorso del socket è in uso. Puoi eseguire l'override con:

export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock

# Sicurezza e permessi

• Il bridge convalida le firme del codice del chiamante; viene applicata una allowlist di TeamID (TeamID dell'host Peekaboo + TeamID dell'app OpenClaw).
• Le richieste scadono dopo circa 10 secondi.
• Se mancano i permessi richiesti, il bridge restituisce un messaggio di errore chiaro invece di avviare Impostazioni di Sistema.

# Comportamento degli snapshot (automazione)

Gli snapshot sono archiviati in memoria e scadono automaticamente dopo una breve finestra. Se hai bisogno di una conservazione più lunga, acquisiscili di nuovo dal client.

# Risoluzione dei problemi

• Se peekaboo segnala "bridge client is not authorized", assicurati che il client sia firmato correttamente oppure esegui l'host con PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1 solo in modalità debug.
• Se non vengono trovati host, apri una delle app host (Peekaboo.app o OpenClaw.app) e conferma che i permessi siano concessi.

# Correlati

• app macOS
• permessi macOS