Uso del computer di Codex

Computer Use è un Plugin MCP nativo di Codex per il controllo del desktop locale. OpenClaw non include l’app desktop come vendor, non esegue direttamente azioni desktop e non elude le autorizzazioni di Codex. Il Plugin codex incluso prepara solo Codex app-server: abilita il supporto ai Plugin di Codex, trova o installa il Plugin Codex Computer Use configurato, verifica che il server MCP computer-use sia disponibile e poi lascia a Codex la gestione delle chiamate native agli strumenti MCP durante i turni in modalità Codex. Usa questa pagina quando OpenClaw usa già l’harness nativo di Codex. Per la configurazione del runtime stesso, consulta harness Codex.

OpenClaw.app e Peekaboo

L’integrazione Peekaboo di OpenClaw.app è separata da Codex Computer Use. L’app macOS può ospitare un socket PeekabooBridge in modo che la CLI peekaboo possa riutilizzare le autorizzazioni locali dell’app per Accessibilità e Registrazione schermo per gli strumenti di automazione propri di Peekaboo. Quel bridge non installa né fa da proxy a Codex Computer Use, e Codex Computer Use non passa attraverso il socket PeekabooBridge. Usa bridge Peekaboo quando vuoi che OpenClaw.app sia un host consapevole delle autorizzazioni per l’automazione della CLI Peekaboo. Usa questa pagina quando un agente OpenClaw in modalità Codex deve avere disponibile il Plugin MCP computer-use nativo di Codex prima dell’inizio del turno.

App iOS

L’app iOS è separata da Codex Computer Use. Non installa né fa da proxy al server MCP computer-use di Codex e non è un backend di controllo desktop. Invece, l’app iOS si connette come nodo OpenClaw ed espone capacità mobili tramite comandi del nodo come canvas.*, camera.*, screen.*, location.* e talk.*. Usa iOS quando vuoi che un agente controlli un nodo iPhone tramite il Gateway. Usa questa pagina quando un agente in modalità Codex deve controllare il desktop macOS locale tramite il Plugin Computer Use nativo di Codex.

MCP diretto di cua-driver

Codex Computer Use non è l’unico modo per esporre il controllo del desktop. Se vuoi che i runtime gestiti da OpenClaw chiamino direttamente il driver di TryCua, usa il server upstream cua-driver mcp tramite il registro MCP di OpenClaw invece del flusso marketplace specifico di Codex. Dopo aver installato cua-driver, chiedigli il comando OpenClaw:

cua-driver mcp-config --client openclaw

oppure registra tu stesso il server stdio:

openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'

Questo percorso mantiene intatta la superficie degli strumenti MCP upstream, inclusi gli schemi del driver e le risposte MCP strutturate. Usalo quando vuoi che il driver CUA sia disponibile come normale server MCP di OpenClaw. Usa la configurazione Codex Computer Use in questa pagina quando Codex app-server deve gestire installazione dei Plugin, ricaricamenti MCP e chiamate native agli strumenti nei turni in modalità Codex. Il driver CUA è specifico per macOS e richiede comunque le autorizzazioni locali di macOS richieste dalla sua app, come Accessibilità e Registrazione schermo. OpenClaw non installa cua-driver, non concede tali autorizzazioni e non elude il modello di sicurezza del driver upstream.

Configurazione rapida

Imposta plugins.entries.codex.config.computerUse quando i turni in modalità Codex devono avere Computer Use disponibile prima dell’avvio di un thread:

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
        config: {
          computerUse: {
            autoInstall: true,
          },
        },
      },
    },
  },
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

Con questa configurazione, OpenClaw controlla Codex app-server prima di ogni turno in modalità Codex. Se Computer Use manca ma Codex app-server ha già individuato un marketplace installabile, OpenClaw chiede a Codex app-server di installare o riabilitare il Plugin e ricaricare i server MCP. Su macOS, quando non è registrato alcun marketplace corrispondente ed esiste il bundle standard dell’app Codex, OpenClaw prova anche a registrare il marketplace Codex incluso da /Applications/Codex.app/Contents/Resources/plugins/openai-bundled prima di fallire. Se la configurazione non riesce comunque a rendere disponibile il server MCP, il turno fallisce prima dell’avvio del thread. Dopo aver modificato la configurazione di Computer Use, usa /new o /reset nella chat interessata prima di testare, se un thread Codex esistente è già stato avviato.

Comandi

Usa i comandi /codex computer-use da qualsiasi superficie di chat in cui sia disponibile la superficie dei comandi del Plugin codex. Questi sono comandi chat/runtime di OpenClaw, non sottocomandi CLI openclaw codex ...:

