> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Ponte cucù

OpenClaw può ospitare **PeekabooBridge** come broker locale di automazione dell'interfaccia utente consapevole delle autorizzazioni. Questo consente alla CLI `peekaboo` di pilotare l'automazione dell'interfaccia utente riutilizzando le autorizzazioni TCC dell'app macOS.

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

* **Host**: OpenClaw\.app può agire 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 leggero.

## Relazione con l'uso del computer

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

* **Host PeekabooBridge**: OpenClaw\.app può ospitare il socket PeekabooBridge locale. La CLI `peekaboo` resta il client e usa le autorizzazioni macOS di OpenClaw\.app per primitive di automazione Peekaboo come screenshot, clic, menu, finestre di dialogo, azioni Dock e gestione delle finestre.
* **Uso del computer Codex**: il plugin `codex` incluso prepara il server app Codex, verifica che il server MCP `computer-use` di Codex sia disponibile e poi lascia che Codex possieda le chiamate agli strumenti nativi di controllo del desktop durante i turni in modalità Codex. OpenClaw non inoltra quelle azioni tramite PeekabooBridge.
* **MCP diretto `cua-driver`**: OpenClaw può registrare il server upstream `cua-driver mcp` 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 passare dal marketplace Codex o dal socket PeekabooBridge.

Usa Peekaboo quando vuoi l'ampia superficie di automazione macOS e l'host bridge consapevole delle autorizzazioni di OpenClaw\.app. Usa l'uso del computer Codex quando un agente in modalità Codex deve basarsi sul plugin nativo di uso del computer di Codex. 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` userà come fallback altri host disponibili.

## Ordine di rilevamento del 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 leggero)

Usa `peekaboo bridge status --verbose` per vedere quale host è attivo e quale percorso socket è in uso. Puoi sovrascriverlo con:

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
export PEEKABOO_BRIDGE_SOCKET=/path/to/bridge.sock
```

## Sicurezza e autorizzazioni

* Il bridge convalida le **firme del codice del chiamante**; viene applicata una allowlist di TeamID (TeamID dell'host Peekaboo + TeamID dell'app OpenClaw).
* Preferisci l'identità firmata del bridge/app rispetto a un runtime `node` generico per Accessibilità. Concedere Accessibilità a `node` consente a qualsiasi pacchetto avviato da quell'eseguibile Node di ereditare l'accesso all'automazione della GUI; vedi [autorizzazioni macOS](/it/platforms/mac/permissions#accessibility-grants-for-node-and-cli-runtimes).
* Le richieste scadono dopo circa 10 secondi.
* Se mancano autorizzazioni richieste, il bridge restituisce un messaggio di errore chiaro invece di avviare Impostazioni di Sistema.

## Comportamento degli snapshot (automazione)

Gli snapshot vengono archiviati in memoria e scadono automaticamente dopo una breve finestra temporale. Se hai bisogno di conservarli più a lungo, acquisiscili di nuovo dal client.

## Risoluzione dei problemi

* Se `peekaboo` segnala "il client bridge non è autorizzato", assicurati che il client sia firmato correttamente oppure esegui l'host con `PEEKABOO_ALLOW_UNSIGNED_SOCKET_CLIENTS=1` solo in modalità **debug**.
* Se non viene trovato alcun host, apri una delle app host (Peekaboo.app o OpenClaw\.app) e conferma che le autorizzazioni siano state concesse.

## Correlati

* [app macOS](/it/platforms/macos)
* [autorizzazioni macOS](/it/platforms/mac/permissions)