Aller au contenu
OpenClaw Docs

OpenAI

OpenAI fournit des API de développeur pour les modèles GPT, et Codex est également disponible en tant qu’agent de codage ChatGPT-plan via les clients Codex d’OpenAI. OpenClaw utilise un id de fournisseur, openai, pour les deux formes d’authentification.

OpenClaw utilise openai/* comme la route canonique du modèle OpenAI. L’agent intégré active les modèles OpenAI exécutés via le runtime natif de l’application serveur Codex par défaut ; l’authentification directe par clé OpenAI API 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’authentification Codex pour une utilisation d’abonnement ChatGPT/Codex, ou configurez une clé OpenAI API compatible Codex de secours lorsque vous voulez intentionnellement une authentification par clé API.
  • API OpenAI non agents - accès direct à la plateforme OpenAI avec une facturation à l’usage via OPENAI_API_KEY ou une intégration par clé OpenAI API.
  • Configuration héritée - les références de modèle Codex héritées sont réparées par openclaw doctor --fix vers openai/* plus 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 OpenClaw expliciteopenai/gpt-5.5 plus runtime provider/modèle openclawSélectionnez un profil de clé openai API normal.
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 OpenClawopenai/gpt-5.5 plus runtime provider/modèle openclawSélectionnez un profil OAuth openai 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.
préfixe Codex OpenAI héritéPréfixe héritéEspace de noms de modèle/profil plus ancien. openclaw doctor --fix le migre vers openai.
Plugin codexPluginPlugin OpenClaw intégré qui fournit le runtime d’application serveur Codex natif 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 config peut contenir intentionnellement des références de modèle openai/* tandis que les profils d’auth pointent vers des identifiants API-key ou ChatGPT/Codex OAuth. Utilisez auth.order.openai pour la config ; openclaw doctor --fix réécrit les anciennes références de modèle Codex, les anciens IDs de profil d’auth Codex et l’ancien ordre d’auth Codex vers la route canonique OpenAI.

OpenClaw couverture des fonctionnalités

Section intitulée « OpenClaw couverture des fonctionnalités »
capacité OpenAIsurface OpenClawStatut
Chat / RéponsesFournisseur de modèle openai/<model>Oui
Modèles d’abonnement Codexopenai/<model> avec OpenAI OAuthOui
Références aux modèles Codex héritésanciennes références de modèle Codex ou codex-cli/<model>Réparé par le médecin en openai/<model>
Harnais de serveur d’application Codexopenai/<model> avec runtime omis ou fournisseur/modèle 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 des médiasOui
Flux de la parole en texteAppel vocal streaming.provider: "openai"Oui
Voix en temps réelAppel vocal realtime.provider: "openai" / Contrôle Interface Talk talk.realtime.provider: "openai"Oui (nécessite des crédits de la plateforme OpenAI, et non un abonnement Codex/ChatGPT)
Plongements (Embeddings)fournisseur d’incorporation de mémoireOui

Memory embeddings

Section intitulée « Memory embeddings »

OpenClaw peut utiliser OpenAI, ou un point de terminaison d’intégration compatible avec OpenAI, pour l’indexation memory_search et les intégrations de requête :

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

Pour les points de terminaison compatibles avec OpenAI qui nécessitent des étiquettes d’intégration asymétriques, définissez queryInputType et documentInputType sous memorySearch. OpenClaw transmet ceux-ci en tant que champs de requête input_type spécifiques au provider : les intégrations de requête utilisent queryInputType ; les blocs de mémoire indexés et l’indexation par lot utilisent documentInputType. Consultez 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. Obtenir votre clé API

    Créez ou copiez une clé API depuis le tableau de bord de la Plateforme OpenAI.

  2. Exécuter l'intégration

    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é des routes

Section intitulée « Résumé des routes »
Réf. de modèleConfig. d’exécutionRouteAuth
openai/gpt-5.5omis / provider/model agentRuntime.id: "codex"Harnais app-server CodexProfil OpenAI compatible Codex
openai/gpt-5.4-miniomis / provider/model agentRuntime.id: "codex"Harnais app-server CodexProfil OpenAI compatible Codex
openai/gpt-5.5provider/model agentRuntime.id: "openclaw"Runtime intégré OpenClawProfil openai sélectionné

Exemple de configuration

Section intitulée « Exemple de configuration »
{
  env: { OPENAI_API_KEY: "example-openai-key-not-real" },
  agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },
}

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

{
  env: { OPENAI_API_KEY: "example-openai-key-not-real" },
  agents: { defaults: { model: { primary: "openai/chat-latest" } } },
}

chat-latest est un alias évolutif. API le documente comme étant le dernier modèle Instant utilisé dans ChatGPT et recommande gpt-5.5 pour une utilisation en production de l’OpenClaw, gardez donc openai/gpt-5.5 comme défaut stable, sauf si vous souhaitez explicitement ce comportement d’alias. L’alias accepte actuellement uniquement la verbosité de texte medium, donc OpenAI normalise les redéfinitions incompatibles de verbosité de texte OpenClaw pour ce modèle.

Authentification native du serveur d’application Codex

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

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

  1. Profils d’authentification OpenAI commandés pour l’agent, de préférence sous auth.order.openai. Exécutez openclaw doctor --fix pour migrer les anciens identifiants de profil d’authentification Codex hérités et l’ordre d’authentification Codex hérité.
  2. Le compte existant du serveur d’application, tel qu’une connexion ChatGPT locale Codex CLI.
  3. Pour les lancements locaux d’application serveur stdio uniquement, CODEX_API_KEY, puis OPENAI_API_KEY, lorsque l’application serveur ne signale aucun compte et exige toujours une authentification OpenAI.

Cela signifie qu’une connexion locale par 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 incorporations. Le repli sur la clé d’API de l’environnement n’est que le chemin local stdio sans compte ; elle n’est pas envoyée aux connexions WebSocket de l’application serveur. Lorsqu’un profil Codex de type abonnement est sélectionné, OpenClaw conserve également CODEX_API_KEY et OPENAI_API_KEY hors de l’enfant d’application serveur stdio généré et envoie les identifiants sélectionnés via la connexion RPC de l’application serveur. Lorsque ce profil d’abonnement est bloqué par une limite d’utilisation Codex, OpenClaw peut passer au profil de clé d’API openai:* suivant dans l’ordre sans changer le modèle sélectionné ni quitter le 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 par clé d’OpenAI API et la génération d’images OAuth Codex via la même référence de modèle openai/gpt-image-2.

CapacitéClé API OpenAICodex OAuth
Référence de modèleopenai/gpt-image-2openai/gpt-image-2
AuthOPENAI_API_KEYConnexion Codex OAuth OpenAI
TransportAPI Images OpenAIBackend Codex Responses
Max images per request44
Edit modeActivé (jusqu’à 5 images de référence)Enabled (up to 5 reference images)
Size overridesPris en charge, y compris les tailles 2K/4KSupported, including 2K/4K sizes
Aspect ratio / resolutionNot forwarded to OpenAI Images APIMapped to a supported size when safe
{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "openai/gpt-image-2" },
    },
  },
}

gpt-image-2 est la valeur par défaut pour la génération de 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 model. Utilisez openai/gpt-image-1.5 pour une sortie PNG/WebP avec un fond transparent ; l’API gpt-image-2 actuel rejette background: "transparent".

Pour une demande avec fond transparent, les agents doivent appeler image_generate avec model: "openai/gpt-image-1.5", outputFormat: "png" ou "webp", et background: "transparent" ; l’option de provider openai.background plus ancienne est toujours acceptée. OpenClaw protège également les routes OAuth publiques OpenAI et OpenAIOAuth Codex en réécrivant les requêtes transparentes openai/gpt-image-2 par défaut vers gpt-image-1.5 ; les points de terminaison Azure 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 lorsque vous partez d’un fichier d’entrée. --openai-background reste disponible en tant qu’alias spécifique à OpenAI.

Pour les installations ChatGPT/Codex OAuth, conservez la même référence openai/gpt-image-2. Lorsqu’un profil OAuth openai 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’OpenAI Images API à 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 les points de terminaison d’image compatibles OpenAI privés/internal bloqués, 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 vidéo

Section intitulée « Génération 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 vers vidéo, image vers vidéo, modification vidéo unique
Entrées de référence1 image ou 1 vidéo
Remplacements de taillePris en charge pour le texte vers vidéo et l’image vers vidéo
Autres remplacementsaspectRatio, resolution, audio, watermark sont ignorés avec un avertissement de l’outil

Les demandes image vers vidéo OpenAI utilisent POST /v1/videos avec une image input_reference. Les modifications vidéo uniques utilisent POST /v1/videos/edits avec la vidéo téléchargée dans le champ video.

{
  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, donc les itinéraires OpenClaw/provider tels que les références legacy pré-réparation (référence legacy Codex GPT-5.5), openrouter/openai/gpt-5.5, opencode/gpt-5.5 et d’autres références GPT-5 compatibles reçoivent la même superposition. Les modèles plus anciens GPT-4.x ne le font pas.

Le harnais natif Codex groupé ne reçoit pas cette superposition GPT-5 OpenClaw via les instructions développeur du serveur d’application Codex. Codex natif conserve le comportement de base, de modèle et de doc de projet appartenant à Codex, tandis qu’OpenClaw désactive la personnalité intégrée de Codex pour les fils natifs afin que les fichiers de personnalité de l’espace de travail de l’agent restent faisant autorité. OpenClaw contribue uniquement au contexte d’exécution tel que la livraison par canal, 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 étiqueté pour la persistance de la personnalité, la sécurité d’exécution, la discipline des outils, la forme de la sortie, les vérifications d’achèvement et la vérification sur les prompts correspondants assemblés par OpenClaw. Le comportement de réponse spécifique au canal et de message silencieux reste dans le prompt système OpenClaw partagé et la politique de livraison sortante. La couche de style d’interaction convivial est séparée 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 synthèse vocale

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

Le plugin openai inclus enregistre la synthèse vocale pour la surface messages.tts.

ParamètreChemin de configPar défaut
Modèlemessages.tts.providers.openai.modelgpt-4o-mini-tts
Voixmessages.tts.providers.openai.speakerVoicecoral
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 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 telles que lang. Les clés de prototype sont ignorées.

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

Le plugin openai inclus enregistre la conversion parole vers texte par lots via la surface de transcription de compréhension des médias 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 multiparts
  • 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.

Reconnaissance vocale en temps réel

Le plugin openai inclus enregistre la reconnaissance vocale 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 OAuthLes clés API se connectent directement ; OAuth génère un secret client de reconnaissance vocale 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 configPar défaut
Modèleplugins.entries.voice-call.config.realtime.providers.openai.modelgpt-realtime-2
Voix...openai.voicealloy
Température (pont de déploiement Azure)...openai.temperature0.8
Seuil VAD...openai.vadThreshold0.5
Durée de silence...openai.silenceDurationMs500
Remplissage du préfixe...openai.prefixPaddingMs300
Effort de raisonnement...openai.reasoningEffort(non défini)
Auth...openai.apiKey, OPENAI_API_KEY, ou openai OAuthBrowser Talk et les ponts backend non-Azure peuvent utiliser OpenAI 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 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 fournisseur groupé openaiOpenAIOpenClaw 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 bascule automatiquement vers le format de requête d’Azure.

Utilisez Azure OpenAI lorsque :

  • Vous possédez déjà un abonnement Azure OpenAI, un quota ou un contrat entreprise
  • Vous avez besoin d’une résidence régionale des données ou de contrôles de conformité fournis par Azure
  • Vous souhaitez garder le trafic à l’intérieur d’un locataire Azure existant

Configuration

Section intitulée « Configuration »

Pour la génération d’images Azure via le fournisseur groupé openai, pointez models.providers.openai.baseUrl vers votre ressource Azure et définissez apiKeyOpenAIOpenAI sur la clé Azure OpenAI (et non une clé de la 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 la 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 le 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 le format de demande d’image OpenAI standard.

Version de API

Section intitulée « Version de API »

Définissez AZURE_OPENAI_API_VERSION pour épingler une version Azure spécifique (preview ou GA) 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 provider OpenAIopenai fourni, le champ modelOpenClawOpenAI dans OpenClaw doit correspondre au nom du déploiement Azure que vous avez configuré dans le portail Azure, et non à l’identifiant du modèle public OpenAI.

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 fourni.

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 OpenAI public n’acceptent pas toujours les mêmes paramètres d’image. Azure peut rejeter des options qu’OpenAI public autorise (par exemple certaines valeurs OpenAIOpenAIOpenAIbackground sur gpt-image-2OpenClawAPI) 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’OpenClaw. 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 votre version d’API dans le portail Azure.

Configuration avancée

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

OpenClaw utilise WebSocket en priorité avec repli SSE ("auto") pour openai/*.

En mode "auto", OpenClaw :

  • Réessaie un échec précoce de WebSocket avant de basculer vers SSE
  • Après un échec, marque WebSocket comme dégradé pendant ~60 secondes et utilise SSE pendant le refroidissement
  • Attache des en-tètres stables de session et d’identité de tour pour les nouvelles tentatives et reconnexions
  • Normalise les compteurs d’utilisation (input_tokens / prompt_tokens) selon les variantes de transport
ValueBehavior
"auto" (default)WebSocket first, SSE fallback
"sse"Force SSE only
"websocket"Force WebSocket only
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": {
          params: { transport: "auto" },
        },
      },
    },
  },
}

Documentation OpenAI connexe :

Fast mode

OpenClaw expose un interrupteur 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 existantes de `service_tier` sont préservées, et le mode rapide ne réécrit pas `reasoning` ou `text.verbosity`.


```json5
{
  agents: {
    defaults: {
      models: {
        "openai/gpt-5.5": { params: { fastMode: true } },
      },
    },
  },
}
```

<Accordion title=“Priority processing (service_tier)“OpenAIAPI> L’API d’OpenAI expose le traitement prioritaire via service_tierOpenClaw. Définissez-le par modèle dans OpenClaw :

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


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


<Warning>
`serviceTier`OpenAI est uniquement transmis aux points de terminaison natifs d'OpenAI (`api.openai.com`) et aux points de terminaison natifs de Codex (`chatgpt.com/backend-api`OpenClaw). Si vous acheminez l'un ou l'autre fournisseur via un proxy, OpenClaw laisse `service_tier` intact.
</Warning>

<Accordion title=“APICompactage côté serveur (Responses API)“OpenAI> Pour les modèles Responses OpenAI directs (openai/* sur api.openai.comOpenAIOpenClaw), le wrapper de flux OpenClaw du plug-in 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 `contextWindow` (ou `80000`OpenClawOpenAIOpenAI si indisponible)


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


<Tabs>
  <Tab title="Activer explicitement"OpenAI>
    Utile pour les points de terminaison compatibles comme Azure OpenAI Responses :


    ```json5
    {
      agents: {
        defaults: {
          models: {
            "azure-openai-responses/gpt-5.5": {
              params: { responsesServerCompaction: true },
            },
          },
        },
      },
    }
    ```
  </Tab>
  <Tab title="Seuil personnalisé">
    ```json5
    {
      agents: {
        defaults: {
          models: {
            "openai/gpt-5.5": {
              params: {
                responsesServerCompaction: true,
                responsesCompactThreshold: 120000,
              },
            },
          },
        },
      },
    }
    ```
  </Tab>
  <Tab title="Désactiver">
    ```json5
    {
      agents: {
        defaults: {
          models: {
            "openai/gpt-5.5": {
              params: { responsesServerCompaction: false },
            },
          },
        },
      },
    }
    ```
  </Tab>
</Tabs>


<Note>
`responsesServerCompaction` contrôle uniquement l'injection de `context_management`OpenAI. Les modèles Responses OpenAI directs forcent toujours `store: true` sauf si la compatibilité définit `supportsStore: false`.
</Note>
Mode agentic GPT strict

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

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

Avec strict-agenticOpenClaw, 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’agir maintenant
  • Active automatiquement update_planOpenAI pour un travail substantiel
  • Affiche un état bloqué explicite si le modèle continue à planifier sans agir
Native vs OpenAI-compatible routes

OpenClaw treats direct OpenAI, Codex, and Azure OpenAI endpoints differently from generic OpenAI-compatible /v1 proxies:

Native routes (openai/*, Azure OpenAI):

  • Keep reasoning: { effort: "none" } only for models that support the OpenAI none effort
  • Omit disabled reasoning for models or proxies that reject reasoning.effort: "none"
  • Default tool schemas to strict mode
  • Attach hidden attribution headers on verified native hosts only
  • Keep OpenAI-only request shaping (service_tier, store, reasoning-compat, prompt-cache hints)

Proxy/compatible routes:

  • Use looser compat behavior
  • Strip Completions store from non-native openai-completions payloads
  • Accept advanced params.extra_body/params.extraBody pass-through JSON for OpenAI-compatible Completions proxies
  • Accept params.chat_template_kwargs for OpenAI-compatible Completions proxies such as vLLM
  • Do not force strict tool schemas or native-only headers

Azure OpenAI uses native transport and compat behavior but does not receive the hidden attribution headers.

Connexes

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

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

Génération d'images

Paramètres d’outil d’image partagés et sélection du fournisseur.

Génération de vidéo

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

OAuthOAuth et auth

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