Environnements d’exécution des agents

• Les harnais intégrés s’exécutent dans la boucle d’agent préparée d’OpenClaw. Aujourd’hui, cela comprend le runtime openclaw intégré ainsi que les harnais de Plugin enregistrés, tels que codex et copilot.
• Les backends CLI exécutent un processus CLI local tout en conservant la référence de modèle canonique. Par exemple, anthropic/claude-opus-4-8 avec un agentRuntime.id: "claude-cli" scopé au modèle signifie « sélectionner le modèle Anthropic, exécuter via Claude CLI ». claude-cli n’est pas un identifiant de harnais intégré et ne doit pas être transmis à la sélection AgentHarness.

​

Surfaces Codex

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

1. Si l’utilisateur demande liaison/contrôle/fil/reprise/orientation/arrêt Codex, utilisez la surface de commande native /codex lorsque le Plugin codex intégré est activé.
2. Si l’utilisateur demande Codex comme runtime intégré ou souhaite l’expérience normale d’agent Codex adossée à un abonnement, utilisez openai/<model>.
3. Si l’utilisateur choisit explicitement OpenClaw pour un modèle OpenAI, conservez la référence de modèle sous la forme openai/<model> et définissez la politique de runtime fournisseur/modèle sur agentRuntime.id: "openclaw". Un profil OAuth openai sélectionné est acheminé en interne via le transport d’authentification Codex d’OpenClaw.
4. Si l’ancienne configuration contient encore des références de modèle Codex héritées, réparez-la en openai/<model> avec openclaw doctor --fix ; doctor conserve la route d’authentification Codex en ajoutant agentRuntime.id: "codex" scopé au fournisseur/modèle lorsque l’ancienne référence de modèle l’impliquait. Les anciennes références de modèle codex-cli/* sont réparées vers la même route de serveur d’application Codex openai/<model> ; OpenClaw ne conserve plus de backend CLI Codex intégré.
5. Si l’utilisateur dit explicitement ACP, acpx ou adaptateur ACP Codex, utilisez ACP avec runtime: "acp" et agentId: "codex".
6. Si la demande concerne Claude Code, Gemini CLI, OpenCode, Cursor, Droid ou un autre harnais externe, utilisez ACP/acpx, pas le runtime de sous-agent natif.

​

Propriété du runtime

• Si OpenClaw possède la surface, OpenClaw peut fournir le comportement normal des hooks de Plugin.
• Si le runtime natif possède la surface, OpenClaw a besoin d’événements de runtime ou de hooks natifs.
• Si le runtime natif possède l’état de fil canonique, OpenClaw doit refléter et projeter le contexte, pas réécrire des internes non pris en charge.

​

Sélection du runtime

1. La politique de runtime scopée au modèle prévaut. Elle peut se trouver dans une entrée de modèle de fournisseur configurée ou dans agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime. Un joker de fournisseur comme agents.defaults.models["vllm/*"].agentRuntime s’applique après la politique de modèle exacte, afin que les modèles de fournisseur découverts dynamiquement puissent partager un même runtime sans remplacer les exceptions exactes par modèle.
2. La politique de runtime scopée au fournisseur vient ensuite à models.providers.<provider>.agentRuntime.
3. En mode auto, les runtimes de Plugin enregistrés peuvent revendiquer les paires fournisseur/modèle prises en charge.
4. Si aucun runtime ne revendique un tour en mode auto, OpenClaw utilise openclaw comme runtime de compatibilité. Utilisez un identifiant de runtime explicite lorsque l’exécution doit être stricte.

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

​

Runtime d’agent GitHub Copilot

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

​

Contrat de compatibilité

​

Libellés d’état

• Une référence de modèle telle que openai/gpt-5.5 indique le fournisseur/modèle sélectionné.
• Un identifiant de runtime tel que codex indique quelle boucle exécute le tour.
• Un libellé de canal tel que Telegram ou Discord indique où la conversation a lieu.

​

Connexe

• Harness Codex
• Runtime de harness Codex
• Runtime d’agent GitHub Copilot
• OpenAI
• Plugins de harness d’agent
• Boucle d’agent
• Modèles
• État