/codex computer-use status
/codex computer-use install
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>
/codex computer-use install --marketplace <name>

status è di sola lettura. Non aggiunge sorgenti marketplace, non installa Plugin e non abilita il supporto ai Plugin di Codex. install abilita il supporto ai Plugin di Codex app-server, aggiunge facoltativamente una sorgente marketplace configurata, installa o riabilita il Plugin configurato tramite Codex app-server, ricarica i server MCP e verifica che il server MCP esponga strumenti.

Scelte del marketplace

OpenClaw usa la stessa API app-server esposta da Codex stesso. I campi marketplace scelgono dove Codex deve trovare computer-use.

Campo	Da usare quando	Supporto installazione
Nessun campo marketplace	Vuoi che Codex app-server usi marketplace che conosce già.	Sì, quando app-server restituisce un marketplace locale.
`marketplaceSource`	Hai una sorgente marketplace Codex che app-server può aggiungere.	Sì, per `/codex computer-use install` esplicito.
`marketplacePath`	Conosci già il percorso file del marketplace locale sull’host.	Sì, per installazione esplicita e installazione automatica all’avvio del turno.
`marketplaceName`	Vuoi selezionare per nome un marketplace già registrato.	Sì, solo quando il marketplace selezionato ha un percorso locale.

Le nuove home Codex possono richiedere un breve momento per inizializzare i loro marketplace ufficiali. Durante l’installazione, OpenClaw interroga plugin/list fino a marketplaceDiscoveryTimeoutMs millisecondi. Il valore predefinito è 60 secondi. Se più marketplace noti contengono Computer Use, OpenClaw preferisce openai-bundled, poi openai-curated, poi local. Le corrispondenze ambigue sconosciute falliscono in modo chiuso e chiedono di impostare marketplaceName o marketplacePath.

Marketplace macOS incluso

Le build desktop recenti di Codex includono Computer Use qui:

/Applications/Codex.app/Contents/Resources/plugins/openai-bundled/plugins/computer-use

Quando computerUse.autoInstall è true e non è registrato alcun marketplace contenente computer-use, OpenClaw prova ad aggiungere automaticamente la radice del marketplace standard incluso:

/Applications/Codex.app/Contents/Resources/plugins/openai-bundled

Puoi anche registrarlo esplicitamente da una shell con Codex:

codex plugin marketplace add /Applications/Codex.app/Contents/Resources/plugins/openai-bundled

Se usi un percorso non standard dell’app Codex, imposta computerUse.marketplacePath su un percorso file di marketplace locale oppure esegui una volta /codex computer-use install --source <marketplace-source>.

Limite del catalogo remoto

Codex app-server può elencare e leggere voci di catalogo solo remote, ma al momento non supporta plugin/install remoto. Ciò significa che marketplaceName può selezionare un marketplace solo remoto per i controlli di stato, ma installazioni e riabilitazioni richiedono comunque un marketplace locale tramite marketplaceSource o marketplacePath. Se lo stato indica che il Plugin è disponibile in un marketplace remoto di Codex ma l’installazione remota non è supportata, esegui l’installazione con una sorgente o un percorso locale:

/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>

Riferimento configurazione

Campo	Predefinito	Significato
`enabled`	inferred	Richiede Computer Use. Il valore predefinito è true quando è impostato un altro campo Computer Use.
`autoInstall`	false	Installa o riabilita dai marketplace già individuati all’avvio del turno.
`marketplaceDiscoveryTimeoutMs`	60000	Per quanto tempo l’installazione attende la scoperta dei marketplace da parte di Codex app-server.
`marketplaceSource`	unset	Stringa sorgente passata a `marketplace/add` di Codex app-server.
`marketplacePath`	unset	Percorso file del marketplace locale di Codex che contiene il Plugin.
`marketplaceName`	unset	Nome del marketplace Codex registrato da selezionare.
`pluginName`	`computer-use`	Nome del Plugin del marketplace Codex.
`mcpServerName`	`computer-use`	Nome del server MCP esposto dal Plugin installato.

L’installazione automatica all’avvio del turno rifiuta intenzionalmente i valori marketplaceSource configurati. Aggiungere una nuova sorgente è un’operazione di configurazione esplicita, quindi usa una volta /codex computer-use install --source <marketplace-source>, poi lascia che autoInstall gestisca le riabilitazioni future dai marketplace locali individuati. L’installazione automatica all’avvio del turno può usare un marketplacePath configurato, perché è già un percorso locale sull’host.

Cosa controlla OpenClaw

OpenClaw riporta internamente un motivo di configurazione stabile e formatta lo stato visibile all’utente per la chat:

