Entornos de ejecución de agentes

Documentation Index

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

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

• Los harnesses embebidos se ejecutan dentro del bucle de agente preparado de OpenClaw. Hoy esto es el entorno de ejecución integrado pi más los harnesses de Plugin registrados, como codex.
• Los backends de CLI ejecutan un proceso de CLI local mientras mantienen canónica la referencia del modelo. Por ejemplo, anthropic/claude-opus-4-7 con un agentRuntime.id: "claude-cli" con alcance de modelo significa “seleccionar el modelo de Anthropic, ejecutar mediante Claude CLI.” claude-cli no es un id de harness embebido y no debe pasarse a la selección de AgentHarness.

​

Superficies de Codex

{
  agents: {
    defaults: {
      model: "openai/gpt-5.5",
    },
  },
}

1. Si el usuario pide vincular/controlar/hilo/reanudar/dirigir/detener Codex, usa la superficie nativa de comandos /codex cuando el Plugin codex incluido esté habilitado.
2. Si el usuario pide Codex como entorno de ejecución embebido o quiere la experiencia normal de agente de Codex respaldada por suscripción, usa openai/<model>.
3. Si el usuario elige explícitamente PI para un modelo de OpenAI, conserva la referencia de modelo como openai/<model> y establece la política de entorno de ejecución del proveedor/modelo en agentRuntime.id: "pi". Un perfil de autenticación openai-codex seleccionado se enruta internamente mediante el transporte heredado de autenticación de Codex de PI.
4. Si la configuración heredada todavía contiene referencias de modelo openai-codex/*, repárala a openai/<model> con openclaw doctor --fix; doctor conserva la ruta de autenticación de Codex agregando agentRuntime.id: "codex" con alcance de proveedor/modelo donde la antigua referencia de modelo lo implicaba.
5. Si el usuario dice explícitamente ACP, acpx o adaptador ACP de Codex, usa ACP con runtime: "acp" y agentId: "codex".
6. Si la solicitud es para Claude Code, Gemini CLI, OpenCode, Cursor, Droid u otro harness externo, usa ACP/acpx, no el entorno de ejecución nativo de subagente.

​

Propiedad del entorno de ejecución

• Si OpenClaw posee la superficie, OpenClaw puede proporcionar el comportamiento normal de hooks de Plugin.
• Si el entorno de ejecución nativo posee la superficie, OpenClaw necesita eventos de entorno de ejecución o hooks nativos.
• Si el entorno de ejecución nativo posee el estado canónico del hilo, OpenClaw debe reflejar y proyectar contexto, no reescribir internals no admitidos.

​

Selección del entorno de ejecución

1. La política de entorno de ejecución con alcance de modelo gana. Puede vivir en una entrada de modelo de proveedor configurada o en agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime.
2. La política de entorno de ejecución con alcance de proveedor viene después en models.providers.<provider>.agentRuntime.
3. En modo auto, los entornos de ejecución de Plugin registrados pueden reclamar pares de proveedor/modelo compatibles.
4. Si ningún entorno de ejecución reclama un turno en modo auto, OpenClaw usa PI como entorno de ejecución de compatibilidad. Usa un id de entorno de ejecución explícito cuando la ejecución deba ser estricta.

{
  agents: {
    defaults: {
      model: "anthropic/claude-opus-4-7",
      models: {
        "anthropic/claude-opus-4-7": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}

​

Contrato de compatibilidad

​

Etiquetas de estado

• Una referencia de modelo como openai/gpt-5.5 indica el proveedor/modelo seleccionado.
• Un identificador de entorno de ejecución como codex indica qué bucle está ejecutando el turno.
• Una etiqueta de canal como Telegram o Discord indica dónde está ocurriendo la conversación.

​

Relacionado

• Arnés de Codex
• Entorno de ejecución del arnés de Codex
• OpenAI
• Plugins de arnés de agente
• Bucle de agente
• Modelos
• Estado