OpenAI

OpenAI fournit des API développeur pour les modèles GPT, et Codex est également disponible comme agent de codage de forfait ChatGPT via les clients Codex d'OpenAI. OpenClaw utilise un seul identifiant de provider, openai, pour les deux formes d'authentification.

OpenClaw utilise openai/* comme route canonique des modèles OpenAI. Les tours d'agent intégrés sur les modèles OpenAI s'exécutent par défaut via le runtime app-server Codex natif ; l'authentification directe par clé API OpenAI reste disponible pour les surfaces OpenAI non-agent, comme les images, les embeddings, la parole et le temps réel.

• Modèles d'agent - modèles openai/* via le runtime Codex ; connectez-vous avec l'authentification Codex pour utiliser un abonnement ChatGPT/Codex, ou configurez une sauvegarde par clé API OpenAI compatible avec Codex lorsque vous voulez intentionnellement une authentification par clé API.
• API OpenAI non-agent - accès direct à OpenAI Platform avec facturation à l'usage via OPENAI_API_KEY ou l'onboarding par clé API OpenAI.
• Configuration héritée - les références de modèles Codex héritées sont réparées par openclaw doctor --fix vers openai/* avec le runtime Codex.

OpenAI prend explicitement en charge l'utilisation OAuth par abonnement dans des outils et workflows externes comme OpenClaw.

Le provider, le modèle, le runtime et le canal sont des couches distinctes. Si ces libellés sont mélangés, lisez Runtimes d'agent avant de modifier la configuration.

Choix rapide

Carte de nommage

Les noms sont similaires, mais ne sont pas interchangeables :

Cela signifie qu'une configuration peut intentionnellement contenir des références de modèles openai/* tandis que les profils d'authentification pointent vers des identifiants de clé API ou OAuth ChatGPT/Codex. Utilisez auth.order.openai pour la configuration ; openclaw doctor --fix réécrit les références de modèles Codex héritées, les identifiants de profils d'authentification Codex hérités et l'ordre d'authentification Codex hérité vers la route OpenAI canonique.

Aperçu limité de GPT-5.6

OpenClaw reconnaît les trois identifiants publics de modèles GPT-5.6 :

• openai/gpt-5.6-sol
• openai/gpt-5.6-terra
• openai/gpt-5.6-luna

Tous trois exposent le raisonnement max dans le catalogue app-server Codex actuel. L'annonce de lancement d'OpenAI décrit Sol comme le palier phare, Terra comme le palier équilibré, et Luna comme le palier rapide et moins coûteux. Consultez l'annonce de lancement de GPT-5.6 et le guide d'accès à l'aperçu.

L'accès est soumis à une liste d'autorisation pendant l'aperçu et peut être accordé séparément pour l'API et Codex. Un forfait ChatGPT payant seul n'accorde pas l'accès. OpenClaw conserve openai/gpt-5.5 comme valeur par défaut ; sélectionner une référence GPT-5.6 sans accès renvoie l'erreur d'accès amont au lieu de revenir silencieusement en arrière.

Couverture des fonctionnalités OpenClaw

Embeddings mémoire

OpenClaw peut utiliser OpenAI, ou un point de terminaison d'embeddings compatible OpenAI, pour l'indexation memory_search et les embeddings de requête :

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

Pour les points de terminaison compatibles OpenAI qui exigent des libellés d'embeddings asymétriques, définissez queryInputType et documentInputType sous memorySearch. OpenClaw les transmet comme champs de requête input_type propres au provider : les embeddings de requête utilisent queryInputType ; les fragments 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.

Prise en main

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

openclaw onboard --auth-choice openai-api-key

openclaw onboard --openai-api-key "$OPENAI_API_KEY"

openclaw models list --provider openai

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

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

openclaw onboard --auth-choice openai

openclaw models auth login --provider openai

openclaw models auth login --provider openai --device-code

openclaw config set agents.defaults.model.primary openai/gpt-5.5

openclaw models list --provider openai

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },    },  },}

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.5" },    },  },  auth: {    order: {      openai: [        "openai:user@example.com",        "openai:api-key-backup",      ],    },  },}

openclaw models statusopenclaw models auth list --provider openaiopenclaw config get agents.defaults.model --jsonopenclaw config get models.providers.openai.agentRuntime --json

openclaw models status --agent <id>openclaw models auth list --agent <id> --provider openai

openclaw doctor --fixopenclaw config validate

openclaw models auth login --provider openaiopenclaw models status --probe --probe-provider openai

openclaw models auth login --provider openai --profile-id openai:ritsukoopenclaw models auth login --provider openai --profile-id openai:lain

{  models: {    providers: {      openai: {        models: [{ id: "gpt-5.5", contextTokens: 160000 }],      },    },  },}

Authentification app-server Codex native

Le harnais app-server Codex natif utilise des réfs de modèle openai/* plus une configuration de runtime omise ou provider/model agentRuntime.id: "codex", 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 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 de l’app-server, comme une connexion ChatGPT locale de Codex CLI.
3. Pour les lancements app-server stdio locaux uniquement, CODEX_API_KEY, puis OPENAI_API_KEY, lorsque l’app-server ne 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 Gateway possède aussi OPENAI_API_KEY pour les modèles OpenAI directs ou les embeddings. Le recours à la clé API d’environnement concerne uniquement le chemin local stdio sans compte ; elle n’est pas envoyée aux connexions app-server WebSocket. Lorsqu’un profil Codex de type abonnement est sélectionné, OpenClaw conserve également CODEX_API_KEY et OPENAI_API_KEY hors du processus enfant app-server stdio lancé et envoie les identifiants sélectionnés via le RPC de connexion de l’app-server. Lorsque ce profil d’abonnement est bloqué par une limite d’usage Codex, OpenClaw peut basculer vers le profil de clé API openai:* ordonné suivant 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 redevient éligible.

Génération d’images

Le Plugin openai groupé 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é API OpenAI et la génération d’images OAuth Codex via la même réf. de modèle openai/gpt-image-2.

{  agents: {    defaults: {      imageGenerationModel: { primary: "openai/gpt-image-2" },    },  },}

gpt-image-2 est la valeur par défaut pour la génération d’images à partir de texte OpenAI et pour la modification d’images. gpt-image-1.5, gpt-image-1 et gpt-image-1-mini restent utilisables comme remplacements explicites de modèle. Utilisez openai/gpt-image-1.5 pour une sortie PNG/WebP à arrière-plan transparent ; l’API gpt-image-2 actuelle rejette background: "transparent".

Pour une requête avec 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 OAuth OpenAI Codex en réécrivant les requêtes transparentes par défaut openai/gpt-image-2 vers gpt-image-1.5 ; Azure et les points de terminaison personnalisés compatibles OpenAI conservent leurs noms de déploiement/modèle configurés.

Le même réglage est exposé pour les exécutions CLI sans interface :

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 comme alias propre à OpenAI. Utilisez --quality low|medium|high|auto lorsque vous devez contrôler la qualité et le coût d’OpenAI Images. Utilisez --openai-moderation low|auto pour transmettre l’indication de modération propre au fournisseur OpenAI depuis image generate ou image edit.

Pour les installations ChatGPT/Codex OAuth, conservez la même réf. openai/gpt-image-2. Lorsqu’un profil OAuth openai est configuré, OpenClaw résout ce jeton d’accès OAuth stocké et envoie les requêtes d’image via le backend Codex Responses. Il ne tente pas d’abord OPENAI_API_KEY et ne rebascule pas silencieusement vers une clé API pour cette requête. Configurez explicitement models.providers.openai avec une clé API, une URL de base personnalisée ou un point de terminaison Azure lorsque vous voulez utiliser à la place la route directe de l’API OpenAI Images. Si ce point de terminaison d’image personnalisé se trouve sur un LAN/adresse privée de confiance, définissez aussi browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true ; OpenClaw garde les points de terminaison d’image privés/internes compatibles OpenAI bloqués sauf si cette option explicite 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

Le Plugin openai intégré enregistre la génération vidéo via l’outil video_generate.

Les requêtes image vers vidéo OpenAI utilisent POST /v1/videos avec une input_reference d’image. Les modifications d’une seule vidéo utilisent POST /v1/videos/edits avec la vidéo téléversée dans le champ video.

{  agents: {    defaults: {      videoGenerationModel: { primary: "openai/sora-2" },    },  },}

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 identifiant de modèle ; les routes OpenClaw/fournisseur telles que les anciennes références avant réparation (ancienne réf. Codex GPT-5.5), openrouter/openai/gpt-5.5, opencode/gpt-5.5 et d’autres références GPT-5 compatibles reçoivent donc le même calque. Les anciens modèles GPT-4.x ne le reçoivent pas.

Le harnais Codex natif intégré ne reçoit pas ce calque OpenClaw GPT-5 via les instructions développeur du serveur d’application Codex. Codex natif conserve le comportement de base, de modèle et de documentation 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 l’autorité. OpenClaw ne contribue que le contexte d’exécution, comme la distribution par canal, les outils dynamiques OpenClaw, la délégation ACP, le contexte d’espace de travail et les Skills OpenClaw.

La contribution GPT-5 ajoute un contrat de comportement balisé pour la persistance de persona, la sécurité d’exécution, la discipline des outils, la forme de sortie, les vérifications d’achèvement et la vérification sur les prompts assemblés par OpenClaw correspondants. Le comportement de réponse propre au canal et de message silencieux reste dans le prompt système OpenClaw partagé et la politique de distribution sortante. La couche de style d’interaction amicale est distincte et configurable.

{  agents: {    defaults: {      promptOverlays: {        gpt5: { personality: "friendly" },      },    },  },}

openclaw config set agents.defaults.promptOverlays.gpt5.personality off

Voix et parole

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

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

Points de terminaison Azure OpenAI

Le fournisseur openai intégré 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ôtes Azure dans models.providers.openai.baseUrl et bascule automatiquement vers la forme de requête d’Azure.

Utilisez Azure OpenAI lorsque :

• Vous disposez déjà d’un abonnement, d’un quota ou d’un accord d’entreprise Azure OpenAI
• Vous avez besoin de résidence régionale des données ou de contrôles de conformité fournis par Azure
• Vous souhaitez conserver le trafic à l’intérieur d’un tenant Azure existant

Configuration

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

{  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 requêtes 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 limités au déploiement (/openai/deployments/{deployment}/...)
• Ajoute ?api-version=... à chaque requête
• Utilise un délai d’expiration 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.

Les autres URL de base (OpenAI public, proxys compatibles OpenAI) conservent la forme standard des requêtes d’image OpenAI.

Version de l’API

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

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

Azure OpenAI associe les modèles à des déploiements. Pour les requêtes de génération d’images Azure acheminées via le fournisseur openai intégré, le champ model dans OpenClaw doit être le nom de déploiement Azure que vous avez configuré dans le portail Azure, et non l’identifiant public du modèle OpenAI.

Si vous créez un déploiement nommé 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 acheminés via le fournisseur openai intégré.

Disponibilité régionale

La génération d’images Azure n’est actuellement disponible que 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

Azure OpenAI et OpenAI public n’acceptent pas toujours les mêmes paramètres d’image. Azure peut rejeter des options autorisées par OpenAI public (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 viennent 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 et votre version d’API spécifiques dans le portail Azure.

Configuration avancée

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: { transport: "auto" },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": { params: { fastMode: "auto", fastAutoOnSeconds: 30 } },      },    },  },}

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

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

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: {            responsesServerCompaction: true,            responsesCompactThreshold: 120000,          },        },      },    },  },}

{  agents: {    defaults: {      models: {        "openai/gpt-5.5": {          params: { responsesServerCompaction: false },        },      },    },  },}

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

Connexe