Runtimes de agentes

• Harnesses incorporados são executados dentro do loop de agente preparado do OpenClaw: o runtime integrado openclaw, além de harnesses de plugins registrados, como codex e copilot.
• Backends de CLI executam um processo de CLI local enquanto mantêm a referência do modelo canônica. Por exemplo, anthropic/claude-opus-4-8 com agentRuntime.id: "claude-cli" no escopo do modelo significa “selecionar o modelo da Anthropic e executar por meio da Claude CLI”. claude-cli não é um id de harness incorporado e não deve ser passado para a seleção de AgentHarness.

​

Superfícies do Codex

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

1. Vincular/controlar/thread/retomar/direcionar/interromper no Codex -> superfície nativa de comandos /codex quando o plugin integrado codex estiver ativado.
2. Codex como runtime incorporado ou a experiência normal de agente Codex baseada em assinatura -> openai/<model>.
3. OpenClaw escolhido explicitamente para um modelo da OpenAI -> mantenha a referência do modelo como openai/<model> e defina a política de runtime do provedor/modelo como agentRuntime.id: "openclaw". Um perfil OAuth openai selecionado é roteado internamente pelo transporte de autenticação do Codex do OpenClaw.
4. Referências legadas de modelos Codex na configuração -> repare com openclaw doctor --fix para openai/<model>; o doctor mantém a rota de autenticação do Codex adicionando agentRuntime.id: "codex" no escopo do provedor/modelo quando a referência antiga do modelo implicava isso. Referências legadas de modelos codex-cli/* são reparadas para a mesma rota openai/<model> do app-server do Codex; o OpenClaw não mantém mais um backend integrado da Codex CLI.
5. ACP, acpx ou adaptador ACP do Codex solicitado explicitamente -> runtime: "acp" e agentId: "codex".
6. Claude Code, Gemini CLI, OpenCode, Cursor, Droid ou outro harness externo -> ACP/acpx, não o runtime nativo de subagentes.

​

Responsabilidade do runtime

​

Seleção de runtime

1. A política de runtime no escopo do modelo prevalece. Ela fica em uma entrada configurada de modelo do provedor ou em agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime. Um curinga de provedor, como agents.defaults.models["vllm/*"].agentRuntime, é aplicado após a política exata do modelo, permitindo que modelos de provedor descobertos dinamicamente compartilhem um runtime sem substituir exceções exatas por modelo.
2. Política de runtime no escopo do provedor: models.providers.<provider>.agentRuntime.
3. Modo auto: runtimes de plugins registrados podem reivindicar pares de provedor/modelo compatíveis.
4. Se nenhum runtime reivindicar o turno no modo auto, o OpenClaw usa openclaw 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-8",
      models: {
        "anthropic/claude-opus-4-8": {
          agentRuntime: { id: "claude-cli" },
        },
      },
    },
  },
}

​

Runtime de agente do GitHub Copilot

{
  agents: {
    defaults: {
      model: "github-copilot/gpt-5.5",
      models: {
        "github-copilot/gpt-5.5": {
          agentRuntime: { id: "copilot" },
        },
      },
    },
  },
}

​

Contrato de compatibilidade

​

Rótulos de status

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

​

Relacionados

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