Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

Computer Use es un plugin MCP nativo de Codex para el control del escritorio local. OpenClaw no incluye 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 con 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 sea propietario 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 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 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 está separada 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 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 administrados 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 encargarse de la instalación de plugins, las recargas de MCP y las llamadas nativas a herramientas dentro de turnos en modo Codex. El controlador 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, 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",
        fallback: "none",
      },
    },
  },
}
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 ningún marketplace coincidente registrado y existe el bundle 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 todavía no puede dejar disponible el servidor MCP, 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 hacer pruebas.

​
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 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 añade fuentes de marketplace, no instala plugins ni habilita la compatibilidad con plugins de Codex. install habilita la compatibilidad con plugins de Codex app-server, opcionalmente añade 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 cuandoCompatibilidad de instalación
Sin campo de marketplaceQuieres que Codex app-server use marketplaces que ya conoce.Sí, cuando app-server devuelve un marketplace local.
marketplaceSourceTienes una fuente de marketplace de Codex que app-server puede añadir.Sí, para /codex computer-use install explícito.
marketplacePathYa conoces la ruta local del archivo de marketplace en el host.Sí, para instalación explícita y auto-instalación al inicio del turno.
marketplaceNameQuieres 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 momento breve para poblar 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 ningún marketplace que contenga computer-use registrado, OpenClaw intenta añadir 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 un shell con Codex: 
codex plugin marketplace add /Applications/Codex.app/Contents/Resources/plugins/openai-bundled
Si usas una ruta no estándar de 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 rehabilitaciones siguen necesitando un marketplace local mediante marketplaceSource o marketplacePath. Si el estado indica que el plugin está disponible en un marketplace remoto de Codex pero la instalación remota no está admitida, 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

CampoPredeterminadoSignificado
enabledinferidoRequiere Computer Use. El valor predeterminado es true cuando se configura otro campo de Computer Use.
autoInstallfalseInstala o vuelve a habilitar desde marketplaces ya descubiertos al inicio del turno.
marketplaceDiscoveryTimeoutMs60000Cuánto tiempo espera la instalación al descubrimiento de marketplaces de Codex app-server.
marketplaceSourcesin configurarCadena de fuente pasada a marketplace/add de Codex app-server.
marketplacePathsin configurarRuta local de archivo de marketplace de Codex que contiene el plugin.
marketplaceNamesin configurarNombre de marketplace de Codex registrado que seleccionar.
pluginNamecomputer-useNombre del plugin de marketplace de Codex.
mcpServerNamecomputer-useNombre del servidor MCP expuesto por el plugin instalado.
La auto-instalación al inicio del turno rechaza intencionadamente valores marketplaceSource configurados. Añadir 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 auto-instalación al inicio del turno puede usar un marketplacePath configurado, porque eso ya es una ruta local en el host.

​
Qué comprueba OpenClaw

OpenClaw informa internamente de un motivo de configuración estable y formatea el estado orientado al usuario para el chat:
MotivoSignificadoSiguiente paso
disabledcomputerUse.enabled se resolvió en false.Configura enabled u otro campo de Computer Use.
marketplace_missingNo había ningún marketplace coincidente disponible.Configura fuente, ruta o nombre de marketplace.
plugin_not_installedEl marketplace existe, pero el plugin no está instalado.Ejecuta la instalación o habilita autoInstall.
plugin_disabledEl plugin está instalado pero deshabilitado en la configuración de Codex.Ejecuta la instalación para volver a habilitarlo.
remote_install_unsupportedEl marketplace seleccionado es solo remoto.Usa marketplaceSource o marketplacePath.
mcp_missingEl plugin está habilitado, pero el servidor MCP no está disponible.Comprueba Codex Computer Use y los permisos del SO.
readyEl plugin y las herramientas MCP están disponibles.Inicia el turno en modo Codex.
check_failedUna solicitud de Codex app-server falló durante la comprobación de estado.Comprueba la conectividad y los registros de app-server.
auto_install_blockedLa configuración al inicio del turno tendría que añadir una fuente nueva.Ejecuta primero la 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

Computer Use 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 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 está ejecutando en el mismo host donde debería ocurrir el control de escritorio.
  • El Plugin Computer Use está habilitado en la configuración de Codex.
  • El servidor MCP computer-use aparece en el estado de MCP de Codex app-server.
  • 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 intencionalmente de forma cerrada 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 dice que no está instalado. Ejecuta /codex computer-use install. Si no se descubre el marketplace, pasa --source o --marketplace-path. El estado dice 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 dice que la instalación remota no es compatible. Usa una fuente de marketplace local o una ruta. Las entradas de catálogo solo remotas se pueden inspeccionar, pero no instalar mediante la API actual de app-server. El estado dice 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 Codex Computer Use, el estado de MCP de Codex app-server 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 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 dice 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 los hilos antiguos de app-server y los registros de hooks se descarten, y luego reintenta. La instalación automática al inicio del turno rechaza una fuente. Esto es intencional. Agrega la fuente primero con /codex computer-use install --source <marketplace-source> explícito, y luego las futuras instalaciones automáticas al inicio del turno podrán usar el marketplace local descubierto.