OpenClaw-Codex-Harness: Sitzungen, Zugangsdaten und Abrechnung

Das OpenClaw-Codex-Harness ist das offizielle @openclaw/codex-Plugin: Es übergibt einen OpenClaw-Agenten-Turn an den Codex-App-Server von OpenAI, sodass Codex die Modellscheife, das Fortsetzen von Threads, die Tool-Fortsetzung und die Komprimierung übernimmt. Es ist kein Produkt zur Delegation von Programmieraufgaben, keine Abrechnungsschicht und — der Punkt, der die meisten Einrichtungsversuche scheitern lässt — keine Möglichkeit, Codex gegen einen API-Endpunkt eines Drittanbieters auszuführen. Welche dieser Funktionen Sie tatsächlich benötigen, ist die Entscheidung, die diese Seite erleichtern soll.

Zuerst die Daten, damit nichts hier undatiert bleibt. Das npm-Paket openclaw steht bei 2026.9.5 und erfordert Node >=24.16.0 <25 || >=26.1.0; @openclaw/codex steht ebenfalls bei 2026.9.5 und wurde am 18. September 2026 veröffentlicht. Beide wurden am 21. September 2026 aus der Registry gelesen. Drei voneinander unabhängige Projekte tragen diese Namen, und keine ihrer Zahlen gehört hierher: pjasicek/OpenClaw bezeichnet sich als Nachbildung des Plattformspiels Captain Claw von 1997, das unqualifizierte npm-Paket codex ist ein „Generator für statische Websites und Codedokumentation“, zuletzt 2012 veröffentlicht, und OpenAIs CLI ist @openai/codex (am selben Datum 0.155.1).

Fünf OpenClaw-Oberflächen tragen den Namen „Codex“

OpenClaws Dokumentation zu Agentenlaufzeiten nennt diese „absichtlich unabhängig“. Die falsche Auswahl ist der häufigste Grund dafür, dass eine Konfiguration korrekt aussieht, aber nichts bewirkt.

Ein sechster Name gehört überhaupt nicht zu OpenClaw. openclaw-code-agent ist ein Plugin eines Drittanbieters, das Hintergrund-Programmiersitzungen mit Planfreigabe und Worktree-Isolierung ausführt; in seiner eigenen README steht, dass es vom enthaltenen acpx-Laufzeit-Plugin und dem enthaltenen Core-codex-Plugin von OpenClaw getrennt ist. Wenn Sie hierher kamen, weil Sie Delegation statt eines Laufzeitwechsels wollten, handelt es sich um ein anderes Produkt mit anderen Konfigurationsschlüsseln.

Das Harness aktivieren und nachweisen, dass es aktiviert ist

Der dokumentierte Weg umfasst zwei Befehle — zuerst das Plugin, dann die Anmeldung.

openclaw plugins install @openclaw/codex
openclaw models auth login --provider openai

Danach die Minimalkonfiguration. Wenn Sie eine plugins.allow-Liste verwenden, fügen Sie auch "codex" hinzu.

{
  plugins: {
    entries: {
      codex: {
        enabled: true,
      },
    },
  },
  agents: {
    defaults: {
      // The docs' own example ref. Legacy codex-cli/* refs are
      // repaired to the same openai/<model> route by doctor --fix.
      model: "openai/gpt-6-astra",
    },
  },
}

Zwei Punkte, zu denen die Harness-Dokumentation ausdrücklich ist. Änderungen an der Plugin-Konfiguration werden im hybriden Neulademodus automatisch angewendet; ein bestehender Chat benötigt jedoch zuerst /new oder /reset, damit der nächste Turn das Harness aus der aktuellen Konfiguration auflöst. Außerdem muss das effektive Tool-Profil native Shell- und Dateisystemfunktionen erlauben: coding und full tun dies, während messaging und minimal die native Oberfläche deaktivieren. Eine gewöhnliche OpenClaw-Sandbox oder eine eingeschränkte Tool-Richtlinie ist laut derselben Dokumentation eine noch engere Einschränkung — sie deaktiviert den nativen Codemodus, sofern Sie nicht den experimentellen Sandbox-Exec-Server-Weg aktivieren. Wenn Sandboxing die native Oberfläche deaktiviert, bleiben erlaubte Shell-Befehle über sandbox_exec erreichbar.

