Agent-Laufzeitumgebungen

Eine Agent-Laufzeitumgebung besitzt genau eine vorbereitete Modellschleife: Sie empfängt den Prompt, steuert die Modellausgabe, verarbeitet native Werkzeugaufrufe und gibt den abgeschlossenen Durchlauf an OpenClaw zurück.

Laufzeitumgebungen können leicht mit Providern verwechselt werden, da beide in der Nähe der Modellkonfiguration erscheinen. Es handelt sich jedoch um unterschiedliche Schichten:

Ein Harness ist die Implementierung, die eine Agent-Laufzeitumgebung bereitstellt (Codebegriff). Beispielsweise implementiert das mitgelieferte Codex-Harness die Laufzeitumgebung codex. Die öffentliche Konfiguration verwendet agentRuntime.id in Provider- oder Modelleinträgen; Laufzeitschlüssel für den gesamten Agent sind veraltet und werden ignoriert. openclaw doctor --fix entfernt alte Laufzeitbindungen für den gesamten Agent und schreibt veraltete Laufzeit-Modellreferenzen in kanonische Provider-/Modellreferenzen sowie, wo erforderlich, in eine modellspezifische Laufzeitrichtlinie um.

Zwei Laufzeitfamilien:

• Eingebettete Harnesses werden innerhalb der vorbereiteten Agent-Schleife von OpenClaw ausgeführt: die integrierte Laufzeitumgebung openclaw sowie registrierte Plugin-Harnesses wie codex und copilot.
• CLI-Backends führen einen lokalen CLI-Prozess aus, während die Modellreferenz kanonisch bleibt. Beispielsweise bedeutet anthropic/claude-opus-4-8 mit einem modellspezifischen agentRuntime.id: "claude-cli": „Wählen Sie das Anthropic-Modell aus und führen Sie es über Claude CLI aus.“ claude-cli ist keine ID eines eingebetteten Harnesses und darf nicht an die AgentHarness-Auswahl übergeben werden.

Das copilot-Harness ist ein separates, optionales externes Plugin-Harness für die GitHub Copilot CLI; unter GitHub-Copilot-Agent-Laufzeitumgebung finden Sie die benutzerorientierte Entscheidung zwischen PI, Codex und der GitHub-Copilot-Agent-Laufzeitumgebung.

Codex-Oberflächen

Mehrere Oberflächen verwenden den Namen Codex:

