--- read_when: - Quieres que los agentes de OpenClaw en modo Codex usen Codex Computer Use - Está decidiendo entre Codex Computer Use, PeekabooBridge y MCP directo de cua-driver - Estás decidiendo entre Codex Computer Use y una configuración directa de MCP con cua-driver - Estás configurando computerUse para el Plugin Codex incluido - Estás solucionando problemas de estado o instalación de /codex computer-use summary: Configura Codex Computer Use para agentes OpenClaw en modo Codex title: Uso de computadora de Codex x-i18n: generated_at: "2026-06-30T13:47:58Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: 4cb785e2fda0d89a7e7770df0c2a4b3aa23f97cb1c8515a7d555a8409acfd3b2 source_path: plugins/codex-computer-use.md workflow: 16 --- Computer Use es un plugin MCP nativo de Codex para el control del escritorio local. OpenClaw no integra la app de escritorio, no ejecuta acciones de escritorio por sí mismo ni omite los permisos de Codex. El plugin `codex` incluido solo prepara el app-server de Codex: habilita la compatibilidad de plugins de Codex, encuentra o instala el plugin configurado Codex Computer Use, comprueba que el servidor MCP `computer-use` esté disponible y luego deja que Codex se encargue de las llamadas nativas a herramientas MCP durante los turnos en modo Codex. Usa esta página cuando OpenClaw ya esté usando el harness nativo de Codex. Para la configuración del runtime en sí, consulta [harness de Codex](/es/plugins/codex-harness). ## OpenClaw.app y Peekaboo La integración de Peekaboo de OpenClaw.app es independiente de Codex Computer Use. La app de macOS puede alojar un socket PeekabooBridge para que la CLI `peekaboo` pueda reutilizar los permisos locales de Accesibilidad y Grabación de pantalla de la app para las propias herramientas de automatización de Peekaboo. Ese puente no instala ni actúa como proxy de Codex Computer Use, y Codex Computer Use no llama a través del socket PeekabooBridge. Usa [puente de Peekaboo](/es/platforms/mac/peekaboo) cuando quieras que OpenClaw.app sea un host consciente de permisos para la automatización de la CLI de Peekaboo. Usa esta página cuando un agente de OpenClaw en modo Codex deba tener disponible el plugin MCP nativo `computer-use` de Codex antes de que empiece el turno. ## App de iOS La app de iOS es independiente de Codex Computer Use. No instala ni actúa como proxy del servidor MCP `computer-use` de Codex y no es un backend de control de escritorio. En su lugar, la app de iOS se conecta como un nodo de OpenClaw y expone capacidades móviles mediante comandos de nodo como `canvas.*`, `camera.*`, `screen.*`, `location.*` y `talk.*`. Usa [iOS](/es/platforms/ios) cuando quieras que un agente controle un nodo de iPhone mediante el gateway. Usa esta página cuando un agente en modo Codex deba controlar el escritorio local de macOS mediante el plugin nativo Computer Use de Codex. ## MCP directo de cua-driver Codex Computer Use no es la única forma de exponer control de escritorio. Si quieres que los runtimes gestionados por OpenClaw llamen directamente al driver de TryCua, usa el servidor `cua-driver mcp` upstream mediante el registro MCP de OpenClaw en lugar del flujo de marketplace específico de Codex. Después de instalar `cua-driver`, pídele el comando de OpenClaw: ```bash cua-driver mcp-config --client openclaw ``` o registra tú mismo el servidor stdio: ```bash openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}' ``` Esa ruta mantiene intacta la superficie de herramientas MCP upstream, incluidos los esquemas del driver y las respuestas MCP estructuradas. Úsala cuando quieras que el driver CUA esté disponible como un servidor MCP normal de OpenClaw. Usa la configuración de Codex Computer Use de esta página cuando el app-server de Codex deba encargarse de la instalación del plugin, las recargas de MCP y las llamadas nativas a herramientas dentro de los turnos en modo Codex. El driver de CUA es específico de macOS y sigue requiriendo los permisos locales de macOS que solicita su app, como Accesibilidad y Grabación de pantalla. OpenClaw no instala `cua-driver`, concede esos permisos ni omite el modelo de seguridad del driver upstream. ## Configuración rápida Define `plugins.entries.codex.config.computerUse` cuando los turnos en modo Codex deban tener Computer Use disponible antes de que empiece un hilo. `autoInstall: true` activa Computer Use y permite que OpenClaw lo instale o vuelva a habilitar antes del turno: ```json5 { plugins: { entries: { codex: { enabled: true, config: { computerUse: { autoInstall: true, }, }, }, }, }, agents: { defaults: { model: "openai/gpt-5.5", }, }, } ``` Con esta configuración, OpenClaw comprueba el app-server de Codex antes de cada turno en modo Codex. Si falta Computer Use pero el app-server de Codex ya ha descubierto un marketplace instalable, OpenClaw le pide al app-server de Codex que instale o vuelva a habilitar el plugin y recargue los servidores MCP. En macOS, cuando no hay ningún marketplace coincidente registrado y existe el paquete estándar de la app Codex, OpenClaw también intenta registrar el marketplace de Codex incluido desde `/Applications/Codex.app/Contents/Resources/plugins/openai-bundled` antes de fallar. Si la configuración aún no puede hacer que el servidor MCP esté disponible, el turno falla antes de que empiece el hilo. Después de cambiar la configuración de Computer Use, usa `/new` o `/reset` en el chat afectado antes de probar si ya se inició un hilo de Codex existente. En el inicio de stdio gestionado en macOS, OpenClaw prefiere el paquete firmado de la app Codex de escritorio en `/Applications/Codex.app/Contents/Resources/codex` cuando existe. Eso mantiene Computer Use bajo el paquete de la app que posee los permisos locales de control del escritorio. Si la app de escritorio no está instalada, OpenClaw recurre al binario gestionado de Codex instalado junto al plugin. Si una app de escritorio instalada se inicializa con una versión de app-server no compatible, OpenClaw cierra ese proceso hijo y reintenta el siguiente candidato de binario gestionado en lugar de permitir que una app de escritorio obsoleta oculte el fallback local del plugin. La configuración explícita de `appServer.command` o `OPENCLAW_CODEX_APP_SERVER_BIN` sigue anulando esta selección gestionada. ## Comandos Usa los comandos `/codex computer-use` desde cualquier superficie de chat donde esté disponible la superficie de comandos del plugin `codex`. Estos son comandos de chat/runtime de OpenClaw, no subcomandos de la CLI `openclaw codex ...`: ```text /codex computer-use status /codex computer-use install /codex computer-use install --source /codex computer-use install --marketplace-path /codex computer-use install --marketplace ``` `status` es de solo lectura. No añade fuentes de marketplace, instala plugins ni habilita la compatibilidad de plugins de Codex. Si ninguna configuración activa Computer Use, `status` puede indicar que está deshabilitado incluso después de un comando de instalación puntual. `install` habilita la compatibilidad de plugins del app-server de Codex, añade opcionalmente una fuente de marketplace configurada, instala o vuelve a habilitar el plugin configurado mediante el app-server de Codex, recarga los servidores MCP y verifica que el servidor MCP exponga herramientas. Como la instalación cambia recursos de host de confianza, solo un propietario o un cliente de Gateway `operator.admin` puede ejecutar `install`. Otros remitentes autorizados pueden seguir usando el comando `status` de solo lectura, incluso con anulaciones. ## Opciones de marketplace OpenClaw usa la misma API de app-server que expone el propio Codex. Los campos de marketplace eligen dónde debe encontrar Codex `computer-use`. | Campo | Úsalo cuando | Compatibilidad de instalación | | -------------------- | --------------------------------------------------------------- | -------------------------------------------------------- | | Sin campo de marketplace | Quieres que el app-server de Codex use marketplaces que ya conoce. | Sí, cuando app-server devuelve un marketplace local. | | `marketplaceSource` | Tienes una fuente de marketplace de Codex que app-server puede añadir. | Sí, para `/codex computer-use install` explícito. | | `marketplacePath` | Ya conoces la ruta del archivo de marketplace local en el host. | Sí, para instalación explícita y autoinstalación al inicio del turno. | | `marketplaceName` | Quieres seleccionar un marketplace ya registrado por nombre. | Sí, solo cuando el marketplace seleccionado tiene una ruta local. | Los homes nuevos de Codex pueden necesitar un momento breve para inicializar sus marketplaces oficiales. Durante la instalación, OpenClaw sondea `plugin/list` durante hasta `marketplaceDiscoveryTimeoutMs` milisegundos. El valor predeterminado es 60 segundos. Si varios marketplaces conocidos contienen Computer Use, OpenClaw prefiere `openai-bundled`, luego `openai-curated` y luego `local`. Las coincidencias ambiguas desconocidas fallan de forma cerrada y te piden definir `marketplaceName` o `marketplacePath`. ## Marketplace de macOS incluido Las compilaciones recientes de escritorio de Codex incluyen Computer Use aquí: ```text /Applications/Codex.app/Contents/Resources/plugins/openai-bundled/plugins/computer-use ``` Cuando `computerUse.autoInstall` es true y no hay registrado ningún marketplace que contenga `computer-use`, OpenClaw intenta añadir automáticamente la raíz estándar del marketplace incluido: ```text /Applications/Codex.app/Contents/Resources/plugins/openai-bundled ``` También puedes registrarlo explícitamente desde una shell con Codex: ```bash codex plugin marketplace add /Applications/Codex.app/Contents/Resources/plugins/openai-bundled ``` Si usas una ruta no estándar de la app Codex, ejecuta `/codex computer-use install --source ` una vez o define `computerUse.marketplacePath` como una ruta local de archivo de marketplace. Usa `--marketplace-path` solo cuando tengas la ruta del archivo JSON del marketplace, no la raíz del marketplace incluido. ## Límite del catálogo remoto El app-server de Codex puede listar y leer entradas de catálogo solo remotas, pero actualmente no admite `plugin/install` remoto. Eso significa que `marketplaceName` puede seleccionar un marketplace solo remoto para comprobaciones de estado, pero las instalaciones y reactivaciones siguen necesitando un marketplace local mediante `marketplaceSource` o `marketplacePath`. Si el estado dice que el plugin está disponible en un marketplace remoto de Codex pero la instalación remota no es compatible, ejecuta la instalación con una fuente o ruta local: ```text /codex computer-use install --source /codex computer-use install --marketplace-path ``` ## Referencia de configuración | Campo | Valor predeterminado | Significado | | ------------------------------- | -------------- | ------------------------------------------------------------------------------ | | `enabled` | inferido | Requiere Computer Use. El valor predeterminado es true cuando se define otro campo de Computer Use. | | `autoInstall` | false | Instala o vuelve a habilitar desde marketplaces ya descubiertos al inicio del turno. | | `marketplaceDiscoveryTimeoutMs` | 60000 | Cuánto espera la instalación al descubrimiento de marketplaces del app-server de Codex. | | `marketplaceSource` | sin definir | Cadena de fuente pasada a `marketplace/add` del app-server de Codex. | | `marketplacePath` | sin definir | Ruta local de archivo de marketplace de Codex que contiene el plugin. | | `marketplaceName` | sin definir | Nombre de marketplace de Codex registrado para seleccionar. | | `pluginName` | `computer-use` | Nombre del plugin en el marketplace de Codex. | | `mcpServerName` | `computer-use` | Nombre del servidor MCP expuesto por el plugin instalado. | La autoinstalación al inicio del turno rechaza intencionadamente valores configurados de `marketplaceSource`. Añadir una fuente nueva es una operación de configuración explícita, así que usa `/codex computer-use install --source ` una vez y luego deja que `autoInstall` gestione las reactivaciones futuras desde marketplaces locales descubiertos. La autoinstalación al inicio del turno puede usar un `marketplacePath` configurado, porque ya es una ruta local en el host. ## Qué comprueba OpenClaw OpenClaw informa internamente de un motivo de configuración estable y da formato al estado visible para el usuario en el chat: | Motivo | Significado | Siguiente paso | | ---------------------------- | ------------------------------------------------------ | --------------------------------------------- | | `disabled` | `computerUse.enabled` se resolvió como false. | Define `enabled` u otro campo de uso de computadora. | | `marketplace_missing` | No había ningún marketplace coincidente disponible. | Configura el origen, la ruta o el nombre del marketplace. | | `plugin_not_installed` | El marketplace existe, pero el plugin no está instalado. | Ejecuta la instalación o habilita `autoInstall`. | | `plugin_disabled` | El Plugin está instalado, pero deshabilitado en la configuración de Codex. | Ejecuta la instalación para volver a habilitarlo. | | `remote_install_unsupported` | El marketplace seleccionado es solo remoto. | Usa `marketplaceSource` o `marketplacePath`. | | `mcp_missing` | El Plugin está habilitado, pero el servidor MCP no está disponible. | Revisa el uso de computadora de Codex y los permisos del SO. | | `ready` | El Plugin y las herramientas MCP están disponibles. | Inicia el turno en modo Codex. | | `check_failed` | Falló una solicitud del app-server de Codex durante la comprobación de estado. | Revisa la conectividad y los registros del app-server. | | `auto_install_blocked` | La configuración al inicio del turno tendría que agregar un nuevo origen. | Ejecuta primero una instalación explícita. | La salida del chat incluye el estado del plugin, el estado del servidor MCP, el marketplace, las herramientas cuando están disponibles y el mensaje específico del paso de configuración que falla. ## Permisos de macOS El uso de computadora es específico de macOS. El servidor MCP propiedad de Codex puede necesitar permisos locales del SO antes de poder inspeccionar o controlar apps. Si OpenClaw indica que el uso de computadora está instalado, pero el servidor MCP no está disponible, verifica primero la configuración del uso de computadora del lado de Codex: - El app-server de Codex se está ejecutando en el mismo host donde debe ocurrir el control del escritorio. - El plugin de uso de computadora está habilitado en la configuración de Codex. - El servidor MCP `computer-use` aparece en el estado MCP del app-server de Codex. - macOS ha concedido los permisos requeridos para la app de control de escritorio. - La sesión actual del host puede acceder al escritorio que se está controlando. OpenClaw falla de forma cerrada intencionalmente cuando `computerUse.enabled` es true. Un turno en modo Codex no debe continuar silenciosamente sin las herramientas nativas de escritorio que exigía la configuración. ## Solución de problemas **El estado indica que no está instalado.** Ejecuta `/codex computer-use install`. Si no se descubre el marketplace, pasa `--source` o `--marketplace-path`. **El estado indica que está instalado pero deshabilitado.** Ejecuta `/codex computer-use install` de nuevo. La instalación del app-server de Codex vuelve a escribir la configuración del plugin como habilitada. **El estado indica que la instalación remota no es compatible.** Usa un origen o una ruta de marketplace local. Las entradas de catálogo solo remotas se pueden inspeccionar, pero no instalar mediante la API actual del app-server. **El estado indica que el servidor MCP no está disponible.** Vuelve a ejecutar la instalación una vez para que los servidores MCP se recarguen. Si sigue sin estar disponible, corrige la app de uso de computadora de Codex, el estado MCP del app-server de Codex o los permisos de macOS. **El estado o una prueba agota el tiempo de espera en `computer-use.list_apps`.** El plugin y el servidor MCP están presentes, pero el puente local de uso de computadora no respondió. Cierra o reinicia Codex Computer Use, vuelve a iniciar Codex Desktop si es necesario y luego reintenta en una sesión nueva de OpenClaw. Si el host ejecutó previamente el uso de computadora mediante un app-server de Codex gestionado más antiguo, actualiza el plugin instalado desde el marketplace incluido con la app de escritorio: ```text /codex computer-use install --source /Applications/Codex.app/Contents/Resources/plugins/openai-bundled ``` **Una herramienta de uso de computadora indica `Native hook relay unavailable`.** El hook de herramienta nativo de Codex no pudo alcanzar un relay activo de OpenClaw mediante el puente local o el respaldo del Gateway. Inicia una sesión nueva de OpenClaw con `/new` o `/reset`. Si funciona una vez y luego vuelve a fallar en una llamada posterior a una herramienta, `/new` solo está limpiando el intento actual; reinicia el app-server de Codex o el Gateway de OpenClaw para que los hilos antiguos y los registros de hooks se descarten, y luego reintenta en una sesión nueva. **La instalación automática al inicio del turno rechaza un origen.** Esto es intencional. Agrega el origen con `/codex computer-use install --source ` explícito primero; después, la instalación automática al inicio de futuros turnos podrá usar el marketplace local descubierto. ## Relacionado - [Arnés de Codex](/es/plugins/codex-harness) - [Puente Peekaboo](/es/platforms/mac/peekaboo) - [App de iOS](/es/platforms/ios)