Agent-Laufzeiten

• Eingebettete Harnesses laufen innerhalb der vorbereiteten Agent-Schleife von OpenClaw. Heute umfasst dies die integrierte Runtime openclaw sowie registrierte Plugin-Harnesses wie codex und copilot.
• CLI-Backends führen einen lokalen CLI-Prozess aus, während die Modellreferenz kanonisch bleibt. Zum Beispiel bedeutet anthropic/claude-opus-4-8 mit einer modellbezogenen Einstellung agentRuntime.id: "claude-cli": „Anthropic-Modell auswählen, über Claude CLI ausführen.“ claude-cli ist keine eingebettete Harness-ID und darf nicht an die AgentHarness-Auswahl übergeben werden.

​

Codex-Oberflächen

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

1. Wenn der Benutzer Codex-Bindung/-Steuerung/-Thread/-Fortsetzung/-Lenkung/-Stopp anfordert, verwenden Sie die native /codex-Befehlsoberfläche, wenn das gebündelte codex-Plugin aktiviert ist.
2. Wenn der Benutzer Codex als eingebettete Runtime anfordert oder die normale, abonnementgestützte Codex-Agent-Erfahrung möchte, verwenden Sie openai/<model>.
3. Wenn der Benutzer ausdrücklich OpenClaw für ein OpenAI-Modell auswählt, behalten Sie die Modellreferenz als openai/<model> bei und setzen Sie die Provider-/Modell-Runtime-Richtlinie auf agentRuntime.id: "openclaw". Ein ausgewähltes openai-OAuth-Profil wird intern über OpenClaws Codex-Auth-Transport geroutet.
4. Wenn die alte Konfiguration noch veraltete Codex-Modellreferenzen enthält, reparieren Sie sie mit openclaw doctor --fix zu openai/<model>; doctor behält die Codex-Authentifizierungsroute bei, indem es dort, wo die alte Modellreferenz dies implizierte, eine Provider-/modellbezogene agentRuntime.id: "codex" hinzufügt. Veraltete codex-cli/*-Modellreferenzen werden auf dieselbe openai/<model>-Codex-App-Server-Route repariert; OpenClaw behält kein gebündeltes Codex-CLI-Backend mehr bei.
5. Wenn der Benutzer ausdrücklich ACP, acpx oder Codex-ACP-Adapter sagt, verwenden Sie ACP mit runtime: "acp" und agentId: "codex".
6. Wenn die Anfrage Claude Code, Gemini CLI, OpenCode, Cursor, Droid oder einen anderen externen Harness betrifft, verwenden Sie ACP/acpx, nicht die native Sub-Agent-Runtime.

​

Runtime-Zuständigkeit

• Wenn OpenClaw die Oberfläche besitzt, kann OpenClaw normales Plugin-Hook-Verhalten bereitstellen.
• Wenn die native Runtime die Oberfläche besitzt, benötigt OpenClaw Runtime-Ereignisse oder native Hooks.
• Wenn die native Runtime den kanonischen Thread-Zustand besitzt, sollte OpenClaw Kontext spiegeln und projizieren, nicht nicht unterstützte Interna umschreiben.

​

Runtime-Auswahl

1. Modellbezogene Runtime-Richtlinie gewinnt. Diese kann in einem konfigurierten Provider-Modelleintrag oder in agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime stehen. Ein Provider-Wildcard wie agents.defaults.models["vllm/*"].agentRuntime gilt nach exakter Modellrichtlinie, sodass dynamisch erkannte Provider-Modelle eine Runtime teilen können, ohne exakte Ausnahmen pro Modell zu überschreiben.
2. Provider-bezogene Runtime-Richtlinie folgt unter models.providers.<provider>.agentRuntime.
3. Im Modus auto können registrierte Plugin-Runtimes unterstützte Provider-/Modellpaare beanspruchen.
4. Wenn im Modus auto keine Runtime einen Turn beansprucht, verwendet OpenClaw openclaw als Kompatibilitäts-Runtime. Verwenden Sie eine explizite Runtime-ID, wenn der Lauf strikt sein muss.

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

​

GitHub Copilot-Agent-Runtime

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

​

Kompatibilitätsvertrag

​

Statuslabels

• Eine Modellreferenz wie openai/gpt-5.5 zeigt Ihnen den ausgewählten Provider bzw. das ausgewählte Modell.
• Eine Runtime-ID wie codex zeigt Ihnen, welche Schleife den Turn ausführt.
• Ein Kanal-Label wie Telegram oder Discord zeigt Ihnen, wo die Unterhaltung stattfindet.

​

Verwandt

• Codex-Harness
• Codex-Harness-Runtime
• GitHub Copilot-Agent-Runtime
• OpenAI
• Agent-Harness-Plugins
• Agent-Schleife
• Modelle
• Status