Codex Computer Use

Computer Use est un plugin MCP natif de Codex pour le contrôle du bureau local. OpenClaw ne fournit pas l’application de bureau, n’exécute pas d’actions de bureau lui-même et ne contourne pas les autorisations de Codex. Le plugin inclus OpenClawcodex prépare uniquement le serveur d’application Codex : il active la prise en charge des plugins Codex, trouve ou installe le plugin configuré Codex Computer Use, vérifie que le serveur MCP computer-use est disponible, et permet ensuite à Codex de posséder les appels d’outils MCP natifs lors des tours en mode Codex.

Utilisez cette page lorsque OpenClaw utilise déjà le harnais natif Codex. Pour la configuration d’exécution elle-même, voir Codex harness.

OpenClaw.app et Peekaboo

L’intégration Peekaboo d’OpenClaw.app est distincte de Codex Computer Use. L’application macOS peut héberger un socket PeekabooBridge afin que la CLI OpenClawPeekaboomacOSpeekabooCLIPeekaboo puisse réutiliser les autorisations locales d’accessibilité et d’enregistrement d’écran de l’application pour les propres outils d’automatisation de Peekaboo. Ce pont n’installe ni ne mandate Codex Computer Use, et Codex Computer Use n’appelle pas via le socket PeekabooBridge.

Utilisez Peekaboo bridge lorsque vous souhaitez que OpenClaw.app soit un hôte tenant compte des permissions pour l’automatisation Peekaboo CLI. Utilisez cette page lorsqu’un agent OpenClaw en mode Codex doit disposer du plugin MCP computer-use natif de Codex avant le début du tour.

Application iOS

L’application iOS est distincte de Codex Computer Use. Elle n’installe pas ni ne met en proxy le serveur MCP computer-use de Codex et ce n’est pas un backend de contrôle de bureau. Au lieu de cela, l’application iOS se connecte en tant que nœud OpenClaw et expose des capacités mobiles via des commandes de nœud telles que canvas.*, camera.*, screen.*, location.* et talk.*.

Utilisez iOS lorsque vous souhaitez qu’un agent pilote un nœud iPhone via la passerelle. Utilisez cette page lorsqu’un agent en mode Codex doit contrôler le bureau macOS local via le plugin Computer Use natif de Codex.

MCP cua-driver direct

Codex Computer Use n’est pas le seul moyen d’exposer le contrôle du bureau. Si vous souhaitez que les runtimes gérés par OpenClaw appellent directement le pilote de TryCua, utilisez le serveur cua-driver mcp en amont via le registre MCP de OpenClaw au lieu du flux spécifique à la marketplace Codex.

Après avoir installé cua-driver, demandez-lui la commande OpenClaw :

cua-driver mcp-config --client openclaw

ou enregistrez le serveur stdio vous-même :

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

Ce chemin maintient la surface de l’outil MCP en amont intacte, y compris les schémas du pilote et les réponses MCP structurées. Utilisez-le lorsque vous souhaitez que le pilote CUA soit disponible en tant que serveur MCP OpenClaw normal. Utilisez la configuration Codex Computer Use sur cette page lorsque le serveur d’application Codex doit posséder l’installation du plugin, les rechargements MCP et les appels d’outils natifs au sein des tours en mode Codex.

Le pilote de CUA est spécifique à macOS et nécessite toujours les autorisations macOS locales que son application demande, telles que l’accessibilité et l’enregistrement d’écran. OpenClaw n’installe pas cua-driver, n’accorde pas ces autorisations et ne contourne pas le modèle de sécurité du pilote en amont.

Configuration rapide

Définissez plugins.entries.codex.config.computerUse lorsque les tours en mode Codex doivent disposer de Computer Use avant le début d’un fil. autoInstall: true active Computer Use et laisse OpenClaw l’installer ou le réactiver avant le tour :

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

Avec cette configuration, OpenClaw vérifie le serveur d’application Codex avant chaque tour en mode Codex. Si Computer Use est manquant mais que le serveur d’application Codex a déjà découvert une place de marché installable, OpenClaw demande au serveur d’application Codex d’installer ou de réactiver le plugin et de recharger les serveurs MCP. Sur macOS, lorsqu’aucune place de marché correspondante n’est enregistrée et que le bundle d’application Codex standard existe, OpenClaw essaie également d’enregistrer la place de marché Codex fournie depuis /Applications/Codex.app/Contents/Resources/plugins/openai-bundled avant d’échouer. Si la configuration ne parvient toujours pas à rendre le serveur MCP disponible, le tour échoue avant le début du fil.

Après avoir modifié la configuration de Computer Use, utilisez /new ou /reset dans le chat affecté avant de tester si un fil Codex existant a déjà commencé.

Commandes

