Aller au contenu
OpenClaw Docs

OpenAI

OpenAI fournit des API de développement pour les modèles GPT, et Codex est également disponible en tant qu’agent de codage dans le cadre du plan ChatGPT via les clients Codex de OpenAI. OpenClaw maintient ces surfaces distinctes afin que la configuration reste prévisible.

OpenClaw utilise openai/* comme la route modèle OpenAI canonique. L’agent intégré active les modèles OpenAI exécutés via le runtime natif du serveur d’application Codex par défaut ; l’authentification par clé OpenAI API directe reste disponible pour les surfaces OpenAI non agents telles que les images, les embeddings, la parole et la temps réel.

  • Modèles d’agent - modèles openai/* via le runtime Codex ; connectez-vous avec l’auth Codex pour une utilisation par abonnement ChatGPT/Codex, ou configurez une sauvegarde de clé OpenAIAPI compatible avec Codex lorsque vous souhaitez intentionnellement une auth par clé API.
  • API OpenAI non-agent - accès direct à la plateforme OpenAI avec facturation à l’utilisation via OPENAI_API_KEY ou l’intégration de clé OpenAI API.
  • Configuration héritée - les références de openai-codex/* model sont corrigées par openclaw doctor --fix vers openai/* ainsi que le runtime Codex.

OpenAI prend explicitement en charge l’utilisation de l’abonnement OAuth dans les outils et workflows externes tels que OpenClaw.

Le fournisseur, le modèle, le runtime et le canal sont des couches distinctes. Si ces étiquettes sont mélangées, lisez Runtimes d’agent avant de modifier la configuration.

Choix rapide

Section intitulée « Choix rapide »
ObjectifUtilisationNotes
Abonnement ChatGPT/Codex avec runtime natif Codexopenai/gpt-5.5Configuration par défaut de l’agent OpenAI. Connectez-vous avec l’authentification Codex.
Facturation directe par clé API pour les modèles d’agentopenai/gpt-5.5API plus un profil de clé API compatible avec CodexUtilisez auth.order.openai pour placer la sauvegarde après l’authentification par abonnement.
Facturation directe par clé API via PI expliciteopenai/gpt-5.5 plus le runtime provider/model piSélectionnez un profil de clé API normal openai.
Dernier alias instantané API de ChatGPTopenai/chat-latestClé API directe uniquement. Alias en mouvement pour les expériences, pas celui par défaut.
Authentification par abonnement ChatGPT/Codex via PI expliciteopenai/gpt-5.5 plus l’exécution provider/model piSélectionnez un profil d’authentification openai-codex pour la route de compatibilité.
Génération ou modification d’imagesopenai/gpt-image-2Fonctionne avec OPENAI_API_KEY ou OpenAI Codex OAuth.
Images à fond transparentopenai/gpt-image-1.5Utilisez outputFormat=png ou webp et openai.background=transparent.

Table de correspondance des noms

Section intitulée « Table de correspondance des noms »

Les noms sont similaires mais pas interchangeables :

Nom que vous voyezCoucheSignification
openaiPréfixe du fournisseurRoute canonique du modèle OpenAI ; les tours d’agent utilisent le runtime Codex.
openai-codexPréfixe d’auth/profil héritéAncien espace de noms de profil OAuth/abonnement OpenAI Codex. Les profils existants et OpenAIOAuthauth.order.openai-codex fonctionnent toujours.
Plugin codexPluginPlugin OpenClaw groupé qui fournit le runtime natif du serveur d’application Codex et les contrôles de chat OpenClaw/codex.
provider/model agentRuntime.id: codexRuntime de l’agentForcer le harnais d’application native Codex pour les tours intégrés correspondants.
/codex ...Ensemble de commandes de chatLier/contrôler les fils de discussion du serveur d’application Codex depuis une conversation.
runtime: "acp", agentId: "codex"Itinéraire de session ACPChemin de repli explicite qui exécute Codex via ACP/acpx.

Cela signifie qu’une configuration peut intentionnellement contenir des références de model openai/* tandis que les profils d’authentification pointent toujours vers des informations d’identification compatibles avec Codex. Préférez auth.order.openai pour les nouvelles configurations ; les profils existants openai-codex:* et auth.order.openai-codex restent pris en charge. openclaw doctor --fix réécrit les références de model openai-codex/*OpenAI héritées vers la route model OpenAI canonique.

OpenClaw couverture des fonctionnalités

Section intitulée « OpenClaw couverture des fonctionnalités »
capacité OpenAIsurface OpenClawStatut
Chat / Réponsesopenai/<model> fournisseur de modèleOui
Modèles d’abonnement Codexopenai/<model> avec openai-codex OAuthOui
Références aux modèles Codex héritésopenai-codex/<model> ou codex-cli/<model>Réparé par le médecin vers openai/<model>
Harnais de serveur d’application Codexopenai/<model> avec le runtime omis ou le fournisseur/model agentRuntime.id: codexOui
Recherche Web côté serveurOutil de réponses natif OpenAIOui, lorsque la recherche Web est activée et aucun fournisseur épinglé
Imagesimage_generateOui
Vidéosvideo_generateOui
Synthèse vocalemessages.tts.provider: "openai" / ttsOui
Traitement de la parole en texte par lotstools.media.audio / compréhension multimédiaOui
Flux de la parole en texteAppel vocal streaming.provider: "openai"Oui
Voix en temps réelAppel vocal realtime.provider: "openai" / Contrôle de l’interface TalkOui
Plongements (Embeddings)fournisseur d’incorporation de mémoireOui

Plongements de mémoire (Memory embeddings)

Section intitulée « Plongements de mémoire (Memory embeddings) »

OpenClaw peut utiliser OpenAI, ou un point de terminaison d’incorporation compatible OpenAI, pour l’indexation OpenClawOpenAIOpenAImemory_search et les requêtes d’incorporations :

{
  agents: {
    defaults: {
      memorySearch: {
        provider: "openai",
        model: "text-embedding-3-small",
      },
    },
  },
}

Pour les points de terminaison compatibles OpenAI qui nécessitent des étiquettes d’intégration asymétriques, définissez queryInputType et documentInputType sous memorySearch. OpenClaw transfère ces derniers en tant que champs de requête input_type spécifiques au provider : les intégrations de requête utilisent queryInputType ; les segments de mémoire indexés et l’indexation par lots utilisent documentInputType. Voir la Référence de configuration de la mémoire pour l’exemple complet.

Getting started

Section intitulée « Getting started »

Choisissez votre méthode d’authentification préférée et suivez les étapes de configuration.

Idéal pour : accès direct à l’API et facturation à l’utilisation.

  1. APIObtenir votre clé API

    Créez ou copiez une clé API à partir du tableau de bord de la plateforme OpenAI.

  2. Exécuter l'intégration (onboarding)

    Fenêtre de terminal
    openclaw onboard --auth-choice openai-api-key

    Ou passez la clé directement :

    Fenêtre de terminal
    openclaw onboard --openai-api-key "$OPENAI_API_KEY"

  3. Vérifier que le modèle est disponible

    Fenêtre de terminal
    openclaw models list --provider openai

Résumé de l’acheminement

Section intitulée « Résumé de l’acheminement »
Réf. ModèleConfiguration d’exécutionAcheminementAuth
openai/gpt-5.5omis / provider/model agentRuntime.id: "codex"OpenAIHarnais Codex app-serverProfil OpenAI compatible Codex
openai/gpt-5.4-miniomis / provider/model agentRuntime.id: "codex"OpenAIHarnais Codex app-serverProfil OpenAI compatible Codex
openai/gpt-5.5provider/model agentRuntime.id: "pi"Runtime embarqué PIProfil openai ou profil openai-codex sélectionné

Exemple de configuration

Section intitulée « Exemple de configuration »
{
  env: { OPENAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },
}
```OpenAIAPI


Pour essayer le modèle Instant actuel de ChatGPT depuis l'API OpenAI, définissez le modèle
sur `openai/chat-latest` :


```json5
{
  env: { OPENAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "openai/chat-latest" } } },
}

chat-latestOpenAI est un alias évolutif. OpenAI le documente comme le dernier modèle Instant utilisé dans ChatGPT et recommande gpt-5.5API pour l’usage de l’API en production, gardez donc openai/gpt-5.5 comme valeur par défaut stable, sauf si vous voulez explicitement ce comportement d’alias. L’alias accepte actuellement uniquement la verbosité texte mediumOpenClawOpenAIOpenClaw, donc OpenClaw normalise les substitutions de verbosité texte OpenAI incompatibles pour ce modèle.

Authentification native du serveur d’application Codex

Section intitulée « Authentification native du serveur d’application Codex »

Le harnais natif du serveur d’application Codex utilise des références de modèle openai/* ainsi qu’une configuration d’exécution ou un fournisseur/modèle agentRuntime.id: "codex" omis, mais son authentification reste basée sur le compte. OpenClaw sélectionne l’authentification dans cet ordre :

  1. Profils d’authentification OpenAI ordonnés pour l’agent, de préférence sous OpenAIauth.order.openai. Les profils openai-codex:* existants et auth.order.openai-codex restent valides pour les installations plus anciennes.
  2. Le compte existant du serveur d’application, tel qu’une connexion ChatGPT locale Codex CLI.
  3. Pour les lancements d’app-server stdio locaux uniquement, CODEX_API_KEY, puis OPENAI_API_KEY, lorsque l’app-server signale aucun compte et nécessite toujours l’authentification OpenAI.

Cela signifie qu’une connexion locale d’abonnement ChatGPT/Codex n’est pas remplacée simplement parce que le processus de passerelle dispose également de OPENAI_API_KEY pour les modèles OpenAI directs ou les intégrations (embeddings). Le repli sur la clé d’API d’environnement n’est que le chemin local stdio sans compte ; il n’est pas envoyé aux connexions WebSocket app-server. Lorsqu’un profil Codex de type abonnement est sélectionné, OpenClaw conserve également CODEX_API_KEY et OPENAI_API_KEYRPC en dehors du processus enfant stdio app-server généré et envoie les informations d’identification sélectionnées via la RPC de connexion app-server. Lorsque ce profil d’abonnement est bloqué par une limite d’utilisation Codex, OpenClawopenai:* peut passer au profil suivant à clé d’API classé sans changer le modèle sélectionné ni sortir du harnais Codex. Une fois l’heure de réinitialisation de l’abonnement passée, le profil d’abonnement est à nouveau éligible.

Génération d’images

Section intitulée « Génération d’images »

Le plugin openai inclus enregistre la génération d’images via l’outil image_generate. Il prend en charge à la fois la génération d’images avec la clé d’OpenAI API et la génération d’images Codex OAuth via la même référence de openai/gpt-image-2 model.

FonctionnalitéClé d’OpenAI APICodex OAuth
Réf. de modèleopenai/gpt-image-2openai/gpt-image-2
AuthOPENAI_API_KEYConnexion OpenAI Codex OAuth
TransportAPI Images OpenAIAPIBackend Réponses Codex
Max images par requête44
Mode éditionActivé (jusqu’à 5 images de référence)Activé (jusqu’à 5 images de référence)
Remplacements de taillePris en charge, y compris les tailles 2K/4KPris en charge, y compris les tailles 2K/4K
Format d’image / résolutionNon transmis à l’API OpenAI ImagesMappé vers une taille prise en charge lorsque cela est sûr
{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "openai/gpt-image-2" },
    },
  },
}

gpt-image-2 est la valeur par défaut pour la génération d’images texte vers image et l’édition d’images OpenAI. gpt-image-1.5, gpt-image-1 et gpt-image-1-mini restent utilisables en tant que substitutions explicites de modèle. Utilisez openai/gpt-image-1.5 pour une sortie PNG/WebP avec un arrière-plan transparent ; l’API gpt-image-2 actuel rejette background: "transparent".

Pour une demande d’arrière-plan transparent, les agents doivent appeler image_generate avec model: "openai/gpt-image-1.5", outputFormat: "png" ou "webp", et background: "transparent"; l’ancienne option de fournisseur openai.background est toujours acceptée. OpenClaw protège également les routes publiques OpenAI et OpenAI Codex OAuth en réécrivant les demandes transparentes par défaut openai/gpt-image-2 en gpt-image-1.5; les points de terminaison Azure et personnalisés compatibles OpenAI conservent leurs noms de déploiement/model configurés.

Le même paramètre est exposé pour les exécutions CLI sans interface :

Fenêtre de terminal
openclaw infer image generate \
  --model openai/gpt-image-1.5 \
  --output-format png \
  --background transparent \
  --prompt "A simple red circle sticker on a transparent background" \
  --json

Utilisez les mêmes indicateurs --output-format et --background avec openclaw infer image edit lors du démarrage à partir d’un fichier d’entrée. --openai-background reste disponible en tant qu’alias spécifique à OpenAI.

Pour les installations Codex OAuth, conservez la même référence openai/gpt-image-2. Lorsqu’un profil OAuth openai-codex est configuré, OpenClaw résout ce jeton d’accès OAuth stocké et envoie les demandes d’images via le backend Codex Responses. Il n’essaie pas d’abord OPENAI_API_KEY ni ne retourne silencieusement à une clé API pour cette demande. Configurez models.providers.openai explicitement avec une clé API, une URL de base personnalisée ou un point de terminaison Azure lorsque vous souhaitez utiliser l’itinéraire direct de l’API Images OpenAIAPI à la place. Si ce point de terminaison d’image personnalisé se trouve sur une adresse LAN/privée de confiance, définissez également browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true ; OpenClaw maintient bloqués les points de terminaison d’image compatibles OpenAI privés/internes, sauf si cette option d’adhésion est présente.

Générer :

/tool image_generate model=openai/gpt-image-2 prompt="A polished launch poster for OpenClaw on macOS" size=3840x2160 count=1

Générer un PNG transparent :

/tool image_generate model=openai/gpt-image-1.5 prompt="A simple red circle sticker on a transparent background" outputFormat=png background=transparent

Modifier :

/tool image_generate model=openai/gpt-image-2 prompt="Preserve the object shape, change the material to translucent glass" image=/path/to/reference.png size=1024x1536

Génération de vidéo

Section intitulée « Génération de vidéo »

Le plugin openai inclus enregistre la génération vidéo via l’outil video_generate.

CapacitéValeur
Modèle par défautopenai/sora-2
ModesTexte-vidéo, image-vidéo, montage vidéo unique
Références d’entrée1 image ou 1 vidéo
Remplacements de taillePris en charge
Autres substitutionsaspectRatio, resolution, audio et watermark sont ignorés avec un avertissement de l’outil
{
  agents: {
    defaults: {
      videoGenerationModel: { primary: "openai/sora-2" },
    },
  },
}

Contribution de prompt GPT-5

Section intitulée « Contribution de prompt GPT-5 »

OpenClaw ajoute une contribution de prompt GPT-5 partagée pour les exécutions de la famille GPT-5 sur les surfaces de prompt assemblées par OpenClaw. Elle s’applique par ID de modèle, de sorte que les routes PI/fournisseur telles que les références héritées pré-réparation (openai-codex/gpt-5.5), openrouter/openai/gpt-5.5, opencode/gpt-5.5 et d’autres références GPT-5 compatibles reçoivent le même superposition. Les modèles GPT-4.x plus anciens ne le font pas.

Le harnais natif Codex fourni ne reçoit pas cette superposition GPT-5 OpenClaw via les instructions de développement de l’application serveur Codex. Le Codex natif conserve le comportement de base, de modèle, de personnalité et de documentation de projet appartenant à Codex ; OpenClaw contribue uniquement au contexte d’exécution tel que la livraison via channel, les outils dynamiques OpenClaw, la délégation ACP, le contexte de l’espace de travail et les compétences OpenClaw.

La contribution GPT-5 ajoute un contrat de comportement balisé pour la persistance de la persona, la sécurité de l’exécution, la discipline des outils, la forme de la sortie, les vérifications de complétion et la vérification sur les invites assemblées par OpenClaw. Le comportement de réponse spécifique au canal et de message silencieux reste dans l’invite système partagée OpenClaw et la politique de livraison sortante. La couche de style d’interaction convivial est distincte et configurable.

ValeurEffet
"friendly" (par défaut)Activer la couche de style d’interaction convivial
"on"Alias pour "friendly"
"off"Désactiver uniquement la couche de style convivial
{
  agents: {
    defaults: {
      promptOverlays: {
        gpt5: { personality: "friendly" },
      },
    },
  },
}

Voix et parole

Section intitulée « Voix et parole »
Synthèse vocale (TTS)

Le plugin intégré openai enregistre la synthèse vocale pour la surface messages.tts.

ParamètreChemin de configurationPar défaut
Modèlemessages.tts.providers.openai.modelgpt-4o-mini-tts
Voixmessages.tts.providers.openai.voicecoral
Vitessemessages.tts.providers.openai.speed(non défini)
Instructionsmessages.tts.providers.openai.instructions(non défini, gpt-4o-mini-tts uniquement)
Formatmessages.tts.providers.openai.responseFormatopus pour les notes vocales, mp3 pour les fichiers
Clé APImessages.tts.providers.openai.apiKeyRevient à OPENAI_API_KEY
URL de basemessages.tts.providers.openai.baseUrlhttps://api.openai.com/v1
Corps supplémentairemessages.tts.providers.openai.extraBody / extra_body(non défini)

Modèles disponibles : gpt-4o-mini-tts, tts-1, tts-1-hd. Voix disponibles : alloy, ash, ballad, cedar, coral, echo, fable, juniper, marin, onyx, nova, sage, shimmer, verse.

extraBody est fusionné dans le JSON de la requête /audio/speech après les champs générés par OpenClaw, utilisez-le donc pour les points de terminaison compatibles avec OpenAI qui nécessitent des clés supplémentaires comme lang. Les clés de prototype sont ignorées.

{
  messages: {
    tts: {
      providers: {
        openai: { model: "gpt-4o-mini-tts", voice: "coral" },
      },
    },
  },
}
Speech-to-text

Le plugin intégré openai enregistre la transcription parole-vers-texte par lots via la surface de transcription de compréhension multimédia d’OpenClaw.

  • Modèle par défaut : gpt-4o-transcribe
  • Point de terminaison : OpenAI REST /v1/audio/transcriptions
  • Chemin d’entrée : téléchargement de fichier audio multipart
  • Pris en charge par OpenClaw partout où la transcription audio entrante utilise tools.media.audio, y compris les segments de canal vocal Discord et les pièces jointes audio de canal

Pour forcer OpenAI pour la transcription audio entrante :

{
  tools: {
    media: {
      audio: {
        models: [
          {
            type: "provider",
            provider: "openai",
            model: "gpt-4o-transcribe",
          },
        ],
      },
    },
  },
}

Les indications de langue et de prompt sont transmises à OpenAI lorsqu’elles sont fournies par la configuration multimédia audio partagée ou la demande de transcription par appel.

Transcription en temps réel

Le plugin openai inclus enregistre la transcription en temps réel pour le plugin Voice Call.

ParamètreChemin de configurationPar défaut
Modèleplugins.entries.voice-call.config.streaming.providers.openai.modelgpt-4o-transcribe
Langue...openai.language(non défini)
Invite...openai.prompt(non défini)
Durée de silence...openai.silenceDurationMs800
Seuil VAD...openai.vadThreshold0.5
Auth...openai.apiKey, OPENAI_API_KEY, ou openai-codex OAuthLes clés API se connectent directement ; OAuth génère un secret client de transcription en temps réel
Voix en temps réel

Le plugin openai inclus enregistre la voix en temps réel pour le plugin Voice Call.

ParamètreChemin de configurationPar défaut
Modelplugins.entries.voice-call.config.realtime.providers.openai.modelgpt-realtime-2
Voice...openai.voicealloy
Temperature (pont de déploiement Azure)...openai.temperature0.8
Seuil VAD...openai.vadThreshold0.5
Durée de silence...openai.silenceDurationMs500
Remplissage de préfixe...openai.prefixPaddingMs300
Effort de raisonnement...openai.reasoningEffort(non défini)
Auth...openai.apiKey, OPENAI_API_KEY, ou openai-codex OAuthBrowser Talk et les ponts backend non-Azure peuvent utiliser Codex OAuth

Voix en temps réel intégrées disponibles pour gpt-realtime-2 : alloy, ash, ballad, coral, echo, sage, shimmer, verse, marin, cedar. OpenAI recommande marin et cedar pour la meilleure qualité en temps réel. Il s’agit d’un ensemble distinct des voix de synthèse vocale ci-dessus ; ne supposez pas qu’une voix TTS telle que fable, nova ou onyx est valide pour les sessions en temps réel.

Points de terminaison Azure OpenAI

Section intitulée « Points de terminaison Azure OpenAI »

Le provider openai inclus peut cibler une ressource Azure OpenAI pour la génération d’images en remplaçant l’URL de base. Sur le chemin de génération d’images, OpenClaw détecte les noms d’hôte Azure sur models.providers.openai.baseUrl et passe automatiquement au format de requête d’Azure.

Utilisez Azure OpenAI lorsque :

  • Vous possédez déjà un abonnement Azure OpenAI, un quota ou un accord entreprise
  • Vous avez besoin de résidence régionale des données ou de contrôles de conformité qu’Azure fournit
  • Vous souhaitez maintenir le trafic au sein d’un locataire Azure existant

Configuration

Section intitulée « Configuration »

Pour la génération d’images Azure via le fournisseur openai inclus, pointez models.providers.openai.baseUrl vers votre ressource Azure et définissez apiKeyOpenAI sur la clé Azure OpenAI (et non une clé de plateforme OpenAI) :

{
  models: {
    providers: {
      openai: {
        baseUrl: "https://<your-resource>.openai.azure.com",
        apiKey: "<azure-openai-api-key>",
      },
    },
  },
}

OpenClaw reconnaît ces suffixes d’hôte Azure pour le route de génération d’images Azure :

  • *.openai.azure.com
  • *.services.ai.azure.com
  • *.cognitiveservices.azure.com

Pour les demandes de génération d’images sur un hôte Azure reconnu, OpenClaw :

  • Envoie l’en-tête api-key au lieu de Authorization: Bearer
  • Utilise des chemins délimités par déploiement (/openai/deployments/{deployment}/...)
  • Ajoute ?api-version=... à chaque requête
  • Utilise un délai d’expiration de requête par défaut de 600 s pour les appels de génération d’images Azure. Les valeurs timeoutMs par appel remplacent toujours cette valeur par défaut.

D’autres URL de base (OpenAI public, proxies compatibles avec OpenAI) conservent la structure standard de requête d’image OpenAI.

Version de l’API

Section intitulée « Version de l’API »

Définissez AZURE_OPENAI_API_VERSION pour figer une version Azure preview ou GA spécifique pour le chemin de génération d’images Azure :

Fenêtre de terminal
export AZURE_OPENAI_API_VERSION="2024-12-01-preview"

La valeur par défaut est 2024-12-01-preview lorsque la variable n’est pas définie.

Les noms de modèle sont des noms de déploiement

Section intitulée « Les noms de modèle sont des noms de déploiement »

Azure OpenAI lie les modèles aux déploiements. Pour les demandes de génération d’images Azure routées via le fournisseur openai inclus, le champ model dans OpenClaw doit être le nom de déploiement Azure que vous avez configuré dans le portail Azure, et non l’ID de modèle OpenAI public.

Si vous créez un déploiement appelé gpt-image-2-prod qui sert gpt-image-2 :

/tool image_generate model=openai/gpt-image-2-prod prompt="A clean poster" size=1024x1024 count=1

La même règle de nom de déploiement s’applique aux appels de génération d’images routés via le provider openai inclus.

Disponibilité régionale

Section intitulée « Disponibilité régionale »

La génération d’images Azure est actuellement disponible uniquement dans un sous-ensemble de régions (par exemple eastus2, swedencentral, polandcentral, westus3, uaenorth). Consultez la liste actuelle des régions de Microsoft avant de créer un déploiement, et confirmez que le modèle spécifique est proposé dans votre région.

Différences de paramètres

Section intitulée « Différences de paramètres »

Azure OpenAI et le OpenAIOpenAI public n’acceptent pas toujours les mêmes paramètres d’image. Azure peut rejeter des options que le OpenClaw public autorise (par exemple certaines valeurs background sur gpt-image-2) ou ne les exposer que sur des versions de modèle spécifiques. Ces différences proviennent d’Azure et du modèle sous-jacent, et non d’API. Si une requête Azure échoue avec une erreur de validation, vérifiez l’ensemble de paramètres pris en charge par votre déploiement spécifique et la version de l’API dans le portail Azure.

Configuration avancée

Section intitulée « Configuration avancée »
Transport (WebSocket vs SSE)

OpenClaw privilégie WebSocket avec repli sur SSE ("auto") pour openai/*.

En mode "auto", OpenClaw :

  • Réessaie une défaillance précoce de WebSocket avant de basculer sur SSE
  • Après une défaillance, marque WebSocket comme dégradé pendant ~60 secondes et utilise SSE pendant le refroidissement
  • Attache des en-têtes d’identité de session et de tour stables pour les nouvelles tentatives et reconnexions
  • Normalise les compteurs d’utilisation (input_tokens / prompt_tokens) sur les variantes de transport
ValeurComportement
"auto" (défaut)WebSocket en priorité, repli sur SSE
"sse"Forcer SSE uniquement
"websocket"Forcer WebSocket uniquement
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": {
          params: { transport: "auto" },
        },
      },
    },
  },
}

Documentation OpenAI connexe :

Fast mode

OpenClaw expose un bouton bascule de mode rapide partagé pour openai/* :

  • Chat/UI : /fast status|on|off
  • Config : `agents.defaults.models[”

/

“].params.fastMode`OpenClawOpenAI

Lorsqu'il est activé, OpenClaw mappe le mode rapide au traitement prioritaire d'OpenAI (`service_tier = "priority"`). Les valeurs `service_tier` existantes sont conservées, et le mode rapide ne réécrit pas `reasoning` ou `text.verbosity`.


```json5
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": { params: { fastMode: true } },
      },
    },
  },
}
```
Traitement prioritaire (service_tier)

L’OpenAI d’API expose un traitement prioritaire via service_tier. Définissez-le par modèle dans OpenClaw :

{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": { params: { serviceTier: "priority" } },
      },
    },
  },
}

Valeurs prises en charge : auto, default, flex, priority.

APICompactage côté serveur (API Réponses)

Pour les modèles de réponses OpenAI directs (openai/* sur api.openai.com), le wrapper de flux du harnais Pi du plugin OpenAI active automatiquement le compactage côté serveur :

  • Force store: true (sauf si la compatibilité du modèle définit supportsStore: false)
  • Injecte context_management: [{ type: "compaction", compact_threshold: ... }]
  • compact_threshold par défaut : 70 % de contextWindow (ou 80000 si indisponible)

Cela s’applique au chemin du harnais Pi intégré et aux hooks du fournisseur OpenAI utilisés par les exécutions intégrées. Le harnais de serveur d’application Codex natif gère son propre contexte via Codex et est configuré par l’itinéraire de l’agent par défaut OpenAI ou par la stratégie d’exécution du fournisseur/modèle.

Utile pour les points de terminaison compatibles comme Azure OpenAI Responses :

{
  agents: {
    defaults: {
      models: {
        "azure-openai-responses/gpt-5.5": {
          params: { responsesServerCompaction: true },
        },
      },
    },
  },
}
Strict-agentic GPT mode

Pour les exécutions de la famille GPT-5 sur openai/*, OpenClaw peut utiliser un contrat d’exécution intégré plus strict :

{
  agents: {
    defaults: {
      embeddedPi: { executionContract: "strict-agentic" },
    },
  },
}

Avec strict-agentic, OpenClaw :

  • Ne considère plus un tour de planification uniquement comme une progression réussie lorsqu’une action d’outil est disponible
  • Réessaie le tour avec une directive d’action immédiate
  • Active automatiquement update_plan pour le travail important
  • Affiche un état bloqué explicite si le modèle continue de planifier sans agir

<Accordion title=“OpenAIRoutes natives vs compatibles OpenAI”OpenClawOpenAIOpenAIOpenAI> OpenClaw traite différemment les points de terminaison directs OpenAI, Codex et Azure OpenAI par rapport aux proxys génériques compatibles /v1 :

**Routes natives** (`openai/*`OpenAI, Azure OpenAI) :
- Garde `reasoning: { effort: "none" }`OpenAI uniquement pour les modèles qui prennent en charge l'effort OpenAI `none`
- Omet le raisonnement désactivé pour les modèles ou proxys qui rejettent `reasoning.effort: "none"`OpenAI
- Applique par défaut les schémas d'outil en mode strict
- Attache des en-têtes d'attribution cachés uniquement sur les hôtes natifs vérifiés
- Conserve le façonnage des requêtes exclusif à OpenAI (`service_tier`, `store`, compatibilité du raisonnement, indications de cache de prompt)


**Routes de proxy/compatibles :**
- Utilise un comportement de compatibilité plus souple
- Supprime Completions `store` des payloads `openai-completions` non natifs
- Accepte le JSON de passage avancé `params.extra_body`/`params.extraBody`OpenAI pour les proxys Completions compatibles OpenAI
- Accepte `params.chat_template_kwargs`OpenAIOpenAI pour les proxys Completions compatibles OpenAI tels que vLLM
- N'impose pas de schémas d'outil stricts ou d'en-têtes natifs uniquement


Azure OpenAI utilise un transport natif et un comportement de compatibilité mais ne reçoit pas les en-têtes d'attribution cachés.

Connexes

Section intitulée « Connexes »
Sélection du modèle

Choix des fournisseurs, références de modèle et comportement de basculement.

Génération d'images

Paramètres partagés de l’outil d’image et sélection du provider.

Génération vidéo

Paramètres partagés de l’outil vidéo et sélection du fournisseur.

OAuthOAuth et auth

Détails d’authentification et règles de réutilisation des informations d’identification.