Environnements d’exécution des agents

Documentation Index

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

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

• Les harnesses intégrés s’exécutent dans la boucle d’agent préparée d’OpenClaw. Aujourd’hui, cela correspond au runtime pi intégré ainsi qu’aux harnesses de plugins enregistrés comme codex.
• Les backends CLI exécutent un processus CLI local tout en conservant la ref de modèle canonique. Par exemple, anthropic/claude-opus-4-7 avec agentRuntime.id: "claude-cli" au niveau du modèle signifie « sélectionner le modèle Anthropic, exécuter via Claude CLI ». claude-cli n’est pas un id de harness 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 Codex bind/control/thread/resume/steer/stop, 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 PI pour un modèle OpenAI, conservez la ref de modèle sous la forme openai/<model> et définissez la politique de runtime fournisseur/modèle sur agentRuntime.id: "pi". Un profil d’authentification openai-codex sélectionné est routé en interne via le transport d’authentification Codex hérité de PI.
4. Si la configuration héritée contient encore des refs de modèle openai-codex/*, réparez-la en openai/<model> avec openclaw doctor --fix ; doctor conserve la route d’authentification Codex en ajoutant agentRuntime.id: "codex" au niveau fournisseur/modèle lorsque l’ancienne ref de modèle l’impliquait.
5. Si l’utilisateur dit explicitement ACP, acpx ou adaptateur Codex ACP, utilisez ACP avec runtime: "acp" et agentId: "codex".
6. Si la demande concerne Claude Code, Gemini CLI, OpenCode, Cursor, Droid ou un autre harness 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 canonique du fil, OpenClaw doit refléter et projeter le contexte, sans réécrire des éléments internes non pris en charge.

​

Sélection du runtime

1. La politique de runtime au niveau du modèle l’emporte. Elle peut se trouver dans une entrée de modèle fournisseur configurée ou dans agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime.
2. La politique de runtime au niveau du fournisseur vient ensuite à models.providers.<provider>.agentRuntime.
3. En mode auto, les runtimes de plugins 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 PI comme runtime de compatibilité. Utilisez un id de runtime explicite lorsque l’exécution doit être stricte.

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

​

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

• Harnais Codex
• Runtime du harnais Codex
• OpenAI
• Plugins de harnais d’agent
• Boucle d’agent
• Modèles
• État