Utilisez les commandes /codex computer-use depuis n’importe quelle surface de chat où la surface de commande de plugin codex est disponible. Ce sont des commandes de chat/exécution OpenClaw, et non des sous-commandes 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 est en lecture seule. Il n’ajoute pas de sources de marketplace, n’installe pas de plugins ou n’active pas la prise en charge des plugins Codex. Si aucune configuration n’active l’Utilisation de l’ordinateur (Computer Use), status peut indiquer désactivé même après une commande d’installation ponctuelle.

install active la prise en charge des plugins du serveur d’application Codex, ajoute facultativement une source de marketplace configurée, installe ou réactive le plugin configuré via le serveur d’application Codex, recharge les serveurs MCP et vérifie que le serveur MCP expose des outils.

Choix de la place de marché

OpenClawAPI utilise la même API de serveur d’application que celle exposée par Codex lui-même. Les champs de marketplace choisissent où Codex doit trouver computer-use.

Champ	À utiliser quand	Support d’installation
Aucun champ de place de marché	Vous voulez que le serveur d’application Codex utilise les places de marché qu’il connaît déjà.	Oui, lorsque le serveur d’application renvoie une place de marché locale.
`marketplaceSource`	Vous disposez d’une source de place de marché Codex que le serveur d’application peut ajouter.	Oui, pour `/codex computer-use install` explicite.
`marketplacePath`	Vous connaissez déjà le chemin du fichier local de la place de marché sur l’hôte.	Oui, pour l’installation explicite et l’auto-installation au début du tour.
`marketplaceName`	Vous souhaitez sélectionner une marketplace déjà enregistrée par son nom.	Oui uniquement si la marketplace sélectionnée dispose d’un chemin local.

Les nouveaux espaces Codex peuvent avoir besoin d’un court instant pour alimenter leurs marketplaces officielles. Pendant l’installation, OpenClaw interroge plugin/list pendant jusqu’à marketplaceDiscoveryTimeoutMs millisecondes. La valeur par défaut est 60 secondes.

Si plusieurs marketplaces connues contiennent l’Utilisation de l’ordinateur (Computer Use), OpenClaw préfère openai-bundled, puis openai-curated, puis local. Les correspondances ambiguës inconnues échouent de manière fermée et vous demandent de définir marketplaceName ou marketplacePath.

Marketplace macOS groupée

Les versions récentes du bureau Codex incluent Computer Use ici :

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

Lorsque computerUse.autoInstall est vrai et qu’aucune marketplace contenant computer-use n’est enregistrée, OpenClaw tente d’ajouter automatiquement la racine de marketplace groupée standard :

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

Vous pouvez également l’enregistrer explicitement depuis un shell avec Codex :

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

Si vous utilisez un chemin d’application Codex non standard, exécutez /codex computer-use install --source <marketplace-root> once or set computerUse.marketplacePath vers un chemin de fichier de marketplace local. Utilisez --marketplace-path uniquement lorsque vous disposez du chemin du fichier JSON de la marketplace, et non de la racine de la marketplace groupée.

Limite du catalogue distant

Codex app-server peut lister et lire les entrées de catalogue distantes uniquement, mais il ne prend pas actuellement en charge les plugin/install à distance. Cela signifie que marketplaceName peut sélectionner une place de marché distante uniquement pour les vérifications de statut, mais les installations et les réactivations nécessitent toujours une place de marché locale via marketplaceSource ou marketplacePath.

Si le statut indique que le plugin est disponible dans une marketplace Codex distante mais que l’installation distance n’est pas prise en charge, exécutez l’installation avec une source ou un chemin local :

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

Référence de configuration

Champ	Par défaut	Signification
`enabled`	déduit	Exiger Computer Use. Vrai par défaut lorsqu’un autre champ Computer Use est défini.
`autoInstall`	faux	Installer ou réactiver à partir des marketplaces déjà découvertes au début du tour.
`marketplaceDiscoveryTimeoutMs`	60000	Durée d’attente de l’installation pour la découverte de la marketplace par le serveur d’application Codex.
`marketplaceSource`	unset	Chaîne source transmise à Codex app-server `marketplace/add`.
`marketplacePath`	unset	Chemin d’accès au fichier local du marketplace Codex contenant le plugin.
`marketplaceName`	unset	Nom du marketplace Codex enregistré à sélectionner.
`pluginName`	`computer-use`	Nom du plugin du marketplace Codex.
`mcpServerName`	`computer-use`	Nom du serveur MCP exposé par le plugin installé.

L’auto-installation au début du tour refuse intentionnellement les valeurs configurées marketplaceSource. L’ajout d’une nouvelle source est une opération de configuration explicite, utilisez donc /codex computer-use install --source <marketplace-source> une fois, puis laissez autoInstall gérer les réactivations futures à partir des places de marché locales découvertes. L’auto-installation au début du tour peut utiliser un marketplacePath configuré, car il s’agit déjà d’un chemin local sur l’hôte.