Diese Oberflächen sind absichtlich voneinander unabhängig. Durch Aktivieren des Plugins codex werden native App-Server-Funktionen verfügbar; openclaw doctor --fix ist für die Reparatur veralteter Codex-Routen und die Bereinigung veralteter Sitzungsbindungen zuständig. Die Auswahl von openai/* für ein Agent-Modell bedeutet nun „über Codex ausführen“, sofern keine Nicht-Agent-Oberfläche der OpenAI API verwendet wird.

Die übliche Einrichtung für ChatGPT-/Codex-Abonnements verwendet Codex OAuth zur Authentifizierung, behält jedoch openai/* als Modellreferenz bei und wählt die Laufzeitumgebung codex aus:

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

Das bedeutet, dass OpenClaw eine OpenAI-Modellreferenz auswählt und anschließend die Codex-App-Server-Laufzeitumgebung auffordert, den eingebetteten Agent-Durchlauf auszuführen. Es bedeutet weder „API-Abrechnung verwenden“, noch bedeutet es, dass der Kanal, der Modell-Provider-Katalog oder der Sitzungsspeicher von OpenClaw zu Codex wird.

Wenn das mitgelieferte Plugin codex aktiviert ist, verwenden Sie für die natürlichsprachliche Codex-Steuerung die native /codex-Befehlsoberfläche (/codex bind, /codex threads, /codex resume, /codex steer, /codex stop) anstelle von ACP. Verwenden Sie ACP für Codex nur, wenn der Benutzer ausdrücklich ACP/acpx anfordert oder den ACP-Adapterpfad testet. Claude Code, Gemini CLI, OpenCode, Cursor und ähnliche externe Harnesses verwenden weiterhin ACP.

Entscheidungsbaum:

1. Codex-Bindung/-Steuerung/-Thread/-Fortsetzung/-Lenkung/-Beendigung -> native /codex-Befehlsoberfläche, wenn das mitgelieferte Plugin codex aktiviert ist.
2. Codex als eingebettete Laufzeitumgebung oder die normale, abonnementgestützte Codex-Agent-Nutzung -> openai/<model>.
3. OpenClaw wurde ausdrücklich für ein OpenAI-Modell ausgewählt -> Behalten Sie openai/<model> als Modellreferenz bei und setzen Sie die Provider-/Modell-Laufzeitrichtlinie auf agentRuntime.id: "openclaw". Ein ausgewähltes openai-OAuth-Profil wird intern über den Codex-Authentifizierungstransport von OpenClaw geleitet.
4. Veraltete Codex-Modellreferenzen in der Konfiguration -> Reparieren Sie sie mit openclaw doctor --fix zu openai/<model>; Doctor behält die Codex-Authentifizierungsroute bei, indem dort, wo die alte Modellreferenz dies implizierte, ein Provider-/modellspezifisches agentRuntime.id: "codex" hinzugefügt wird. Veraltete codex-cli/*-Modellreferenzen werden auf dieselbe Codex-App-Server-Route openai/<model> umgestellt; OpenClaw stellt kein mitgeliefertes Codex-CLI-Backend mehr bereit.
5. ACP, acpx oder der Codex-ACP-Adapter wird ausdrücklich angefordert -> runtime: "acp" und agentId: "codex".
6. Claude Code, Gemini CLI, OpenCode, Cursor, Droid oder ein anderes externes Harness -> ACP/acpx, nicht die native Subagent-Laufzeitumgebung.

Zur Aufteilung der Präfixe innerhalb der OpenAI-Familie siehe OpenAI und Modell-Provider. Den Unterstützungsvertrag für die Codex-Laufzeitumgebung finden Sie unter Codex-Harness-Laufzeitumgebung.

Zuständigkeit der Laufzeitumgebung

Unterschiedliche Laufzeitumgebungen sind für unterschiedlich große Teile der Schleife zuständig:

Entwurfsregel: Wenn OpenClaw für die Oberfläche zuständig ist, kann es das normale Verhalten von Plugin-Hooks bereitstellen. Wenn die native Laufzeitumgebung für die Oberfläche zuständig ist, benötigt OpenClaw Laufzeitereignisse oder native Hooks. Wenn die native Laufzeitumgebung für den kanonischen Thread-Zustand zuständig ist, spiegelt OpenClaw den Kontext und projiziert ihn, anstatt nicht unterstützte Interna umzuschreiben.

Auswahl der Laufzeitumgebung

OpenClaw bestimmt eine eingebettete Laufzeitumgebung nach der Provider- und Modellauflösung in dieser Reihenfolge:

1. Die modellspezifische Laufzeitrichtlinie hat Vorrang. Sie befindet sich in einem konfigurierten Modell-Eintrag des Providers oder in agents.defaults.models["provider/model"].agentRuntime / agents.list[].models["provider/model"].agentRuntime. Ein Provider-Platzhalter wie agents.defaults.models["vllm/*"].agentRuntime wird nach der exakten Modellrichtlinie angewendet, sodass dynamisch erkannte Provider-Modelle eine Laufzeitumgebung gemeinsam verwenden können, ohne exakte modellspezifische Ausnahmen zu überschreiben.
2. Providerspezifische Laufzeitrichtlinie: models.providers.<provider>.agentRuntime.
3. Modus auto: Registrierte Plugin-Laufzeitumgebungen können unterstützte Provider-/Modellpaare für sich beanspruchen.
4. Wenn im Modus auto keine Laufzeitumgebung den Durchlauf übernimmt, greift OpenClaw aus Kompatibilitätsgründen auf openclaw zurück. Verwenden Sie eine ausdrückliche Laufzeit-ID, wenn die Ausführung strikt sein muss.

Laufzeitbindungen für die gesamte Sitzung und den gesamten Agent werden ignoriert: OPENCLAW_AGENT_RUNTIME, der Sitzungszustand agentHarnessId/agentRuntimeOverride, agents.defaults.agentRuntime und agents.list[].agentRuntime. Führen Sie openclaw doctor --fix aus, um veraltete Laufzeitkonfigurationen für den gesamten Agent zu entfernen und veraltete Laufzeit-Modellreferenzen umzuwandeln, sofern die Absicht erhalten werden kann.

Explizite Provider-/Modell-Plugin-Laufzeitumgebungen schlagen geschlossen fehl: agentRuntime.id: "codex" für einen Provider oder ein Modell bedeutet Codex oder einen eindeutigen Auswahl-/Laufzeitfehler – es wird niemals stillschweigend zu OpenClaw zurückgeleitet. Nur auto darf einen nicht zugeordneten Durchlauf an OpenClaw weiterleiten.

Aliasse für CLI-Backends unterscheiden sich von den IDs eingebetteter Harnesses. Bevorzugte Form für Claude CLI:

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

Veraltete Referenzen wie claude-cli/claude-opus-4-7 werden aus Kompatibilitätsgründen weiterhin unterstützt, neue Konfigurationen sollten jedoch die Provider-/Modellreferenz kanonisch halten und das Ausführungs-Backend in der Provider-/Modell-Laufzeitrichtlinie festlegen.

Veraltete codex-cli/*-Referenzen unterscheiden sich davon: Doctor migriert sie zu openai/*, sodass sie über das Codex-App-Server-Harness ausgeführt werden, statt ein Codex-CLI-Backend beizubehalten.

Der Modus auto ist für die meisten Provider bewusst konservativ. OpenAI-Agent-Modelle bilden die Ausnahme: Sowohl eine nicht gesetzte Laufzeitumgebung als auch auto werden zum Codex-Harness aufgelöst. Eine explizite OpenClaw-Laufzeitkonfiguration bleibt eine optionale Kompatibilitätsroute für openai/*-Agent-Durchläufe; in Verbindung mit einem ausgewählten openai-OAuth-Profil leitet OpenClaw diesen Pfad intern über den Codex-Authentifizierungstransport, während die öffentliche Modellreferenz openai/* bleibt. Veraltete OpenAI-Laufzeitbindungen in Sitzungen werden bei der Laufzeitauswahl ignoriert und können mit openclaw doctor --fix bereinigt werden.

Wenn openclaw doctor davor warnt, dass das Plugin codex aktiviert ist, während die Konfiguration noch veraltete Codex-Modellreferenzen enthält, behandeln Sie dies als veralteten Routenzustand und führen Sie openclaw doctor --fix aus, um ihn mit der Codex-Laufzeitumgebung zu openai/* umzuschreiben.

GitHub-Copilot-Agent-Laufzeitumgebung

Das externe Plugin @openclaw/copilot registriert eine optionale copilot-Laufzeit, die auf der GitHub Copilot CLI (@github/copilot-sdk) basiert. Es beansprucht den kanonischen Abonnement-Provider github-copilot und wird von auto niemals ausgewählt. Aktivieren Sie es pro Modell oder pro Provider über agentRuntime.id:

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

Das Harness beansprucht seinen Provider, seine Laufzeit, seinen CLI-Sitzungsschlüssel und das Präfix seines Authentifizierungsprofils in extensions/copilot/doctor-contract-api.ts, das openclaw doctor automatisch lädt. Informationen zu Konfiguration, Authentifizierung, Transkriptspiegelung, Compaction, dem deklarativen Doctor-Vertrag und der umfassenderen Entscheidung zwischen PI, Codex und Copilot SDK finden Sie unter GitHub-Copilot-Agentenlaufzeit.

Kompatibilitätsvertrag

Wenn eine Laufzeit nicht zu OpenClaw gehört, sollte ihre Dokumentation angeben, welche OpenClaw-Oberflächen sie unterstützt:

Der Unterstützungsvertrag für die Codex-Laufzeit ist unter Codex-Harness-Laufzeit dokumentiert.

Statusbezeichnungen

Die Statusausgabe kann sowohl die Bezeichnungen Execution als auch Runtime anzeigen. Betrachten Sie diese als Diagnoseangaben, nicht als Provider-Namen:

• Eine Modellreferenz wie openai/gpt-5.6-sol bezeichnet den ausgewählten Provider und das ausgewählte Modell.
• Eine Laufzeit-ID wie codex bezeichnet die Schleife, die den Durchlauf ausführt.
• Eine Kanalbezeichnung wie Telegram oder Discord gibt an, wo die Unterhaltung stattfindet.

Wenn ein Lauf eine unerwartete Laufzeit anzeigt, prüfen Sie zuerst die Laufzeitrichtlinie des ausgewählten Providers und Modells. Veraltete Laufzeitfixierungen für Sitzungen bestimmen das Routing nicht mehr.

Verwandte Themen

• Codex-Harness
• Codex-Harness-Laufzeit
• GitHub-Copilot-Agentenlaufzeit
• OpenAI
• Agenten-Harness-Plugins
• Agentenschleife
• Modelle
• Status