Motivo	Significato	Passaggio successivo
`disabled`	`computerUse.enabled` si è risolto in false.	Imposta `enabled` o un altro campo Computer Use.
`marketplace_missing`	Nessun marketplace corrispondente era disponibile.	Configura sorgente, percorso o nome marketplace.
`plugin_not_installed`	Il marketplace esiste, ma il Plugin non è installato.	Esegui install o abilita `autoInstall`.
`plugin_disabled`	Il Plugin è installato ma disabilitato nella configurazione di Codex.	Esegui install per riabilitarlo.
`remote_install_unsupported`	Il marketplace selezionato è solo remoto.	Usa `marketplaceSource` o `marketplacePath`.
`mcp_missing`	Il Plugin è abilitato, ma il server MCP non è disponibile.	Controlla Codex Computer Use e le autorizzazioni del sistema operativo.
`ready`	Il Plugin e gli strumenti MCP sono disponibili.	Avvia il turno in modalità Codex.
`check_failed`	Una richiesta a Codex app-server non è riuscita durante il controllo dello stato.	Controlla connettività e log di app-server.
`auto_install_blocked`	La configurazione all’avvio del turno dovrebbe aggiungere una nuova sorgente.	Esegui prima l’installazione esplicita.

L’output della chat include lo stato del Plugin, lo stato del server MCP, il marketplace, gli strumenti quando disponibili e il messaggio specifico per il passaggio di configurazione non riuscito.

Autorizzazioni macOS

Computer Use è specifico per macOS. Il server MCP gestito da Codex potrebbe richiedere autorizzazioni locali del sistema operativo prima di poter ispezionare o controllare app. Se OpenClaw indica che Computer Use è installato ma il server MCP non è disponibile, verifica prima la configurazione di Computer Use lato Codex:

Codex app-server è in esecuzione sullo stesso host in cui deve avvenire il controllo del desktop.
Il plugin Computer Use è abilitato nella configurazione di Codex.
Il server MCP computer-use appare nello stato MCP di Codex app-server.
macOS ha concesso le autorizzazioni richieste per l’app di controllo del desktop.
La sessione host corrente può accedere al desktop controllato.

OpenClaw intenzionalmente fallisce in modo chiuso quando computerUse.enabled è true. Un turno in modalità Codex non deve procedere silenziosamente senza gli strumenti desktop nativi richiesti dalla configurazione.

Risoluzione dei problemi

Lo stato indica che non è installato. Esegui /codex computer-use install. Se il marketplace non viene rilevato, passa --source o --marketplace-path. Lo stato indica che è installato ma disabilitato. Esegui di nuovo /codex computer-use install. L’installazione di Codex app-server riscrive la configurazione del plugin come abilitata. Lo stato indica che l’installazione remota non è supportata. Usa una sorgente o un percorso marketplace locale. Le voci di catalogo solo remote possono essere ispezionate ma non installate tramite l’ API app-server corrente. Lo stato indica che il server MCP non è disponibile. Riesegui l’installazione una volta affinché i server MCP vengano ricaricati. Se rimane non disponibile, correggi l’app Codex Computer Use, lo stato MCP di Codex app-server o le autorizzazioni di macOS. Lo stato o un probe va in timeout su computer-use.list_apps. Il plugin e il server MCP sono presenti, ma il bridge locale di Computer Use non ha risposto. Chiudi o riavvia Codex Computer Use, rilancia Codex Desktop se necessario, poi riprova in una nuova sessione OpenClaw. Uno strumento Computer Use indica Native hook relay unavailable. L’hook dello strumento nativo di Codex non è riuscito a raggiungere un relay OpenClaw attivo tramite il bridge locale o il fallback del Gateway. Avvia una nuova sessione OpenClaw con /new o /reset. Se continua a succedere, riavvia il gateway in modo che i vecchi thread di app-server e le registrazioni degli hook vengano eliminati, poi riprova. L’installazione automatica all’inizio del turno rifiuta una sorgente. È intenzionale. Aggiungi prima la sorgente con /codex computer-use install --source <marketplace-source> esplicito, poi le future installazioni automatiche all’inizio del turno potranno usare il marketplace locale rilevato.

Documentation Index

​OpenClaw.app e Peekaboo

​App iOS

​MCP diretto di cua-driver

​Configurazione rapida

​Comandi

​Scelte del marketplace

​Marketplace macOS incluso

​Limite del catalogo remoto

​Riferimento configurazione

​Cosa controlla OpenClaw

​Autorizzazioni macOS

​Risoluzione dei problemi

​Correlati