Ce que OpenClaw vérifie

OpenClaw signale en interne une raison de configuration stable et formate le statut visible par l’utilisateur pour le chat :

Raison	Signification	Étape suivante
`disabled`	`computerUse.enabled` résolu à false.	Définissez `enabled` ou un autre champ Computer Use.
`marketplace_missing`	Aucun marketplace correspondant n’était disponible.	Configurez la source, le chemin ou le nom du marketplace.
`plugin_not_installed`	Le marketplace existe, mais le plugin n’est pas installé.	Exécutez install ou enable `autoInstall`.
`plugin_disabled`	Le plugin est installé mais désactivé dans la configuration Codex.	Exécutez l’installation pour le réactiver.
`remote_install_unsupported`	Le marketplace sélectionné est uniquement à distance.	Utilisez `marketplaceSource` ou `marketplacePath`.
`mcp_missing`	Le plugin est activé, mais le serveur MCP est indisponible.	Vérifiez les autorisations Codex Computer Use et du système d’exploitation.
`ready`	Le plugin et les outils MCP sont disponibles.	Démarrez le tour en mode Codex.
`check_failed`	Une requête au serveur d’application Codex a échoué lors de la vérification du statut.	Vérifiez la connectivité et les journaux du serveur d’application.
`auto_install_blocked`	La configuration au début du tour devrait avoir besoin d’ajouter une nouvelle source.	Exécutez d’abord l’installation explicite.

La sortie du chat inclut l’état du plugin, l’état du serveur MCP, la place de marché, les outils lorsqu’ils sont disponibles, et le message spécifique pour l’étape de configuration en échec.

macOS permissions

Computer Use est spécifique à macOS. Le serveur MCP appartenant à Codex peut avoir besoin d’autorisations du système d’exploitation local avant de pouvoir inspecter ou contrôler des applications. Si OpenClaw indique que Computer Use est installé mais que le serveur MCP n’est pas disponible, vérifiez d’abord la configuration Computer Use côté Codex :

Codex app-server est exécuté sur le même hôte où le contrôle du bureau doit avoir lieu.
Le plugin Computer Use est activé dans la configuration Codex.
Le serveur MCP computer-use apparaît dans le statut MCP de Codex app-server.
macOS a accordé les autorisations requises pour l’application de contrôle du bureau.
La session hôte actuelle peut accéder au bureau en cours de contrôle.

OpenClaw échoue intentionnellement de manière sécurisée lorsque OpenClawcomputerUse.enabled est vrai. Un tour en mode Codex ne doit pas continuer silencieusement sans les outils de bureau natifs exigés par la configuration.

Dépannage

Le statut indique non installé. Exécutez /codex computer-use install. Si la marketplace n’est pas détectée, passez --source ou --marketplace-path.

Le statut indique installé mais désactivé. Exécutez /codex computer-use install à nouveau. L’installation du Codex app-server réécrit la configuration du plugin pour l’activer.

Le statut indique que l’installation à distance n’est pas prise en charge. Utilisez une source ou un chemin de place de marché local. Les entrées de catalogue uniquement à distance peuvent être inspectées mais pas installées via l’API de l’application serveur actuelle.

Le statut indique que le serveur MCP n’est pas disponible. Réexécutez l’installation une fois pour que les serveurs MCP rechargent. S’il reste indisponible, corrigez l’application Codex Computer Use, le statut MCP de Codex app-server, ou les autorisations macOS.

Le statut ou une sonde expire sur computer-use.list_appsOpenClaw. Le plugin et le serveur MCP sont présents, mais le pont local Computer Use n’a pas répondu. Quittez ou redémarrez Codex Computer Use, relancez Codex Desktop si nécessaire, puis réessayez dans une nouvelle session OpenClaw.

Un outil Computer Use indique Native hook relay unavailableOpenClawGatewayOpenClaw. Le hook d’outil natif de Codex n’a pas pu atteindre un relais OpenClaw actif via le pont local ou le basculement vers la Gateway. Démarrez une nouvelle session OpenClaw avec /new ou /reset. Si cela fonctionne une fois puis échoue à nouveau lors d’un appel d’outil ultérieur, /newOpenClawGateway ne fait que nettoyer la tentative actuelle ; redémarrez le Codex app-server ou la Gateway OpenClaw afin que les anciens threads et les enregistrements de hooks soient supprimés, puis réessayez dans une nouvelle session.

L’auto-installation au début du tour refuse une source. C’est intentionnel. Ajoutez la source avec /codex computer-use install --source <marketplace-source> explicite d’abord, puis les futures auto-installations au début du tour pourront utiliser la marketplace locale détectée.