Versionsanforderungen, am 21. September 2026 anhand der Referenz zum App-Server-Transport geprüft: Das Plugin verwaltet Codex App-Server 0.154.0, während explizite benutzerdefinierte ausführbare Dateien, entfernte App-Server und macOS-Desktop-Binärdateien eine analysierbare semantische Version von 0.149.0 oder höher melden müssen. Die neueste npm-Version von @openai/codex ist am selben Tag 0.155.1, sodass der verwaltete Pin einen Patch hinterherhinkt — deshalb veraltet jedes Tutorial ohne Datum, das „Codex latest“ sagt, innerhalb weniger Tage. Auch die Migration einer älteren Einrichtung ist relevant: Auf der Agentenlaufzeiten-Seite steht, dass OpenClaws enthaltenes Codex-CLI-Backend in v2026.5.14 entfernt wurde und dass alte codex-cli/*-Referenzen unter openclaw doctor --fix auf denselben openai/<model>-Codex-App-Server-Weg repariert werden, der die Reparatur alter Codex-Wege im Allgemeinen übernimmt.

Zur Überprüfung: Ein Codex-gestützter Turn meldet Runtime: OpenAI Codex unter /status; /codex status, /codex models und /codex binding prüfen den Zustand des App-Servers. Ein Lint — openclaw doctor --lint --only codex/managed-app-server --json — überprüft die verwaltete Binärdatei, aber die Dokumentation beschreibt es als nur lesend und schließt eine ausgewählte Codex-Desktop-Binärdatei, einen expliziten benutzerdefinierten Befehl und einen entfernten App-Server aus dieser Paketprüfung aus.

Eine Spannung, die Sie kennen sollten, bevor Sie darauf aufbauen. OpenAIs eigene App-Server-Dokumentation erklärt, dass „der App-Server-Befehl und der WebSocket-Transport experimentell sind und für Produktions-Workloads nicht unterstützt werden“ — beachten Sie, dass die Warnung sowohl den Befehl als auch den Transport nennt. OpenClaw baut auf diesem Befehl eine ausgelieferte Funktion auf; sein Feld transport steht standardmäßig auf stdio, während websocket nur verwendet wird, wenn Sie ein url konfigurieren. Beide Aussagen sind gleichzeitig wahr; entscheiden Sie unter Berücksichtigung beider Punkte.

Delegationsartefakte, Berechtigungen, Abbrechen und Fortsetzen

Die Harness-Dokumentation ist ehrlich über die Grenzen dessen, was der Status eines nativen Subagenten beweist: Ausführung, Aufgabenergebnis und Ergebnisübermittlung sind separate Tatsachen; ein untätiger, unterbrochener oder entladener nativer Thread beweist nicht, dass die Aufgabe erfolgreich war. Wenn keine abschließende Bestätigung verfügbar ist, fordert die Aufgabe Sie auf, das Schließen erneut zu versuchen. Native Codex-Subagenten sind Codex’ eigener Mechanismus — eine ausdrückliche Delegation durch OpenClaw oder ACP läuft weiterhin über sessions_spawn.

Laut der Tabelle der Konfigurationsfelder des Plugins sind die Ausführungsberechtigungen für den App-Server, den OpenClaw startet, standardmäßig auf Modus yolo, Genehmigungsrichtlinie never und Sandbox danger-full-access gesetzt, sofern lokale Codex-Anforderungen diese Einstellung nicht verbieten. In diesem Fall bevorzugen die Guardian-Standardeinstellungen Genehmigungen auf Anfrage und workspace-write, andernfalls read-only; requestTimeoutMs, das Timeout für App-Server-Aufrufe der Steuerebene, steht standardmäßig auf 60000. Dies sind OpenClaw-Standardeinstellungen für den gestarteten Prozess, nicht die des Codex CLI. Bei einem unbekannten Repository ist die erste Standardeinstellung diejenige, die Sie vor dem ersten Lauf überprüfen sollten.

Die Steuerung während eines Turns ist nativ: /codex stop, /codex steer, /codex resume, /codex detach, /codex bind, /codex compact, /codex threads, /codex goal, /codex model, /codex fast und /codex permissions. Ein eingeschränkter Turn gilt pro Turn und nicht als Sitzungsmodus; er deaktiviert für diesen Turn den nativen Codemodus, Umgebungsauswahlen, konfigurierte MCP-Server und native Hook-Weiterleitungen. OpenClaws Supportvertrag für Laufzeit v1 führt außerdem als nicht unterstützt auf: native Änderung von Tool-Argumenten (Pre-Tool-Hooks können blockieren, aber OpenClaw schreibt die Argumente nicht um), einen bearbeitbaren nativen Codex-Transkriptverlauf, Eingriffe in die Komprimierung und eine bytegenaue Aufzeichnung der Modell-API-Anfrage — wenn Ihre Prüfanforderung die exakte ausgehende Anfrage ist, kann diese Laufzeit sie nicht liefern.

Autorisierung, Planberechtigung und Tokenverbrauch sind drei verschiedene Dinge

Aus OpenClaws Richtlinienseite zum Codex-App-Server vom 21. September 2026. Darüber liegt eine weitere Namensfalle: Auf OpenAIs API-Preisseite steht, dass Priority processing am 30. Juli 2026 in Fast mode umbenannt wurde und dass Sie service_tier entweder von "priority" oder "fast" senden können, während OpenClaws appServer.serviceTier "priority" und "flex" dokumentiert und ein altes "fast" auf "priority" normalisiert — also in die entgegengesetzte Richtung. „Fast mode aktivieren“ bedeutet in den beiden Systemen Unterschiedliches.

Warum ein Drittanbieter-Endpunkt das Harness verlässt

Dies ist die eine Tatsache, die die meisten Beiträge von Drittanbietern falsch darstellen. OpenClaws implizite Agent-Runtime-Tabelle für eine nicht gesetzte oder auf auto gesetzte Provider- oder Modell-Runtime lautet:

Wenn Sie OpenClaw also auf eine beliebige Base-URL eines Drittanbieters verweisen – Kunavo eingeschlossen –, wird der Turn absichtlich über OpenClaws integrierte Runtime ausgeführt. Das Präfix openai/* allein wählt niemals das Harness aus, und das Erzwingen von agentRuntime.id: "codex" kann dies nicht beheben. Auf der Runtimes-Seite steht, dass diese Einstellung „ein registriertes Codex-Harness erfordert; nicht unterstützte Routen/Authentifizierungen schlagen sicher fehl, außer dass vom Autor gesetzte Anfrageüberschreibungen vor der Ausführung Codex' deklarierten OpenClaw-Fallback für exakte Anfragen verwenden können“ – die beiden möglichen Ergebnisse sind also ein fehlgeschlagener Turn oder ein OpenClaw-Turn, und keines davon ist Codex an einem benutzerdefinierten Endpunkt. Auch die dokumentierten Konfigurationsfelder des Plugins enthalten keine Einstellung für eine Model-Base-URL; das einzige dort vorhandene Feld url ist die eigene WebSocket- oder unix://-Adresse des App-Servers. Ob appServer.args eine Provider-Überschreibung in den verwalteten App-Server einschleusen könnte, ist undokumentiert und ungetestet; diese Seite stellt es nicht als Workaround dar.

Eine Route über die integrierte Runtime verändert die Anfrage ebenfalls, und OpenClaws Seite zu benutzerdefinierten Providern legt den Geltungsbereich jeder Regel genau fest. Bei api: "openai-completions" an einem nicht nativen Endpunkt – definiert als jede nicht leere baseUrl, deren Host nicht api.openai.com ist – setzt OpenClaw compat.supportsDeveloperRole zwangsweise auf false und überschreibt ein explizites true. Proxyartige OpenAI-kompatible Routen „überspringen die native, nur für OpenAI geltende Anfrageaufbereitung“: kein service_tier, kein Responses-store, kein Completions-store, keine Hinweise auf den Prompt-Cache, keine OpenAI-kompatible Payload-Aufbereitung für Reasoning und keine verborgenen Attribution-Header. Ohne service_tier auf der Leitung sind der Fast-Modus und Flex auf einer solchen Route nicht auswählbar. Dieselbe Seite bietet stattdessen params.extra_body-Durchleitung für OpenAI-kompatible Completions-Proxys, ein Provider-spezifisches headers und models.providers.<id>.timeoutSeconds für langsame oder entfernte Hosts.

Codex selbst ist die andere Hälfte der Geschichte und großzügiger: Codex' Seite zur erweiterten Konfiguration zeigt, dass ~/.codex/config.toml [model_providers.<id>] mit base_url und env_key unterstützt. Es gibt jedoch eine harte Einschränkung – die Konfigurationsreferenz besagt, dass für model_providers.<id>.wire_api „responses der einzige unterstützte Wert ist und bei Auslassung standardmäßig verwendet wird“. Ein Endpunkt, der nur Chat Completions bereitstellt, kann Codex daher nicht antreiben. Dieselbe Seite zur erweiterten Konfiguration reserviert die integrierten IDs openai, ollama und lmstudio und führt model_provider sowie model_providers unter den Schlüsseln auf, die Codex in einer projektweiten .codex/config.toml ignoriert; Provider-Schlüssel gehören daher in die benutzerweite Konfiguration. Kunavo implementiert eine native Responses-Oberfläche unter /v1/responses, was die Einrichtung der Codex-CLI ermöglicht – es handelt sich jedoch um die eigenständige Codex-CLI, nicht um das OpenClaw-Harness, und Kunavo hat keinen der beiden Clients zur Laufzeit getestet.

Was die Software kostet und was die Tokens kosten

OpenClaw selbst kostet 0 $. Sein Dokumentationsindex beschreibt das Projekt als MIT-lizenziert, gemeinschaftsgetrieben und von einer unabhängigen 501(c)(3)-Stiftung entwickelt, mit „keiner kostenpflichtigen Stufe“; @openclaw/codex wird kostenlos im öffentlichen npm-Registry veröffentlicht. Die tatsächlichen Kosten bestehen aus der Maschine, auf der Sie das Gateway ausführen, plus der Modellnutzung, und die Modellnutzung erfolgt nach einem von drei Verträgen.

Aus OpenAIs Codex-Preisseite, geprüft am 21. September 2026. Drei Hinweise gehören zu dieser Tabelle. Die Preiskarte veröffentlicht für Pro nur „Ab 100 $“; OpenAIs separater Artikel Über die ChatGPT-Pro-Stufen nennt eine höhere Stufe von 200 $, deren Neuanmeldungen und Upgrades seit dem 10. September 2026 pausiert sind. Prüfen Sie den Preis daher beim Checkout, statt einen Betrag einzuplanen, der auf keiner Preiskarte dieser Seite stand. Die enthaltene Nutzung wird nur als geschätzte Spannen lokaler Nachrichten pro Fünfstundenzeitraum veröffentlicht, nicht als feste Nachrichtenanzahl. Und die Guthabenpreise nach den enthaltenen Limits werden in Guthaben pro einer Million Tokens veröffentlicht, ohne Dollarwert für ein Guthaben auf dieser Preisseite – daher liefert sie für diese Zeile keine Dollarumrechnung. Separat wird GPT-5.5 am 14. Oktober 2026 aus ChatGPT, ChatGPT Work und Codex für alle Tarife entfernt, während die OpenAI API nicht betroffen ist.

Der dritte Vertrag ist ein Gateway in OpenClaws integrierter Runtime. Gehen Sie von einem delegierten Turn aus, der 180.000 nicht zwischengespeicherte Eingabe-Tokens sendet und 9.000 Ausgabe-Tokens empfängt; die Tarife sind aktuelle Preise aus dem Kunavo-Katalog pro einer Million Tokens.

Dies ist eine beispielhafte Token-Berechnung, keine gemessenen Aufgabenkosten und keine Abrechnungsobergrenze – die Form des Turns ist eine Annahme, und ein echter Agent-Turn sendet den Kontext bei jeder Tool-Rundreise erneut. Der Katalogbetrag von Kunavo ist eine Abrechnungsuntergrenze, keine Obergrenze: Wenn der Upstream seine Kosten meldet, entspricht die Rechnung dem höheren Wert aus den Katalogkosten und den Upstream-Kosten multipliziert mit dem geltenden Aufschlag. Cache-Gebühren und externe Tools sind in diesem Beispiel nicht enthalten. Die minimale Aufladung beträgt $10 als Prepaid-Guthaben, das ein Guthaben auffüllt, statt einen Tarif zu kaufen – siehe Abrechnungsdetails.

Kunavo stellt kein Embedding-Modell, kein Text-to-Speech-Modell und kein Speech-to-Text-Modell bereit. Diese Schritte werden von Kunavo auf keiner Route angeboten; nutzen Sie dafür einen Provider, der sie bereitstellt.

Diese Abgrenzung ist hier wichtig, weil die obige Oberflächentabelle eine Nicht-Agent-Route der OpenAI Platform vom Harness getrennt hält und ein Gateway-Schlüssel nur die Chat-Modelle im Kunavo-Katalog abdeckt.

Welche Route gewinnt, wenn

Wenn die Gateway-Zeile Ihrer Wahl entspricht, beginnen Sie mit der Codex-CLI-Integration für das Responses-API-Format, vergleichen Sie Optionen in der besten API für OpenClaw und der besten API für Codex und erstellen Sie ein Kunavo-Konto, sobald Sie einen Schlüssel aufladen möchten. Für die Budgetseite eines selbst gehosteten Assistenten trennt OpenClaw-Preise Software, Hosting und Modellausgaben.

Häufig gestellte Fragen

Die Runtime-Tabelle, die Authentifizierungsreihenfolge, der App-Server-Hinweis, die wire_api-Sperre, die Versionsangaben und die Tarifpreise oben wurden am 21. September 2026 aus der eigenen Dokumentation von OpenClaw und OpenAI, dem OpenAI-Hilfezentrum und den npm-Registry-Einträgen für openclaw, @openclaw/codex, @openai/codex, codex und openclaw-code-agent abgerufen. Jede Aussage ist mit der Seite verknüpft, aus der sie stammt; wenn ein Dokument eine Frage nicht klärte, wird dies im Text angegeben, statt die Lücke zu füllen. Kunavo hat weder OpenClaw noch das Codex-Harness zur Laufzeit getestet. Daher wird jede Konfiguration hier anhand der Quelldokumentation geprüft und nicht anhand einer Demonstration mit Kunavos Endpunkt. Die Token-Tarife von Kunavo stammen aus dem aktuellen Katalog, und jeder Dollarbetrag ist eine beispielhafte Berechnung.