Harness Codex d’OpenClaw : sessions, identifiants et facturation

Le harnais OpenClaw Codex est le plugin officiel @openclaw/codex : il confie un tour d’agent OpenClaw à l’app-server Codex d’OpenAI afin que Codex prenne en charge la boucle du modèle, la reprise du thread, la continuation des outils et la compaction. Il ne s’agit ni d’un produit de délégation de programmation, ni d’une couche de facturation et — c’est le point qui fait trébucher la plupart des configurations — ni d’un moyen d’exécuter Codex avec un endpoint d’API tiers. La décision que cette page doit vous aider à prendre est de déterminer lequel de ces besoins est réellement le vôtre.

Commençons par les dates, afin que rien ne soit présenté sans date. Le package npm openclaw est en version 2026.9.5 et exige Node >=24.16.0 <25 || >=26.1.0 ; @openclaw/codex est également en version 2026.9.5, publiée le 18 septembre 2026. Les deux ont été lus dans le registre le 21 septembre 2026. Trois projets sans rapport partagent ces noms, et aucun de leurs numéros ne doit être pris en compte ici : pjasicek/OpenClaw se décrit comme une réimplémentation du jeu de plateforme Captain Claw de 1997, le package npm nu codex est un « générateur de sites statiques et de documentation de code » publié pour la dernière fois en 2012, et la CLI d’OpenAI est @openai/codex (0.155.1 à la même date).

Cinq surfaces OpenClaw partagent le nom « Codex »

La documentation des runtimes d’agents d’OpenClaw les qualifie d’« intentionnellement indépendants ». Choisir le mauvais est la raison la plus courante pour laquelle une configuration semble correcte mais ne fait rien.

Un sixième nom n’appartient pas du tout à OpenClaw. openclaw-code-agent est un plugin tiers qui exécute en arrière-plan des sessions de programmation avec approbation du plan et isolation du worktree ; son propre README précise qu’il est distinct du plugin runtime acpx intégré à OpenClaw et du plugin codex core intégré. Si vous êtes arrivé ici en recherchant la délégation plutôt qu’un remplacement de runtime, il s’agit d’un produit différent, doté de clés de configuration différentes.

Activer le harnais et vérifier qu’il est actif

La procédure documentée consiste en deux commandes — le plugin, puis la connexion.

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

Puis la configuration minimale. Si vous utilisez une liste plugins.allow, ajoutez-y également "codex".

{
  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",
    },
  },
}

Deux détails explicitement indiqués par la documentation du harnais. Les modifications de configuration du plugin s’appliquent automatiquement en mode de rechargement hybride, mais une conversation existante doit d’abord recevoir /new ou /reset afin que le tour suivant résolve le harnais à partir de la configuration actuelle. De plus, le profil d’outils effectif doit autoriser les capacités natives du shell et du système de fichiers : coding et full les autorisent, tandis que messaging et minimal désactivent la surface native. Un bac à sable OpenClaw ordinaire ou une politique d’outils restreinte constitue une restriction plus étroite dans cette même documentation : elle désactive le mode de code natif, sauf si vous activez la voie expérimentale sandbox exec-server ; lorsque le bac à sable désactive effectivement la surface native, les commandes shell autorisées restent accessibles via sandbox_exec.

