Plugins
Uso de computadora de Codex
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 Codex app-server:
habilita la compatibilidad de Plugins de Codex, encuentra o instala el Plugin Codex
Computer Use configurado, comprueba que el servidor MCP computer-use esté disponible y
luego deja que Codex controle las llamadas a herramientas MCP nativas 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 es independiente de Codex Computer Use. La
app de macOS puede alojar un socket PeekabooBridge para que la CLI peekaboo pueda reutilizar las
concesiones 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 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 el Plugin MCP nativo computer-use de Codex
disponible 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 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
Codex Computer Use no es la única forma de exponer el control de escritorio. Si quieres que
los runtimes gestionados por OpenClaw llamen directamente al controlador 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:
cua-driver mcp-config --client openclaw
o registra tú mismo el servidor stdio:
openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'
Esa ruta mantiene intacta la superficie de herramientas MCP upstream, incluidos los esquemas del controlador y las respuestas MCP estructuradas. Úsala cuando quieras que el controlador CUA esté disponible como un servidor MCP normal de OpenClaw. Usa la configuración de Codex Computer Use de esta página cuando Codex app-server deba controlar la instalación del Plugin, las recargas de MCP y las llamadas a herramientas nativas dentro de los turnos en modo Codex.
El controlador de CUA es específico de macOS y todavía requiere los permisos locales de macOS
que su app solicita, como Accesibilidad y Grabación de pantalla. OpenClaw
no instala cua-driver, no concede esos permisos ni omite el modelo de seguridad del
controlador upstream.
Configuración rápida
Configura plugins.entries.codex.config.computerUse cuando los turnos en modo Codex deban tener
Computer Use disponible antes de que empiece un hilo:
{
plugins: {
entries: {
codex: {
enabled: true,
config: {
computerUse: {
autoInstall: true,
},
},
},
},
},
agents: {
defaults: {
model: "openai/gpt-5.5",
agentRuntime: {
id: "codex",
},
},
},
}
Con esta configuración, OpenClaw comprueba Codex app-server antes de cada turno en modo Codex.
Si falta Computer Use pero Codex app-server ya ha descubierto un marketplace instalable,
OpenClaw pide a Codex app-server que instale o vuelva a habilitar el Plugin y recargue los
servidores MCP. En macOS, cuando no hay registrado ningún marketplace coincidente y existe el
paquete estándar de la app Codex, OpenClaw también intenta registrar el marketplace incluido de Codex 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.
Las sesiones existentes conservan su runtime y el enlace del hilo de Codex. Después de cambiar
agentRuntime o la configuración de Computer Use, usa /new o /reset en el chat afectado
antes de probar.
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 ...:
/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 es de solo lectura. No agrega fuentes de marketplace, no instala Plugins ni
habilita la compatibilidad de Plugins de Codex.
install habilita la compatibilidad de Plugins de Codex app-server, opcionalmente agrega una fuente
de marketplace configurada, instala o vuelve a habilitar el Plugin configurado mediante Codex
app-server, recarga los servidores MCP y verifica que el servidor MCP exponga herramientas.
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 Codex app-server 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 agregar. | 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 e instalación automática al inicio del turno. |
marketplaceName |
Quieres seleccionar por nombre un marketplace ya registrado. | Sí, solo cuando el marketplace seleccionado tiene una ruta local. |
Los homes nuevos de Codex pueden necesitar un breve momento para sembrar 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 configurar marketplaceName o marketplacePath.
Marketplace incluido de macOS
Las compilaciones recientes de escritorio de Codex incluyen Computer Use aquí:
/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 agregar automáticamente la raíz estándar del marketplace
incluido:
/Applications/Codex.app/Contents/Resources/plugins/openai-bundled
También puedes registrarlo explícitamente desde una shell con Codex:
codex plugin marketplace add /Applications/Codex.app/Contents/Resources/plugins/openai-bundled
Si usas una ruta no estándar para la app Codex, configura computerUse.marketplacePath con una
ruta local de archivo de marketplace o ejecuta /codex computer-use install --source <marketplace-source> una vez.
Límite del catálogo remoto
Codex app-server 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 las reactivaciones
todavía 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:
/codex computer-use install --source <marketplace-source>
/codex computer-use install --marketplace-path <path>
Referencia de configuración
| Campo | Valor predeterminado | Significado |
|---|---|---|
enabled |
inferido | Requiere Computer Use. De forma predeterminada es true cuando se configura otro campo de Computer Use. |
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 de Codex app-server. |
marketplaceSource |
no configurado | Cadena de fuente pasada a marketplace/add de Codex app-server. |
marketplacePath |
no configurado | Ruta de archivo de marketplace local de Codex que contiene el Plugin. |
marketplaceName |
no configurado | Nombre del marketplace de Codex registrado que se debe seleccionar. |
pluginName |
computer-use |
Nombre del Plugin del marketplace de Codex. |
mcpServerName |
computer-use |
Nombre del servidor MCP expuesto por el Plugin instalado. |
La instalación automática al inicio del turno rechaza intencionalmente los valores configurados de 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 reactivaciones desde marketplaces locales descubiertos.
La instalación automática al inicio del turno puede usar un marketplacePath configurado, porque esa ya es
una ruta local en el host.
Qué comprueba OpenClaw
OpenClaw informa internamente un motivo de configuración estable y formatea el estado orientado al usuario para el chat:
| Motivo | Significado | Siguiente paso |
|---|---|---|
disabled |
computerUse.enabled se resolvió en false. |
Configura enabled u otro campo de Computer Use. |
marketplace_missing |
No había disponible ningún marketplace coincidente. | Configura fuente, ruta o nombre de 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 Codex Computer Use y los permisos del SO. |
ready |
El Plugin y las herramientas MCP están disponibles. | Inicia el turno en modo Codex. |
check_failed |
Una solicitud a Codex app-server falló durante la comprobación de estado. | Comprueba la conectividad y los registros de app-server. |
auto_install_blocked |
La configuración al inicio del turno tendría que agregar una fuente nueva. | 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 fallido.
Permisos de macOS
Computer Use es específico de macOS. El servidor MCP controlado por Codex puede necesitar permisos locales del SO antes de poder inspeccionar o controlar apps. Si OpenClaw dice que Computer Use está instalado pero el servidor MCP no está disponible, verifica primero la configuración de Computer Use del lado de Codex:
- Codex app-server se ejecuta en el mismo host donde debe ocurrir el control de escritorio.
- El Plugin Computer Use está habilitado en la configuración de Codex.
- El servidor MCP
computer-useaparece en el estado MCP de Codex app-server. - macOS ha concedido los permisos requeridos para la aplicación 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 debería continuar silenciosamente sin las herramientas nativas de escritorio que requerí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 de Codex app-server vuelve a escribir la configuración del Plugin como habilitada.
El estado indica que la instalación remota no es compatible. Usa una fuente o ruta de marketplace local. Las entradas de catálogo solo remotas se pueden inspeccionar, pero no instalar mediante la API actual de 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 aplicación Codex Computer Use, el estado MCP de Codex app-server 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, vuelve a iniciar Codex Desktop si es necesario y luego reintenta en una sesión nueva de OpenClaw.
Una herramienta de Computer Use 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 de Gateway. Inicia una sesión nueva de OpenClaw con /new o /reset. Si sigue ocurriendo, reinicia el Gateway para que se descarten los hilos antiguos de app-server y los registros de hooks, luego reintenta.
La instalación automática al inicio del turno rechaza una fuente. Esto es intencional. Añade primero la fuente con /codex computer-use install --source <marketplace-source> explícito; luego, las futuras instalaciones automáticas al inicio del turno podrán usar el marketplace local descubierto.