codex solo prepara el servidor de aplicaciones de Codex:
habilita el soporte de plugins de Codex, encuentra o instala el Plugin de Uso de computadora
configurado, verifica que el servidor MCP computer-use esté disponible y luego deja que
Codex sea dueño de las llamadas nativas a herramientas MCP durante los turnos en modo Codex.
Usa esta página cuando OpenClaw ya esté usando el arnés nativo de Codex. Para la
configuración del runtime en sí, consulta Arnés de Codex.
OpenClaw.app y Peekaboo
La integración de Peekaboo de OpenClaw.app está separada de Uso de computadora de Codex. La aplicación de macOS puede alojar un socket PeekabooBridge para que la CLIpeekaboo pueda reutilizar las
concesiones locales de Accesibilidad y Grabación de pantalla de la aplicación para las propias
herramientas de automatización de Peekaboo. Ese puente no instala ni hace proxy de Uso de computadora de Codex, y
Uso de computadora de Codex no llama a través del socket PeekabooBridge.
Usa Puente de 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 computer-use nativo de Codex
antes de que empiece el turno.
Aplicación iOS
La aplicación iOS está separada de Uso de computadora de Codex. No instala ni hace proxy del servidor MCPcomputer-use de Codex, y no es un backend de control de escritorio.
En su lugar, la aplicación 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 cuando quieras que un agente controle un nodo iPhone
a través del 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
Uso de computadora de Codex no es la única forma de exponer control de escritorio. Si quieres que los runtimes gestionados por OpenClaw llamen directamente al controlador de TryCua, usa el servidorcua-driver mcp upstream a través del 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:
cua-driver, no concede esos permisos ni omite el modelo de seguridad del
controlador upstream.
Configuración rápida
Defineplugins.entries.codex.config.computerUse cuando los turnos en modo Codex deban tener
Uso de computadora disponible antes de que empiece un hilo. autoInstall: true activa
Uso de computadora y permite que OpenClaw lo instale o lo vuelva a habilitar antes del turno:
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled antes de
fallar. Si la configuración aún no puede hacer disponible el servidor MCP, el turno falla
antes de que empiece el hilo.
Después de cambiar la configuración de Uso de computadora, usa /new o /reset en el chat
afectado antes de probar si ya se inició un hilo de Codex existente.
En el inicio stdio gestionado en macOS, OpenClaw prefiere el paquete firmado de la aplicación de escritorio Codex
en /Applications/Codex.app/Contents/Resources/codex cuando existe.
Eso mantiene Uso de computadora bajo el paquete de la aplicación que posee los permisos locales
de control de escritorio. Si la aplicación de escritorio no está instalada, OpenClaw
recurre al binario gestionado de Codex instalado junto al Plugin. Si una
aplicación de escritorio instalada se inicializa con una versión de servidor de aplicaciones no compatible,
OpenClaw cierra ese proceso hijo y reintenta con el siguiente candidato de binario gestionado
en lugar de permitir que una aplicación de escritorio obsoleta oculte la alternativa local del Plugin.
La configuración explícita appServer.command o OPENCLAW_CODEX_APP_SERVER_BIN aún
anula esta selección gestionada.
Comandos
Usa los comandos/codex computer-use desde cualquier superficie de chat donde la
superficie de comandos del Plugin codex esté disponible. Estos son comandos de chat/runtime
de OpenClaw, no subcomandos de la CLI openclaw codex ...:
status es la acción predeterminada y es de solo lectura: no agrega fuentes de marketplace,
no instala plugins ni habilita el soporte de plugins de Codex. Si ninguna configuración activa
Uso de computadora, status puede informar que está deshabilitado incluso después de un comando
de instalación puntual.
install habilita el soporte de plugins del servidor de aplicaciones de Codex, agrega opcionalmente una
fuente de marketplace configurada, instala o vuelve a habilitar el Plugin configurado
mediante el servidor de aplicaciones 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 Gateway operator.admin puede ejecutar install. Otros
remitentes autorizados pueden seguir usando el comando status de solo lectura,
incluido con anulaciones.
Opciones de marketplace
OpenClaw usa la misma API de servidor de aplicaciones que expone el propio Codex. Los campos de marketplace eligen dónde debe encontrar Codexcomputer-use.
| Campo | Úsalo cuando | Soporte de instalación |
|---|---|---|
| Sin campo de marketplace | Quieres que el servidor de aplicaciones de Codex use marketplaces que ya conoce. | Sí, cuando el servidor de aplicaciones devuelve un marketplace local. |
marketplaceSource | Tienes una fuente de marketplace de Codex que el servidor de aplicaciones puede agregar. | Sí, para /codex computer-use install explícito. |
marketplacePath | Ya conoces la ruta local del archivo de marketplace en el host. | Sí, para instalación explícita y autoinstalación al inicio del turno. |
marketplaceName | Quieres seleccionar por nombre un marketplace ya registrado. | Sí, solo cuando el marketplace seleccionado tiene una ruta local. |
plugin/list durante hasta
marketplaceDiscoveryTimeoutMs milisegundos (valor predeterminado: 60 segundos).
Si varios marketplaces conocidos contienen Uso de computadora, 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 incluido de macOS
Las compilaciones recientes de escritorio de Codex incluyen Uso de computadora aquí:computerUse.autoInstall es true y no hay registrado ningún marketplace que contenga
computer-use, OpenClaw intenta agregar automáticamente la raíz estándar del marketplace
incluido:
/codex computer-use install --source <marketplace-root>, o define computerUse.marketplacePath con 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 servidor de aplicaciones de Codex puede listar y leer entradas de catálogo solo remotas, pero actualmente no admiteplugin/install remoto. Eso significa que marketplaceName
puede seleccionar un marketplace solo remoto para verificaciones de estado, pero las instalaciones y
rehabilitaciones aún necesitan 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:
Referencia de configuración
| Campo | Predeterminado | Significado |
|---|---|---|
enabled | inferido | Requiere Uso de computadora. El valor predeterminado es true cuando se define otro campo de Uso de computadora. |
autoInstall | false | Instala o vuelve a habilitar desde marketplaces ya descubiertos al inicio del turno. |
marketplaceDiscoveryTimeoutMs | 60000 | Cuánto tiempo espera la instalación al descubrimiento de marketplaces del servidor de aplicaciones de Codex. |
marketplaceSource | sin definir | Cadena de fuente pasada a marketplace/add del servidor de aplicaciones de Codex. |
marketplacePath | sin definir | Ruta local del archivo de marketplace de Codex que contiene el Plugin. |
marketplaceName | sin definir | Nombre de marketplace de Codex registrado que se seleccionará. |
pluginName | computer-use | Nombre del Plugin en el marketplace de Codex. |
mcpServerName | computer-use | Nombre del servidor MCP expuesto por el Plugin instalado. |
marketplaceSource.
Agregar una fuente nueva es una operación de configuración explícita, así que usa
/codex computer-use install --source <marketplace-source> una vez y luego deja que
autoInstall gestione futuras rehabilitaciones desde marketplaces locales descubiertos.
La autoinstalación al inicio del turno puede usar un marketplacePath configurado, porque esa
ya es una ruta local en el host.
Cada campo también acepta una anulación mediante variable de entorno, verificada cuando la
clave de configuración correspondiente no está definida:
| Campo | Variable de entorno |
|---|---|
enabled | OPENCLAW_CODEX_COMPUTER_USE |
autoInstall | OPENCLAW_CODEX_COMPUTER_USE_AUTO_INSTALL |
marketplaceDiscoveryTimeoutMs | OPENCLAW_CODEX_COMPUTER_USE_MARKETPLACE_DISCOVERY_TIMEOUT_MS |
marketplaceSource | OPENCLAW_CODEX_COMPUTER_USE_MARKETPLACE_SOURCE |
marketplacePath | OPENCLAW_CODEX_COMPUTER_USE_MARKETPLACE_PATH |
marketplaceName | OPENCLAW_CODEX_COMPUTER_USE_MARKETPLACE_NAME |
pluginName | OPENCLAW_CODEX_COMPUTER_USE_PLUGIN_NAME |
mcpServerName | OPENCLAW_CODEX_COMPUTER_USE_MCP_SERVER_NAME |
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ó en false. | Define enabled u otro campo de Computer Use. |
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. | Comprueba Computer Use 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 al servidor de aplicaciones de Codex durante la comprobación de estado. | Comprueba la conectividad y los registros del servidor de aplicaciones. |
auto_install_blocked | La configuración al inicio del turno tendría que añadir un origen nuevo. | Ejecuta primero una instalación explícita. |
Permisos de macOS
Computer Use es específico de macOS. Es posible que el servidor MCP propiedad de Codex necesite permisos locales del SO antes de poder inspeccionar o controlar aplicaciones. Si OpenClaw indica que Computer Use está instalado, pero el servidor MCP no está disponible, verifica primero la configuración de Computer Use del lado de Codex:- El servidor de aplicaciones de Codex se está ejecutando en el mismo host donde debe producirse el control del escritorio.
- El plugin Computer Use está habilitado en la configuración de Codex.
- El servidor MCP
computer-useaparece en el estado MCP del servidor de aplicaciones de Codex. - macOS ha concedido los permisos necesarios para la aplicación de control de escritorio.
- La sesión actual del host puede acceder al escritorio que se está controlando.
computerUse.enabled es true. Un turno en modo Codex no debería 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 servidor de aplicaciones 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 servidor de aplicaciones.
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 aplicación Codex Computer Use, el estado MCP del servidor de aplicaciones de Codex o los permisos de macOS.
El estado o una sonda agota el tiempo de espera en computer-use.list_apps. El plugin y el servidor MCP están presentes, pero el puente local de Computer Use no respondió. Cierra o reinicia Codex Computer Use, reinicia Codex Desktop si es necesario y vuelve a intentarlo en una sesión nueva de OpenClaw. Si el host ejecutó antes Computer Use mediante un servidor de aplicaciones de Codex administrado antiguo, actualiza el plugin instalado desde el marketplace incluido en el escritorio:
Native hook relay unavailable. El hook de herramienta nativo de Codex no pudo alcanzar un relay activo de OpenClaw a través del puente local o del fallback del Gateway. Inicia una sesión nueva de OpenClaw con /new o /reset. Si funciona una vez y vuelve a fallar en una llamada de herramienta posterior, /new solo está limpiando el intento actual; reinicia el servidor de aplicaciones de Codex o el Gateway de OpenClaw para que se descarten los hilos antiguos y los registros de hooks, y vuelve a intentarlo en una sesión nueva.
La instalación automática al inicio del turno rechaza un origen. Esto es intencionado. Añade primero el origen con /codex computer-use install --source <marketplace-source> explícito; después, futuras instalaciones automáticas al inicio del turno podrán usar el marketplace local descubierto.