Exigences de version, vérifiées le 21 septembre 2026 par rapport à la référence du transport app-server : le plugin gère Codex app-server stable 0.154.0, tandis que les exécutables personnalisés explicites, les app-servers distants et les binaires macOS Desktop doivent signaler une version sémantique analysable égale ou supérieure à 0.149.0. Le dernier @openai/codex de npm est en version 0.155.1 le même jour, la version gérée a donc un correctif de retard — raison pour laquelle tout tutoriel indiquant « Codex latest » sans date devient obsolète en quelques jours. La migration d’une ancienne configuration compte également : la page des runtimes d’agents indique que le backend Codex CLI intégré à OpenClaw a été supprimé dans la version v2026.5.14, et que les anciennes références codex-cli/* sont corrigées vers la même route d’app-server Codex openai/<model> sous openclaw doctor --fix, qui gère de manière générale la correction des anciennes routes Codex.

Pour vérifier : un tour pris en charge par Codex signale Runtime: OpenAI Codex sous /status, et /codex status, /codex models et /codex binding inspectent l’état de l’app-server. Un lint — openclaw doctor --lint --only codex/managed-app-server --json — vérifie le binaire géré, mais la documentation le décrit comme étant en lecture seule et exclut de cette vérification un binaire Codex Desktop sélectionné, une commande personnalisée explicite et un app-server distant.

Il existe une tension à connaître avant de vous appuyer sur cette solution. La propre documentation de l’app-server d’OpenAI indique que « la commande app-server et le transport WebSocket sont expérimentaux et ne sont pas pris en charge pour les charges de production » — notez que l’avertissement nomme la commande aussi bien que le transport. OpenClaw construit une fonctionnalité livrée au-dessus de cette commande, et son champ transport vaut par défaut stdio, tandis que websocket n’est utilisé que lorsque vous configurez un url. Les deux affirmations sont vraies simultanément ; prenez votre décision en tenant compte des deux.

Artefacts de délégation, autorisations, annulation et reprise

La documentation du harness est honnête quant aux limites de ce que prouve le statut d’un sous-agent natif : l’exécution, le résultat de la tâche et la remise du résultat sont des faits distincts ; un thread natif inactif, interrompu ou déchargé ne prouve pas que la tâche a réussi et, lorsque la confirmation de fermeture n’est pas disponible, la tâche vous demande de réessayer la fermeture. Les sous-agents Codex natifs constituent le mécanisme propre à Codex — toute délégation explicite OpenClaw ou ACP passe toujours par sessions_spawn.

Selon le tableau des champs de configuration du plugin, les autorisations d’exécution de l’app-server lancé par OpenClaw sont par défaut le mode yolo, la politique d’approbation never et le sandbox danger-full-access, sauf si les exigences locales de Codex interdisent cette posture ; dans ce cas, les valeurs par défaut du guardian privilégient les approbations à la demande et workspace-write, sinon read-only ; requestTimeoutMs, le délai d’expiration des appels du plan de contrôle de l’app-server, est par défaut de 60000. Il s’agit des valeurs par défaut d’OpenClaw pour le processus qu’il lance, et non de celles du CLI Codex ; dans un dépôt inconnu, cette première valeur par défaut est le paramètre à vérifier avant la première exécution.

Le contrôle pendant un tour est natif : /codex stop, /codex steer, /codex resume, /codex detach, /codex bind, /codex compact, /codex threads, /codex goal, /codex model, /codex fast et /codex permissions. Un tour restreint s’applique à chaque tour plutôt qu’au niveau de la session, et désactive uniquement pour ce tour le Code Mode natif, les sélections d’environnement, les serveurs MCP configurés et les relais de hooks natifs. Le contrat de prise en charge du runtime v1 d’OpenClaw répertorie également comme non pris en charge : la modification native des arguments d’outils (les hooks pré-outil peuvent bloquer, mais OpenClaw ne réécrit pas les arguments), un historique de transcript natif Codex modifiable, l’intervention lors de la compaction et la capture octet par octet des requêtes de l’API du modèle — ainsi, si votre exigence d’audit porte sur la requête sortante exacte, ce runtime ne peut pas la fournir.

L’autorisation, l’éligibilité du forfait et la consommation de tokens sont trois choses différentes

Lu sur la page de politique de l’app-server Codex d’OpenClaw le 21 septembre 2026. Un piège de terminologie s’ajoute à cela : la page de tarification de l’API d’OpenAI indique que le traitement prioritaire a été renommé mode Fast le 30 juillet 2026 et que vous pouvez envoyer service_tier de "priority" ou de "fast", tandis que appServer.serviceTier d’OpenClaw documente "priority" et "flex" et normalise un ancien "fast" en "priority" — dans le sens inverse. « Activer le mode Fast » signifie donc des choses différentes dans les deux systèmes.

Pourquoi un endpoint tiers quitte le harness

C’est le fait unique que la plupart des articles tiers présentent à l’envers. Le tableau des runtimes implicites des agents d’OpenClaw, pour un runtime de fournisseur ou de modèle non défini ou égal à auto :

Ainsi, le fait de diriger OpenClaw vers n’importe quelle URL de base tierce — y compris Kunavo — place le tour sur le runtime intégré d’OpenClaw, conformément à la conception. Le préfixe openai/* seul ne sélectionne jamais le harness, et forcer agentRuntime.id: "codex" ne le rétablit pas. La page des runtimes indique que ce paramètre « nécessite un harness Codex enregistré ; les routes ou authentifications non prises en charge échouent de manière fermée, sauf que les remplacements de requête définis par l’auteur peuvent utiliser le fallback OpenClaw exact déclaré par Codex avant l’exécution » — les deux issues sont donc un tour échoué ou un tour OpenClaw, et aucune ne correspond à Codex sur un endpoint personnalisé. Les champs de configuration documentés du plugin ne contiennent pas non plus de paramètre d’URL de base du modèle ; l’unique champ url qui y figure est l’adresse WebSocket ou unix:// propre à l’app-server. Il n’est pas documenté ni testé que appServer.args puisse introduire furtivement un remplacement de fournisseur dans l’app-server géré ; cette page ne le présente donc pas comme solution de contournement.

Une route utilisant un runtime intégré remodèle également la requête, et la page des fournisseurs personnalisés d’OpenClaw précise la portée de chaque règle. Pour api: "openai-completions" sur un endpoint non natif — défini comme tout baseUrl non vide dont l’hôte n’est pas api.openai.com — OpenClaw force compat.supportsDeveloperRole à false et remplace un true explicite. Séparément, les routes de type proxy compatibles OpenAI « ignorent le remaniement natif des requêtes réservé à OpenAI » : pas de service_tier, pas de store Responses, pas de store Completions, pas d’indications de cache de prompt, pas de mise en forme de payload compatible avec le raisonnement OpenAI et pas d’en-têtes d’attribution masqués. Sans service_tier sur le réseau, les modes Fast et Flex ne peuvent pas être sélectionnés sur une telle route. Cette même page propose à la place le relais params.extra_body pour les proxies Completions compatibles OpenAI, headers par fournisseur et models.providers.<id>.timeoutSeconds pour les hôtes lents ou distants.

Codex lui-même constitue l’autre moitié de l’histoire et se montre plus permissif : la page de configuration avancée de Codex montre que ~/.codex/config.toml prend en charge [model_providers.<id>] avec base_url et env_key. Mais il existe une condition stricte — la référence de configuration indique que, pour model_providers.<id>.wire_api, « responses est la seule valeur prise en charge et constitue la valeur par défaut lorsqu’elle est omise ». Un endpoint qui ne sert que Chat Completions ne peut donc pas piloter Codex. La même page de configuration avancée réserve les identifiants intégrés openai, ollama et lmstudio, et répertorie model_provider et model_providers parmi les clés ignorées par Codex dans un .codex/config.toml au niveau du projet ; les clés de fournisseur doivent donc figurer dans la configuration utilisateur. Kunavo implémente une surface Responses native à l’adresse /v1/responses, ce qui rend possible la configuration du CLI Codex — mais il s’agit du CLI Codex autonome, et non du harness OpenClaw ; Kunavo n’a testé aucun des deux clients en runtime.

Ce que coûte le logiciel et ce que coûtent les tokens

OpenClaw lui-même coûte 0 $. Son index de documentation décrit le projet comme sous licence MIT, porté par la communauté et développé par une fondation indépendante 501(c)(3), avec « Aucun forfait payant » ; @openclaw/codex est publié gratuitement sur le registre npm public. Le seul coût réel est la machine sur laquelle vous exécutez le Gateway, auquel s’ajoute l’utilisation des modèles, facturée selon l’un des trois contrats suivants.

D’après la page de tarification de Codex d’OpenAI, vérifiée le 21 septembre 2026. Trois réserves accompagnent ce tableau. La carte tarifaire publie uniquement « À partir de 100 $ » pour Pro ; l’article distinct d’OpenAI À propos des forfaits ChatGPT Pro mentionne un niveau supérieur à 200 $, dont les nouvelles inscriptions et les mises à niveau sont suspendues depuis le 10 septembre 2026 ; vérifiez donc au moment du paiement plutôt que de budgétiser un montant que cette page n’a pas vu sur une carte tarifaire. L’utilisation incluse est publiée uniquement sous forme d’estimations de messages locaux par période de cinq heures, et non comme un nombre fixe de messages. Enfin, les tarifs de crédit après dépassement des limites incluses sont publiés en crédits par million de tokens, sans valeur en dollars pour un crédit sur cette page tarifaire — elle ne fournit donc aucune conversion en dollars pour cette ligne. Par ailleurs, GPT-5.5 sera retiré de ChatGPT, ChatGPT Work et Codex sur tous les forfaits le 14 octobre 2026, tandis que l’API OpenAI n’est pas concernée.

Le troisième contrat est un Gateway sur le runtime intégré d’OpenClaw. Supposons un tour délégué qui envoie 180,000 tokens d’entrée non mis en cache et reçoit 9,000 tokens de sortie ; les tarifs sont les prix actuels du catalogue Kunavo par million de tokens.

Il s’agit de calculs illustratifs de tokens, et non de coûts mesurés pour une tâche ni d’un plafond de facturation — la forme du tour est une hypothèse, et un véritable tour d’agent renvoie le contexte à chaque aller-retour avec un outil. Le montant du catalogue Kunavo constitue un plancher de facturation plutôt qu’un plafond : lorsque l’amont communique son coût, la facture correspond au montant le plus élevé entre le coût du catalogue et le coût amont multiplié par la majoration applicable. Les frais de cache et les outils externes ne sont pas inclus dans l’exemple. Le rechargement minimal est de $10 en crédit prépayé, ce qui alimente un solde plutôt que d’acheter un forfait — consultez les détails de facturation.

Kunavo ne fournit aucun modèle d’embeddings, aucun modèle de synthèse vocale et aucun modèle de transcription vocale. Ces étapes ne sont servies par Kunavo sur aucune route ; utilisez donc un fournisseur qui les propose.

Cette limite est importante ici, car le tableau des surfaces ci-dessus sépare une route OpenAI Platform non agentique du harness, et une clé Gateway ne couvre que les modèles de chat du catalogue Kunavo.

Quelle route l'emporte selon le cas

Si la réponse est la ligne Gateway, commencez par l’intégration du CLI Codex pour le format de l’API Responses, comparez les options dans la meilleure API pour OpenClaw et la meilleure API pour Codex, puis créez un compte Kunavo lorsque vous êtes prêt à approvisionner une clé. Pour le budget d’un assistant auto-hébergé, la tarification d’OpenClaw sépare les coûts du logiciel, de l’hébergement et des modèles.

Questions fréquentes

Le tableau des runtimes, l’ordre d’authentification, l’avertissement relatif à l’app-server, la condition wire_api, les versions exactes et les prix des forfaits ci-dessus ont été récupérés le 21 septembre 2026 dans la documentation d’OpenClaw et d’OpenAI, le centre d’aide d’OpenAI et les entrées du registre npm pour openclaw, @openclaw/codex, @openai/codex, codex et openclaw-code-agent. Chaque affirmation renvoie à la page dont elle provient ; lorsqu’un document ne tranchait pas une question, le texte le précise au lieu de combler la lacune. Kunavo n’a effectué aucun test de runtime d’OpenClaw ni du harness Codex ; toute configuration présentée ici est donc vérifiée par rapport à la documentation source, et non démontrée avec l’endpoint de Kunavo. Les tarifs des tokens Kunavo proviennent du catalogue actuel, et chaque montant en dollars correspond à un calcul illustratif.