Un harness es la implementación que proporciona un entorno de ejecución de agente (término de
código). Por ejemplo, el harness Codex incluido implementa el entorno de ejecución
codex.
La configuración pública usa agentRuntime.id en las entradas de proveedor o modelo; las claves de
entorno de ejecución para todo el agente son heredadas y se ignoran. openclaw doctor --fix elimina las
asignaciones antiguas de entorno de ejecución para todo el agente y reescribe las referencias heredadas
de modelos de entorno de ejecución como referencias canónicas de proveedor/modelo, además de añadir
la política de entorno de ejecución con ámbito de modelo cuando sea necesario.
Dos familias de entornos de ejecución:
- Los harnesses integrados se ejecutan dentro del bucle de agente preparado de OpenClaw: el
entorno de ejecución
openclawincorporado, además de harnesses de plugins registrados comocodexycopilot. - Los backends de CLI ejecutan un proceso de CLI local mientras mantienen canónica la referencia del modelo.
Por ejemplo,
anthropic/claude-opus-5con unagentRuntime.id: "claude-cli"con ámbito de modelo significa «seleccionar el modelo de Anthropic y ejecutarlo mediante Claude CLI».claude-clino es un identificador de harness integrado y no debe pasarse a la selección de AgentHarness.
copilot es un harness de plugin externo independiente y opcional para la
CLI de GitHub Copilot; consulte Entorno de ejecución de agente de GitHub Copilot para
conocer la decisión de cara al usuario entre PI, Codex y el entorno de ejecución de agente de GitHub Copilot.
Superficies de Codex
Varias superficies comparten el nombre Codex:
Estas superficies son independientes de forma intencionada. Activar el plugin
codex
hace que estén disponibles las funciones nativas del servidor de aplicaciones; openclaw doctor --fix se encarga
de reparar rutas heredadas de Codex y limpiar asignaciones de sesión obsoletas. Seleccionar openai/*
para un modelo de agente ahora significa «ejecutar esto mediante Codex», salvo que se esté usando una superficie
de API de OpenAI que no sea de agente.
La configuración habitual de suscripción a ChatGPT/Codex usa OAuth de Codex para la autenticación, pero
mantiene la referencia del modelo como openai/* y selecciona el entorno de ejecución codex:
codex incluido esté activado, use la superficie de comandos nativa /codex
(/codex bind, /codex threads, /codex resume, /codex steer,
/codex stop) para controlar Codex mediante lenguaje natural en lugar de ACP. Use ACP para
Codex solo cuando se solicite explícitamente ACP/acpx o se esté probando la ruta del adaptador ACP.
Claude Code, Gemini CLI, OpenCode, Cursor y otros harnesses externos similares siguen usando ACP.
Árbol de decisión:
- Vincular/controlar/hilo/reanudar/dirigir/detener Codex -> superficie de comandos nativa
/codexcuando el plugincodexincluido esté activado. - Codex como entorno de ejecución integrado o la experiencia normal de agente Codex respaldada por una suscripción ->
openai/<model>. - OpenClaw elegido explícitamente para un modelo de OpenAI -> mantenga la referencia del modelo como
openai/<model>y establezca la política de entorno de ejecución del proveedor/modelo enagentRuntime.id: "openclaw". Un perfil OAuthopenaiseleccionado se enruta internamente mediante el transporte de autenticación de Codex de OpenClaw. - Referencias heredadas de modelos Codex en la configuración -> repárelas con
openclaw doctor --fixpara convertirlas enopenai/<model>; doctor conserva la ruta de autenticación de Codex añadiendoagentRuntime.id: "codex"con ámbito de proveedor/modelo cuando la referencia antigua del modelo lo implicaba. Las referencias heredadas de modeloscodex-cli/*se reparan para usar la misma rutaopenai/<model>del servidor de aplicaciones de Codex; OpenClaw ya no mantiene un backend de CLI de Codex incluido. - ACP, acpx o adaptador ACP de Codex solicitado explícitamente ->
runtime: "acp"yagentId: "codex". - Claude Code, Gemini CLI, OpenCode, Cursor, Droid u otro harness externo -> ACP/acpx, no el entorno de ejecución nativo de subagentes.
Para conocer la división de prefijos de la familia OpenAI, consulte OpenAI y
Proveedores de modelos. Para conocer el contrato de compatibilidad del entorno de ejecución
de Codex, consulte Entorno de ejecución del harness Codex.
Propiedad del entorno de ejecución
Los distintos entornos de ejecución poseen diferentes partes del bucle:
Regla de diseño: si OpenClaw posee la superficie, puede proporcionar el comportamiento normal de los hooks de plugins.
Si el entorno de ejecución nativo posee la superficie, OpenClaw necesita eventos del entorno de ejecución o hooks
nativos. Si el entorno de ejecución nativo posee el estado canónico del hilo, OpenClaw refleja y proyecta el contexto
en lugar de reescribir componentes internos no compatibles.
Selección del entorno de ejecución
OpenClaw resuelve un entorno de ejecución integrado después de resolver el proveedor y el modelo, en este orden:- La política de entorno de ejecución con ámbito de modelo tiene prioridad. Se encuentra en una entrada de modelo
del proveedor configurado, o en
agents.defaults.models["provider/model"].agentRuntime/agents.entries.*.models["provider/model"].agentRuntime. Un comodín de proveedor comoagents.defaults.models["vllm/*"].agentRuntimese aplica después de la política exacta del modelo, para que los modelos de proveedor descubiertos dinámicamente puedan compartir un entorno de ejecución sin sobrescribir excepciones exactas por modelo. - Política de entorno de ejecución con ámbito de proveedor:
models.providers.<provider>.agentRuntime. - Modo
auto: los entornos de ejecución de plugins registrados pueden reclamar pares de proveedor/modelo compatibles. - Si nada reclama el turno en el modo
auto, OpenClaw recurre aopenclawcomo entorno de ejecución de compatibilidad. Use un identificador de entorno de ejecución explícito cuando la ejecución deba ser estricta.
OPENCLAW_AGENT_RUNTIME,
el estado de sesión agentHarnessId/agentRuntimeOverride, agents.defaults.agentRuntime
y agents.entries.*.agentRuntime. Ejecute openclaw doctor --fix para eliminar la
configuración obsoleta del entorno de ejecución para todo el agente y convertir las referencias heredadas de modelos
de entorno de ejecución cuando sea posible conservar la intención.
Los entornos de ejecución de plugins explícitos de proveedor/modelo fallan de forma cerrada: agentRuntime.id: "codex"
en un proveedor o modelo significa Codex, o un error claro de selección/entorno de ejecución; nunca se
redirige silenciosamente a OpenClaw. Solo auto puede dirigir a OpenClaw un turno sin coincidencias.
Los alias de backends de CLI difieren de los identificadores de harnesses integrados. Forma preferida para Claude CLI:
claude-cli/claude-opus-4-7 siguen siendo compatibles por
compatibilidad, pero la configuración nueva debe mantener canónicos el proveedor/modelo y
situar el backend de ejecución en la política de entorno de ejecución del proveedor/modelo.
Las referencias heredadas codex-cli/* son diferentes: doctor las migra a openai/* para que
se ejecuten mediante el harness del servidor de aplicaciones de Codex en lugar de conservar un backend de
CLI de Codex.
El modo auto es intencionadamente conservador para la mayoría de los proveedores. Los modelos de agente
de OpenAI son la excepción: tanto un entorno de ejecución no establecido como auto se resuelven en el harness
Codex. La configuración explícita del entorno de ejecución de OpenClaw sigue siendo una ruta de compatibilidad
opcional para los turnos de agente openai/*; cuando se combina con un perfil OAuth openai
seleccionado, OpenClaw dirige internamente esa ruta mediante el transporte de autenticación de Codex
mientras mantiene la referencia pública del modelo como openai/*. Las asignaciones obsoletas de sesión
del entorno de ejecución de OpenAI se ignoran durante la selección del entorno de ejecución y pueden limpiarse con
openclaw doctor --fix.
Si openclaw doctor advierte que el plugin codex está habilitado mientras aún quedan
referencias de modelos Codex heredadas en la configuración, trátelo como un estado de ruta heredada y ejecute
openclaw doctor --fix para reescribirlo como openai/* con el entorno de ejecución Codex.
Entorno de ejecución de agentes de GitHub Copilot
El plugin externo@openclaw/copilot registra un entorno de ejecución copilot opcional
respaldado por la CLI de GitHub Copilot (@github/copilot-sdk). Este reclama el
proveedor de suscripción canónico github-copilot y nunca lo selecciona
auto. Habilítelo por modelo o por proveedor mediante agentRuntime.id:
extensions/copilot/doctor-contract-api.ts, que openclaw doctor
carga automáticamente. Para obtener información sobre la configuración, la autenticación, la replicación de transcripciones, Compaction, el
contrato declarativo de doctor y la decisión más amplia del SDK entre PI, Codex y Copilot,
consulte Entorno de ejecución de agentes de GitHub Copilot.
Contrato de compatibilidad
Cuando un entorno de ejecución no sea OpenClaw, su documentación debe indicar qué superficies de OpenClaw admite:
El contrato de compatibilidad del entorno de ejecución Codex se documenta en
Entorno de ejecución del arnés de Codex.
Etiquetas de estado
La salida de estado puede mostrar las etiquetasExecution y Runtime. Interprételas como
diagnósticos, no como nombres de proveedores:
- Una referencia de modelo como
openai/gpt-5.6-soles el proveedor/modelo seleccionado. - Un identificador de entorno de ejecución como
codexes el bucle que ejecuta el turno. - Una etiqueta de canal como Telegram o Discord indica dónde se desarrolla la conversación.