OpenAI

OpenClaw gebruikt één provider-id, openai, voor zowel directe authenticatie met een API-sleutel als ChatGPT/Codex-abonnementsauthenticatie. openai/* is de canonieke modelroute. Voor ingebedde agentbeurten waarbij het runtimebeleid niet is ingesteld of auto is, bepalen de routegegevens van OpenAI of OpenClaw impliciet de gebundelde Codex-app-serverruntime mag selecteren. Alleen het voorvoegsel openai/* selecteert geen runtime.

• Agentmodellen - openai/* via de runtime die is geselecteerd door expliciete agentRuntime-configuratie of het impliciete routebeleid van OpenAI. Meld je aan met Codex- authenticatie om een ChatGPT/Codex-abonnement te gebruiken, of configureer een authenticatieprofiel met API-sleutel wanneer je facturering op basis van een sleutel wilt.
• OpenAI-API's zonder agent - directe toegang tot OpenAI Platform, gefactureerd per gebruik, via OPENAI_API_KEY of een openai-authenticatieprofiel met API-sleutel.
• Verouderde configuratie - verwijzingen naar codex/* en openai-codex/* worden door openclaw doctor --fix hersteld naar openai/* plus modelgebonden agentRuntime.id: "codex".

OpenAI ondersteunt expliciet het gebruik van OAuth-abonnementen in externe tools en workflows zoals OpenClaw.

Gebruiks- en kostentracering

OpenClaw houdt abonnementsquota en facturering voor de Platform-API gescheiden:

• ChatGPT/Codex OAuth toont het abonnementsplan, quotumperioden en creditsaldo.
• OPENAI_ADMIN_KEY toont 30 dagen aan door de provider gerapporteerde organisatiekosten en completions-gebruik in Gebruik van de Control UI, inclusief dagelijkse uitgaven, totalen voor aanvragen/tokens, meestgebruikte modellen en kostencategorieën.
• OPENAI_PROJECT_ID beperkt de geschiedenis van de Admin API optioneel tot één project.
• OpenClaw stuurt nooit OPENAI_API_KEY of een openai-inferentieprofiel naar organisatie-API's; die aanmeldgegevens kunnen bij aangepaste, Azure- of agentlokale eindpunten horen.

Een expliciete beheerderssleutel heeft voorrang op OAuth. Door de provider gerapporteerde geschiedenis wordt niet samengevoegd met de uit sessies afgeleide geschatte kosten van OpenClaw; deze kan API-activiteit van andere clients en factureringscorrecties van de provider bevatten.

De documentatie van OpenAI over het dashboard voor API-gebruik beschrijft de vereisten voor organisatie-eigenaars en expliciete machtigingen voor het Usage Dashboard om gebruiksgegevens te bekijken.

Provider, model, runtime en kanaal zijn afzonderlijke lagen. Als deze labels door elkaar raken, lees dan Agentruntimes voordat je de configuratie wijzigt.

Snelle keuze

Naamgevingsschema

Impliciete agentruntime

Wanneer het provider/modelbeleid voor agentRuntime niet is ingesteld of auto is, kiest het providergebonden routebeleid van OpenAI de impliciete runtime op basis van het effectieve eindpunt en de adapter:

Een expliciete niet-standaard provider/model-agentRuntime.id blijft bepalend. Zo houdt agentRuntime.id: "openclaw" een route die anders voor Codex in aanmerking komt op OpenClaw, terwijl agentRuntime.id: "codex" Codex vereist en gesloten faalt wanneer de effectieve route niet als Codex-compatibel is gedeclareerd. Runtimeselectie verandert het type aanmeldgegevens of de facturering niet: authenticatie met een API-sleutel voor de Platform-API en ChatGPT/Codex-abonnementsauthenticatie blijven gescheiden.

openclaw doctor --fix migreert verouderde modelverwijzingen naar codex/* en openai-codex/*, verouderde Codex-authenticatieprofiel-id's en verouderde Codex-vermeldingen voor authenticatievolgorde naar de canonieke openai-route. Gemigreerde modelverwijzingen krijgen modelgebonden agentRuntime.id: "codex"; gebruik auth.order.openai voor nieuwe configuratie van de authenticatievolgorde.

Beperkte preview van GPT-5.6

OpenClaw herkent de exacte model-id's openai/gpt-5.6-sol, openai/gpt-5.6-terra en openai/gpt-5.6-luna. Alle drie bieden xhigh- en max-redenering in de huidige catalogus. OpenAI beschrijft Sol als de vlaggenschiplaag, Terra als de uitgebalanceerde laag en Luna als de snelle, goedkopere laag. Zie de aankondiging van de lancering van GPT-5.6 en de toegangsgids.

Bij directe OpenAI-authenticatie met een API-sleutel is de kale openai/gpt-5.6-id een alias voor Sol en de standaard voor een nieuwe configuratie. De systeemeigen Codex-catalogus past die directe API-alias niet aan de clientzijde toe; afhankelijk van de werkruimtetoegang kan deze de exacte Sol-, Terra- en Luna-id's tonen. Een nieuwe ChatGPT/Codex OAuth-configuratie gebruikt daarom openai/gpt-5.6-sol. Controleer het huidige account met:

openclaw models list --provider openai

Toegang voor de API-organisatie en de Codex-werkruimte kan verschillen. Als GPT-5.6 niet beschikbaar is, selecteer GPT-5.5 dan expliciet:

openclaw models set openai/gpt-5.5

OpenClaw toont de upstream-toegangsfout en vervangt een GPT-5.6-selectie niet stilzwijgend door GPT-5.5.

Functiedekking van OpenClaw

Geheugenembeddings

OpenClaw kan OpenAI, of een OpenAI-compatibel embedding-eindpunt, gebruiken voor memory_search-indexering en query-embeddings:

{  memory: {    search: {      provider: "openai",      model: "text-embedding-3-small",    },  },}

Stel voor OpenAI-compatibele eindpunten die asymmetrische embeddinglabels vereisen queryInputType en documentInputType in onder memory.search. OpenClaw stuurt deze door als providerspecifieke input_type-aanvraagvelden: query- embeddings gebruiken queryInputType; geïndexeerde geheugenfragmenten en batchindexering gebruiken documentInputType. Zie de Referentie voor geheugenconfiguratie voor het volledige voorbeeld.

Aan de slag

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.6" } } },}

{  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.6-sol

openclaw models list --provider openai

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

{  plugins: { entries: { codex: { enabled: true } } },  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-sol" },    },  },  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.6-terra",            name: "GPT-5.6 Terra",            contextWindow: 1050000,            contextTokens: 922000,            maxTokens: 128000,          },        ],      },    },  },  agents: {    defaults: {      model: { primary: "openai/gpt-5.6-terra" },      models: {        "openai/gpt-5.6-terra": {          agentRuntime: { id: "openclaw" },          params: {            responsesServerCompaction: true,            responsesCompactThreshold: 700000,          },        },      },    },  },}

Verificatie voor de systeemeigen Codex-app-server

De systeemeigen Codex-app-serverharness gebruikt openai/*-modelreferenties wanneer deze impliciet wordt geselecteerd door een geschikte exacte officiële HTTPS-route, of wanneer provider/model agentRuntime.id: "codex" deze expliciet selecteert. De verificatie blijft accountgebaseerd. OpenClaw selecteert verificatie in deze volgorde:

1. Geordende OpenAI-verificatieprofielen voor de agent, bij voorkeur onder auth.order.openai. Voer openclaw doctor --fix uit om oudere verouderde Codex-verificatieprofiel-ID's en de verificatievolgorde te migreren.
2. Het bestaande account van de app-server, zoals een lokale ChatGPT- aanmelding bij de Codex CLI. Voor de standaard geïsoleerde thuismap van de agent koppelt OpenClaw dat systeemeigen CLI-account via de aanmeldings-RPC aan de app-server; het deelt niet de configuratie, plugins of threadopslag van de CLI.
3. Alleen voor lokale app-serverstarts via stdio, en uitsluitend wanneer de app-server meldt dat er geen account is: CODEX_API_KEY, gevolgd door OPENAI_API_KEY.

Een lokale aanmelding met een ChatGPT/Codex-abonnement wordt niet vervangen alleen omdat het Gateway-proces ook OPENAI_API_KEY bevat voor rechtstreekse OpenAI-modellen of embeddings. De terugval op een API-sleutel uit de omgeving geldt uitsluitend voor het lokale stdio-pad zonder account; deze sleutel wordt nooit via WebSocket-verbindingen met de app-server verzonden. Wanneer een Codex-profiel in abonnementsstijl is geselecteerd, houdt OpenClaw ook CODEX_API_KEY en OPENAI_API_KEY buiten het gestarte stdio-app-serverkindproces en verzendt het de geselecteerde referenties in plaats daarvan via de aanmeldings-RPC van de app-server.

Wanneer dat abonnementsprofiel wordt geblokkeerd door een Codex-gebruikslimiet, markeert OpenClaw het profiel als geblokkeerd tot de door Codex vermelde hersteltijd en laat het de verificatievolgorde doorschakelen naar het volgende openai:*-profiel, zonder het geselecteerde model te wijzigen of de Codex-harness te verlaten. Zodra de hersteltijd is verstreken, komt het abonnementsprofiel weer in aanmerking.

Afbeeldingen genereren

De meegeleverde Plugin openai registreert het genereren van afbeeldingen via de tool image_generate. Deze ondersteunt zowel het genereren van afbeeldingen met een OpenAI-API-sleutel als met Codex OAuth via dezelfde modelreferentie openai/gpt-image-2.

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

gpt-image-2 is de standaard voor het genereren en bewerken van afbeeldingen op basis van tekst met OpenAI. gpt-image-1.5, gpt-image-1 en gpt-image-1-mini blijven bruikbaar als expliciete modeloverschrijvingen. Gebruik openai/gpt-image-1.5 voor PNG/WebP-uitvoer met een transparante achtergrond; de huidige gpt-image-2-API weigert background: "transparent".

Roep voor een verzoek met transparante achtergrond image_generate aan met model: "openai/gpt-image-1.5", outputFormat: "png" of "webp", en background: "transparent"; de oudere provideroptie openai.background wordt nog steeds geaccepteerd. OpenClaw beschermt ook de openbare routes voor OpenAI en OpenAI Codex OAuth door standaard transparante verzoeken voor openai/gpt-image-2 te herschrijven naar gpt-image-1.5; Azure en aangepaste OpenAI-compatibele eindpunten behouden hun geconfigureerde implementatie- en modelnamen.

Dezelfde instelling is beschikbaar voor headless CLI-uitvoeringen:

openclaw infer image generate \  --model openai/gpt-image-1.5 \  --output-format png \  --background transparent \  --prompt "Een eenvoudige sticker met een rode cirkel op een transparante achtergrond" \  --json

Gebruik dezelfde vlaggen --output-format en --background met openclaw infer image edit wanneer je met een invoerbestand begint. --openai-background blijft beschikbaar als een OpenAI-specifieke alias. Gebruik --quality low|medium|high|auto om de kwaliteit en kosten van OpenAI Images te regelen. Gebruik --openai-moderation low|auto om de moderatiehint van OpenAI door te geven vanuit image generate of image edit.

Voor ChatGPT/Codex OAuth-installaties behoud je dezelfde openai/gpt-image-2-ref. Wanneer een openai OAuth-profiel is geconfigureerd, haalt OpenClaw dat opgeslagen OAuth- toegangstoken op en verstuurt het afbeeldingsverzoeken via de Codex Responses-backend; het probeert niet eerst OPENAI_API_KEY en valt niet stilzwijgend terug op een API-sleutel. Configureer models.providers.openai expliciet met een API-sleutel, aangepaste basis- URL of Azure-eindpunt wanneer je in plaats daarvan de directe route via de OpenAI Images API wilt gebruiken. Als dat aangepaste afbeeldingseindpunt zich op een vertrouwd LAN/privéadres bevindt, stel je ook browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true in; OpenClaw houdt privé/interne OpenAI-compatibele afbeeldingseindpunten geblokkeerd tenzij deze opt-in aanwezig is.

Genereren:

/tool image_generate model=openai/gpt-image-2 prompt="Een verzorgde lanceringsposter voor OpenClaw op macOS" size=3840x2160 count=1

Een transparante PNG genereren:

/tool image_generate model=openai/gpt-image-1.5 prompt="Een eenvoudige sticker met een rode cirkel op een transparante achtergrond" outputFormat=png background=transparent

Bewerken:

/tool image_generate model=openai/gpt-image-2 prompt="Behoud de vorm van het object en verander het materiaal in doorschijnend glas" image=/path/to/reference.png size=1024x1536

Videogeneratie

De meegeleverde openai-plugin registreert videogeneratie via de tool video_generate.

OpenAI-verzoeken voor afbeelding-naar-video gebruiken POST /v1/videos met een input_reference-afbeelding. Bewerkingen van één video gebruiken POST /v1/videos/edits met de geüploade video in het veld video.

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

GPT-5-promptbijdrage

OpenClaw voegt een gedeelde GPT-5-promptbijdrage toe voor modellen uit de GPT-5-familie bij de provider openai (inclusief verouderde Codex-refs van vóór de reparatie die worden genormaliseerd naar openai/*). Andere providers die ook model-id's uit de GPT-5-familie aanbieden, zoals OpenRouter- of opencode-routes, ontvangen deze overlay niet; deze wordt bepaald door provider-id openai, niet alleen door de model-id. Oudere GPT-4.x-modellen ontvangen deze nooit.

De native Codex-app-serverharnas ontvangt het gedragscontract voor persona/tool- discipline of de vriendelijke overlay voor interactiestijl niet via ontwikkelaarsinstructies; native Codex behoudt het door Codex beheerde gedrag voor basis, model en projectdocumentatie, en OpenClaw schakelt de ingebouwde persoonlijkheid van Codex uit voor native threads, zodat persoonlijkheidsbestanden in de agentwerkruimte gezaghebbend blijven. OpenClaw draagt alleen runtimecontext bij aan native Codex-threads: kanaal- aflevering, dynamische OpenClaw-tools, ACP-delegatie, werkruimtecontext en OpenClaw Skills. De Heartbeat-begeleidingstekst uit dezelfde bijdrage is de enige uitzondering: native Codex-Heartbeat-beurten ontvangen deze wel, geïnjecteerd als afzonderlijke samenwerkingsinstructies in plaats van via de gedeelde hook voor promptbijdragen.

De GPT-5-bijdrage voegt een getagd gedragscontract toe voor persona- persistentie, uitvoeringsveiligheid, tooldiscipline, uitvoervorm, voltooiings- controles en verificatie bij overeenkomende door OpenClaw samengestelde prompts. Kanaal- specifiek antwoord- en stilberichtgedrag blijft in de gedeelde OpenClaw-systeem- prompt en het beleid voor uitgaande aflevering. De vriendelijke laag voor interactiestijl is afzonderlijk en configureerbaar.

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

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

Stem en spraak

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

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

Azure OpenAI-eindpunten

De meegeleverde provider openai kan voor het genereren van afbeeldingen een Azure OpenAI-resource gebruiken door de basis-URL te overschrijven. In het pad voor het genereren van afbeeldingen detecteert OpenClaw Azure-hostnamen in models.providers.openai.baseUrl en schakelt het automatisch over op de aanvraagstructuur van Azure.

Gebruik Azure OpenAI wanneer:

• Je al een Azure OpenAI-abonnement, quotum of zakelijke overeenkomst hebt
• Je regionale gegevensopslag of door Azure geboden nalevingsmaatregelen nodig hebt
• Je verkeer binnen een bestaande Azure-tenant wilt houden

Configuratie

Voor het genereren van Azure-afbeeldingen via de meegeleverde provider openai stel je models.providers.openai.baseUrl in op je Azure-resource en apiKey op de Azure OpenAI-sleutel (niet een OpenAI Platform-sleutel):

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

OpenClaw herkent deze Azure-hostachtervoegsels voor de Azure-route voor het genereren van afbeeldingen:

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

Voor aanvragen voor het genereren van afbeeldingen op een herkende Azure-host doet OpenClaw het volgende:

• Verzendt de header api-key in plaats van Authorization: Bearer
• Gebruikt implementatiespecifieke paden (/openai/deployments/{deployment}/...)
• Voegt ?api-version=... toe aan elke aanvraag
• Gebruikt een standaardtime-out van 600s voor Azure-aanroepen voor het genereren van afbeeldingen. Waarden voor timeoutMs per aanroep overschrijven deze standaardwaarde nog steeds.

Andere basis-URL's (openbare OpenAI, OpenAI-compatibele proxy's) behouden de standaard OpenAI-aanvraagstructuur voor afbeeldingen.

API-versie

Stel AZURE_OPENAI_API_VERSION in om een specifieke Azure-preview- of GA-versie vast te zetten voor het Azure-pad voor het genereren van afbeeldingen:

export AZURE_OPENAI_API_VERSION="2024-12-01-preview"

De standaardwaarde is 2024-12-01-preview wanneer de variabele niet is ingesteld.

Modelnamen zijn implementatienamen

Azure OpenAI koppelt modellen aan implementaties. Voor aanvragen voor het genereren van Azure-afbeeldingen die via de meegeleverde provider openai worden gerouteerd, moet het veld model in OpenClaw de Azure-implementatienaam zijn die je in de Azure-portal hebt geconfigureerd, niet de openbare OpenAI-model-id.

Als je een implementatie met de naam gpt-image-2-prod maakt die gpt-image-2 aanbiedt:

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

Dezelfde regel voor implementatienamen geldt voor elke aanroep voor het genereren van afbeeldingen die via de meegeleverde provider openai wordt gerouteerd.

Regionale beschikbaarheid

Het genereren van Azure-afbeeldingen is momenteel alleen beschikbaar in een deel van de regio's (bijvoorbeeld eastus2, swedencentral, polandcentral, westus3, uaenorth). Controleer de actuele regiolijst van Microsoft voordat je een implementatie maakt en controleer of het specifieke model in jouw regio wordt aangeboden.

Parameterverschillen

Azure OpenAI en openbaar OpenAI accepteren niet altijd dezelfde afbeeldingsparameters. Azure kan opties weigeren die openbaar OpenAI wel toestaat (bijvoorbeeld bepaalde waarden voor background bij gpt-image-2) of deze alleen beschikbaar stellen voor specifieke modelversies. Deze verschillen zijn afkomstig van Azure en het onderliggende model, niet van OpenClaw. Als een Azure-aanvraag mislukt met een validatiefout, controleer dan in de Azure-portal de parameterset die door jouw specifieke implementatie en API-versie wordt ondersteund.

Geavanceerde configuratie

De onderstaande voorbeelden voor params per model bepalen de ingesloten provideraanvraag van OpenClaw. Het configureren ervan is expliciet gedefinieerd aanvraaggedrag, waardoor een anders geschikte route auto bij OpenClaw blijft in plaats van Codex impliciet te selecteren. De oorspronkelijke Codex-app-serverharness beheert zijn eigen transport- en aanvraaginstellingen; expliciete agentRuntime.id: "codex" wordt veilig geweigerd wanneer de effectieve route niet als Codex-compatibel is gedeclareerd.

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

Gerelateerd