Runtime degli agenti

• Gli harness incorporati vengono eseguiti all’interno del ciclo dell’agente predisposto da OpenClaw: il runtime openclaw integrato e gli harness dei plugin registrati, come codex e copilot.
• I backend CLI eseguono un processo CLI locale mantenendo canonico il riferimento al modello. Ad esempio, anthropic/claude-opus-4-8 con agentRuntime.id: "claude-cli" specifico per il modello significa «seleziona il modello Anthropic ed esegui tramite Claude CLI». claude-cli non è l’ID di un harness incorporato e non deve essere passato alla selezione di AgentHarness.

​

Superfici Codex

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

1. Collegamento/controllo/thread/ripresa/guida/arresto di Codex -> superficie nativa dei comandi /codex quando il plugin codex incluso è abilitato.
2. Codex come runtime incorporato o la normale esperienza dell’agente Codex basata su abbonamento -> openai/<model>.
3. OpenClaw scelto esplicitamente per un modello OpenAI -> mantieni il riferimento al modello come openai/<model> e imposta il criterio di runtime del provider/modello su agentRuntime.id: "openclaw". Un profilo OAuth openai selezionato viene instradato internamente tramite il trasporto di autenticazione Codex di OpenClaw.
4. Riferimenti obsoleti ai modelli Codex nella configurazione -> correggili con openclaw doctor --fix trasformandoli in openai/<model>; doctor mantiene il percorso di autenticazione Codex aggiungendo agentRuntime.id: "codex" specifico per provider/modello quando il vecchio riferimento al modello lo implicava. I riferimenti obsoleti ai modelli codex-cli/* vengono corretti nello stesso percorso Codex app-server openai/<model>; OpenClaw non mantiene più un backend CLI Codex incluso.
5. ACP, acpx o adattatore ACP Codex richiesto esplicitamente -> runtime: "acp" e agentId: "codex".
6. Claude Code, Gemini CLI, OpenCode, Cursor, Droid o un altro harness esterno -> ACP/acpx, non il runtime nativo dei sotto-agenti.

​

Responsabilità del runtime

​

Selezione del runtime

1. Il criterio di runtime specifico per il modello ha la precedenza. Si trova in una voce di modello di un provider configurato oppure in agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime. Un carattere jolly del provider come agents.defaults.models["vllm/*"].agentRuntime si applica dopo il criterio esatto del modello, così i modelli del provider rilevati dinamicamente possono condividere un runtime senza sostituire le eccezioni esatte per singolo modello.
2. Criterio di runtime specifico per il provider: models.providers.<provider>.agentRuntime.
3. Modalità auto: i runtime dei plugin registrati possono rivendicare le coppie provider/modello supportate.
4. Se nessuno rivendica il turno in modalità auto, OpenClaw usa openclaw come runtime di compatibilità. Usa un ID di runtime esplicito quando l’esecuzione deve essere rigorosa.

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

​

Runtime dell’agente GitHub Copilot

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

​

Contratto di compatibilità

​

Etichette di stato

• Un riferimento al modello come openai/gpt-5.6-sol indica il provider/modello selezionato.
• Un ID di runtime come codex indica il ciclo che esegue il turno.
• Un’etichetta di canale come Telegram o Discord indica dove si svolge la conversazione.

​

Contenuti correlati

• Harness Codex
• Runtime dell’harness Codex
• Runtime dell’agente GitHub Copilot
• OpenAI
• Plugin per harness di agenti
• Ciclo dell’agente
• Modelli
• Stato