Ambientes de execução 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.

• Harnesses embutidos são executados dentro do loop de agente preparado do OpenClaw. Hoje, isso é o runtime pi integrado mais harnesses de Plugin registrados, como codex.
• Backends de CLI executam um processo de CLI local mantendo a ref de modelo canônica. Por exemplo, anthropic/claude-opus-4-7 com agentRuntime.id: "claude-cli" com escopo de modelo significa “selecionar o modelo Anthropic, executar por meio da Claude CLI.” claude-cli não é um id de harness embutido e não deve ser passado para a seleção de AgentHarness.

​

Superfícies do Codex

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

1. Se o usuário pedir vincular/controlar/thread/retomar/direcionar/parar Codex, use a superfície nativa de comando /codex quando o Plugin codex incluído estiver habilitado.
2. Se o usuário pedir Codex como o runtime embutido ou quiser a experiência normal de agente Codex respaldada por assinatura, use openai/<model>.
3. Se o usuário escolher explicitamente PI para um modelo OpenAI, mantenha a ref de modelo como openai/<model> e defina a política de runtime de provedor/modelo como agentRuntime.id: "pi". Um perfil de autenticação openai-codex selecionado é roteado internamente pelo transporte legado de autenticação Codex do PI.
4. Se a configuração legada ainda contiver refs de modelo openai-codex/*, repare-a para openai/<model> com openclaw doctor --fix; o doctor mantém a rota de autenticação Codex adicionando agentRuntime.id: "codex" com escopo de provedor/modelo onde a ref de modelo antiga o implicava.
5. Se o usuário disser explicitamente ACP, acpx ou adaptador ACP do Codex, use ACP com runtime: "acp" e agentId: "codex".
6. Se a solicitação for para Claude Code, Gemini CLI, OpenCode, Cursor, Droid ou outro harness externo, use ACP/acpx, não o runtime nativo de subagente.

​

Propriedade do runtime

• Se o OpenClaw possui a superfície, o OpenClaw pode fornecer comportamento normal de hooks de Plugin.
• Se o runtime nativo possui a superfície, o OpenClaw precisa de eventos de runtime ou hooks nativos.
• Se o runtime nativo possui o estado canônico da thread, o OpenClaw deve espelhar e projetar contexto, não reescrever internals sem suporte.

​

Seleção de runtime

1. A política de runtime com escopo de modelo vence. Ela pode existir em uma entrada de modelo de provedor configurada ou em agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime.
2. A política de runtime com escopo de provedor vem em seguida em models.providers.<provider>.agentRuntime.
3. No modo auto, runtimes de Plugin registrados podem reivindicar pares provedor/modelo compatíveis.
4. Se nenhum runtime reivindicar um turno no modo auto, o OpenClaw usa PI como runtime de compatibilidade. Use um id de runtime explícito quando a execução precisar ser estrita.

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

​

Contrato de compatibilidade

​

Rótulos de status

• Uma referência de modelo como openai/gpt-5.5 informa o provedor/modelo selecionado.
• Um ID de runtime como codex informa qual loop está executando o turno.
• Um rótulo de canal como Telegram ou Discord informa onde a conversa está acontecendo.

​

Relacionados

• Harness do Codex
• Runtime do harness do Codex
• OpenAI
• Plugins de harness de agente
• Loop do agente
• Modelos
• Status