> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# OpenAI
OpenAI biedt ontwikkelaars-API's voor GPT-modellen, en Codex is ook beschikbaar als
coding agent met ChatGPT-abonnement via OpenAI's Codex-clients. OpenClaw gebruikt één
provider-id, `openai`, voor beide auth-vormen.
OpenClaw gebruikt `openai/*` als de canonieke OpenAI-modelroute. Ingebedde agent-
beurten op OpenAI-modellen lopen standaard via de native Codex app-server-runtime;
directe OpenAI API-key-auth blijft beschikbaar voor niet-agent-OpenAI-
oppervlakken zoals afbeeldingen, embeddings, spraak en realtime.
* **Agentmodellen** - `openai/*`-modellen via de Codex-runtime; meld je aan met
Codex-auth voor gebruik met een ChatGPT/Codex-abonnement, of configureer een Codex-compatibel
OpenAI API-key-reserveprofiel wanneer je bewust API-key-auth wilt.
* **Niet-agent-OpenAI-API's** - directe OpenAI Platform-toegang met gebruiksgebaseerde
facturering via `OPENAI_API_KEY` of OpenAI API-key-onboarding.
* **Verouderde config** - verouderde Codex-modelrefs worden door
`openclaw doctor --fix` gerepareerd naar `openai/*` plus de Codex-runtime.
OpenAI ondersteunt expliciet OAuth-gebruik met abonnementen in externe tools en workflows zoals OpenClaw.
Provider, model, runtime en kanaal zijn afzonderlijke lagen. Als die labels
door elkaar gaan lopen, lees dan [Agentruntimes](/nl/concepts/agent-runtimes) voordat
je de config wijzigt.
## Snelle keuze
| Doel | Gebruik | Opmerkingen |
| --------------------------------------------------- | ---------------------------------------------------------- | ---------------------------------------------------------------------------------- |
| ChatGPT/Codex-abonnement met native Codex-runtime | `openai/gpt-5.5` | Standaard OpenAI-agentinstallatie. Meld je aan met Codex-auth. |
| GPT-5.6 beperkte preview | `openai/gpt-5.6-sol`, `-terra` of `-luna` | Vereist een door OpenAI goedgekeurde API-organisatie of Codex-werkruimte. |
| Directe API-key-facturering voor agentmodellen | `openai/gpt-5.5` plus een Codex-compatibel API-key-profiel | Gebruik `auth.order.openai` om het reserveprofiel na abonnements-auth te plaatsen. |
| Directe API-key-facturering via expliciete OpenClaw | `openai/gpt-5.5` plus provider-/modelruntime `openclaw` | Selecteer een normaal `openai` API-key-profiel. |
| Nieuwste ChatGPT Instant API-alias | `openai/chat-latest` | Alleen directe API-key. Bewegende alias voor experimenten, niet de standaard. |
| ChatGPT/Codex-abonnements-auth via OpenClaw | `openai/gpt-5.5` plus provider-/modelruntime `openclaw` | Selecteer een `openai` OAuth-profiel voor de compatibiliteitsroute. |
| Afbeeldingen genereren of bewerken | `openai/gpt-image-2` | Werkt met `OPENAI_API_KEY` of OpenAI Codex OAuth. |
| Afbeeldingen met transparante achtergrond | `openai/gpt-image-1.5` | Gebruik `outputFormat=png` of `webp` en `openai.background=transparent`. |
## Namenkaart
De namen lijken op elkaar, maar zijn niet uitwisselbaar:
| Naam die je ziet | Laag | Betekenis |
| --------------------------------------- | ----------------- | ----------------------------------------------------------------------------------------------- |
| `openai` | Provider-prefix | Canonieke OpenAI-modelroute; agentbeurten gebruiken de Codex-runtime. |
| verouderde OpenAI Codex-prefix | Verouderde prefix | Oudere model-/profiel-namespace. `openclaw doctor --fix` migreert deze naar `openai`. |
| `codex`-Plugin | Plugin | Gebundelde OpenClaw-Plugin die native Codex app-server-runtime en `/codex`-chatbediening biedt. |
| provider/model `agentRuntime.id: codex` | Agentruntime | Dwing de native Codex app-server-harness af voor overeenkomende ingebedde beurten. |
| `/codex ...` | Chatcommandoset | Codex app-server-threads vanuit een gesprek koppelen/beheren. |
| `runtime: "acp", agentId: "codex"` | ACP-sessieroute | Expliciet fallbackpad dat Codex via ACP/acpx uitvoert. |
Dit betekent dat een config bewust `openai/*`-modelrefs kan bevatten terwijl auth-
profielen naar API-key- of ChatGPT/Codex OAuth-referenties wijzen. Gebruik
`auth.order.openai` voor config; `openclaw doctor --fix` herschrijft verouderde
legacy Codex-modelrefs, verouderde Codex-auth-profiel-id's en
verouderde Codex-auth-volgorde naar de canonieke OpenAI-route.
GPT-5.5 is beschikbaar via zowel directe OpenAI Platform API-key-toegang als
abonnements-/OAuth-routes. Gebruik voor ChatGPT/Codex-abonnement plus native Codex-
uitvoering `openai/gpt-5.5`; zonder runtime-config wordt nu de Codex-
harness geselecteerd voor OpenAI-agentbeurten. Gebruik OpenAI API-key-profielen alleen wanneer je
directe API-key-auth voor een OpenAI-agentmodel wilt.
## GPT-5.6 beperkte preview
OpenClaw herkent de drie openbare GPT-5.6-model-id's:
* `openai/gpt-5.6-sol`
* `openai/gpt-5.6-terra`
* `openai/gpt-5.6-luna`
Alle drie bieden `max`-redenering in de huidige Codex app-server-catalogus. De
OpenAI-lanceringsaankondiging beschrijft Sol als het vlaggenschipniveau, Terra als het
gebalanceerde niveau en Luna als het snelle, goedkopere niveau. Zie de
[GPT-5.6-lanceringsaankondiging](https://openai.com/index/previewing-gpt-5-6-sol/)
en [previewtoegangsgids](https://help.openai.com/en/articles/20001325-a-preview-of-gpt-5-6-sol-terra-and-luna).
Toegang staat tijdens de preview op een allowlist en kan afzonderlijk worden verleend voor de
API en Codex. Alleen een betaald ChatGPT-abonnement geeft geen toegang. OpenClaw houdt
`openai/gpt-5.5` als standaard; het selecteren van een GPT-5.6-ref zonder toegang retourneert
de upstream-toegangsfout in plaats van stilzwijgend terug te vallen.
OpenAI-agentmodelbeurten vereisen de gebundelde Codex app-server-Plugin. Expliciete
OpenClaw-runtimeconfig blijft beschikbaar als opt-in compatibiliteitsroute. Wanneer OpenClaw
expliciet wordt geselecteerd met een `openai` OAuth-profiel, behoudt OpenClaw de
openbare modelref als `openai/*` en routeert intern via het Codex-auth-
transport. Voer `openclaw doctor --fix` uit om verouderde
legacy Codex-modelrefs, `codex-cli/*` of oude runtime-sessiepins te repareren die niet afkomstig zijn van
expliciete runtimeconfig.
## OpenClaw-functiedekking
| OpenAI-mogelijkheid | OpenClaw-oppervlak | Status |
| --------------------------- | --------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
| Chat / Responses | `openai/`-modelprovider | Ja |
| Codex-abonnementsmodellen | `openai/` met OpenAI OAuth | Ja |
| Legacy Codex-modelrefs | legacy Codex-modelrefs of `codex-cli/` | Gerepareerd door doctor naar `openai/` |
| Codex app-server-harness | `openai/` met weggelaten runtime of provider/model `agentRuntime.id: codex` | Ja |
| Server-side web search | Native OpenAI Responses-tool | Ja, wanneer zoeken op het web is ingeschakeld en geen provider is vastgezet |
| Afbeeldingen | `image_generate` | Ja |
| Video's | `video_generate` | Ja |
| Tekst-naar-spraak | `messages.tts.provider: "openai"` / `tts` | Ja |
| Batchspraak-naar-tekst | `tools.media.audio` / mediabegrip | Ja |
| Streaming spraak-naar-tekst | Voice Call `streaming.provider: "openai"` | Ja |
| Realtime spraak | Voice Call `realtime.provider: "openai"` / Control UI Talk `talk.realtime.provider: "openai"` | Ja (vereist OpenAI Platform-tegoed, geen Codex/ChatGPT-abonnement) |
| Embeddings | memory embedding-provider | Ja |
OpenAI Realtime-spraak (gebruikt door Voice Call's `realtime.provider: "openai"` en
Control UI Talk met `talk.realtime.provider: "openai"`) loopt via de
openbare **OpenAI Platform Realtime API**, die wordt gefactureerd op OpenAI
Platform-tegoed in plaats van Codex/ChatGPT-abonnementstegoed. Een account
met gezonde OpenAI OAuth dat zonder problemen Codex-ondersteunde chatmodellen uitvoert
heeft nog steeds een OpenAI API-key-auth-profiel of een Platform API-key met gefinancierde
Platform-facturering nodig voor Realtime-spraak.
Oplossing: vul Platform-tegoed aan op
[platform.openai.com/account/billing](https://platform.openai.com/account/billing)
voor de organisatie achter je realtime-referenties. Realtime-spraak accepteert
het `openai` API-key-auth-profiel dat is gemaakt door `openclaw onboard --auth-choice openai-api-key`,
een Platform `OPENAI_API_KEY` geconfigureerd via `talk.realtime.providers.openai.apiKey`
voor Control UI Talk, `plugins.entries.voice-call.config.realtime.providers.openai.apiKey`
voor Voice Call, of de omgevingsvariabele `OPENAI_API_KEY`. OpenAI OAuth-
profielen kunnen nog steeds Codex-ondersteunde `openai/*`-chatmodellen uitvoeren in dezelfde
OpenClaw-installatie, maar ze configureren Realtime-spraak niet.
## Memory-embeddings
OpenClaw kan OpenAI, of een OpenAI-compatibel embedding-eindpunt, gebruiken voor
`memory_search`-indexering en query-embeddings:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
memorySearch: {
provider: "openai",
model: "text-embedding-3-small",
},
},
},
}
```
Voor OpenAI-compatibele eindpunten die asymmetrische embedding-labels vereisen, stel je
`queryInputType` en `documentInputType` in onder `memorySearch`. OpenClaw stuurt
die door als providerspecifieke `input_type`-aanvraagvelden: query-embeddings gebruiken
`queryInputType`; geïndexeerde geheugenfragmenten en batchindexering gebruiken
`documentInputType`. Zie de [referentie voor Memory-configuratie](/nl/reference/memory-config#provider-specific-config) voor het volledige voorbeeld.
## Aan de slag
Kies je gewenste auth-methode en volg de installatiestappen.
**Beste voor:** directe API-toegang en gebruiksgebaseerde facturering.
Maak of kopieer een API-key vanuit het [OpenAI Platform-dashboard](https://platform.openai.com/api-keys).
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice openai-api-key
```
Of geef de sleutel direct door:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --openai-api-key "$OPENAI_API_KEY"
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider openai
```
### Routesamenvatting
| Modelref | Runtimeconfiguratie | Route | Authenticatie |
| --------------------- | ------------------------------------------------------ | --------------------------- | ------------------------------- |
| `openai/gpt-5.5` | weggelaten / provider/model `agentRuntime.id: "codex"` | Codex app-server-harnas | Codex-compatibel OpenAI-profiel |
| `openai/gpt-5.4-mini` | weggelaten / provider/model `agentRuntime.id: "codex"` | Codex app-server-harnas | Codex-compatibel OpenAI-profiel |
| `openai/gpt-5.5` | provider/model `agentRuntime.id: "openclaw"` | Ingebouwde OpenClaw-runtime | Geselecteerd `openai`-profiel |
`openai/*`-agentmodellen gebruiken het Codex app-server-harnas. Om API-sleutel-
authenticatie voor een agentmodel te gebruiken, maak je een Codex-compatibel API-sleutelprofiel en orden je
dit met `auth.order.openai`; `OPENAI_API_KEY` blijft de directe fallback voor
niet-agent OpenAI API-oppervlakken. Voer `openclaw doctor --fix` uit om oudere
legacy Codex-authenticatievolgorde-items te migreren.
### Configuratievoorbeeld
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
env: { OPENAI_API_KEY: "example-openai-key-not-real" },
agents: { defaults: { model: { primary: "openai/gpt-5.5" } } },
}
```
Om het huidige Instant-model van ChatGPT via de OpenAI API te proberen, stel je het model
in op `openai/chat-latest`:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
env: { OPENAI_API_KEY: "example-openai-key-not-real" },
agents: { defaults: { model: { primary: "openai/chat-latest" } } },
}
```
`chat-latest` is een bewegende alias. OpenAI documenteert dit als het nieuwste Instant-
model dat in ChatGPT wordt gebruikt en raadt `gpt-5.5` aan voor productiegebruik van de API, dus
houd `openai/gpt-5.5` aan als stabiele standaard, tenzij je expliciet dat
aliasgedrag wilt. De alias accepteert momenteel alleen `medium` tekstuitvoerigheid, dus
OpenClaw normaliseert incompatibele OpenAI-overschrijvingen voor tekstuitvoerigheid voor dit
model.
OpenClaw stelt `gpt-5.3-codex-spark` **niet** beschikbaar via de directe OpenAI API-sleutelroute. Het is alleen beschikbaar via Codex-abonnementscatalogusitems wanneer je ingelogde account dit aanbiedt.
**Beste voor:** je ChatGPT/Codex-abonnement gebruiken met native Codex app-server-uitvoering in plaats van een aparte API-sleutel. Codex cloud vereist aanmelding bij ChatGPT.
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice openai
```
Of voer OAuth direct uit:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth login --provider openai
```
Voor headless setups of setups die callbacks slecht ondersteunen, voeg je `--device-code` toe om je aan te melden met een ChatGPT-device-codeflow in plaats van de localhost-browsercallback:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth login --provider openai --device-code
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw config set agents.defaults.model.primary openai/gpt-5.5
```
Er is geen runtimeconfiguratie vereist voor het standaardpad. OpenAI-agentbeurten
selecteren automatisch de native Codex app-server-runtime, en OpenClaw
installeert of repareert de meegeleverde Codex-Plugin wanneer deze route wordt gekozen.
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models list --provider openai
```
Nadat de Gateway actief is, stuur je `/codex status` of `/codex models`
in de chat om de native app-server-runtime te controleren.
### Routesamenvatting
| Modelref | Runtimeconfiguratie | Route | Authenticatie |
| ------------------------ | ------------------------------------------------------ | ------------------------------------------------------------------- | ---------------------------------------------------------- |
| `openai/gpt-5.5` | weggelaten / provider/model `agentRuntime.id: "codex"` | Native Codex app-server-harnas | Codex-aanmelding of geordend `openai`-authenticatieprofiel |
| `openai/gpt-5.5` | provider/model `agentRuntime.id: "openclaw"` | Ingebouwde OpenClaw-runtime met intern Codex-authenticatietransport | Geselecteerd `openai` OAuth-profiel |
| legacy Codex GPT-5.5-ref | gerepareerd door doctor | Legacy route herschreven naar `openai/gpt-5.5` | Gemigreerd OpenAI OAuth-profiel |
| `codex-cli/gpt-5.5` | gerepareerd door doctor | Legacy CLI-route herschreven naar `openai/gpt-5.5` | Codex app-server-authenticatie |
Geef de voorkeur aan `openai/gpt-5.5` voor nieuwe agentconfiguratie met abonnementsbacking. Oudere
legacy Codex GPT-refs zijn legacy OpenClaw-routes, niet het native Codex-runtime
pad; voer `openclaw doctor --fix` uit wanneer je ze wilt migreren naar canonieke
`openai/*`-refs. `gpt-5.3-codex-spark` blijft beperkt tot accounts waarvan de
Codex-abonnementscatalogus dat model adverteert; directe OpenAI API-sleutel- en
Azure-refs ervoor blijven onderdrukt.
Het legacy Codex-modelvoorvoegsel is legacy configuratie die door doctor wordt gerepareerd. Voor
de gangbare setup met abonnement plus native runtime meld je je aan met Codex-authenticatie,
maar houd je de modelref op `openai/gpt-5.5`. Nieuwe configuratie moet de OpenAI-
agentauthenticatievolgorde onder `auth.order.openai` plaatsen; doctor migreert oudere
legacy Codex-authenticatievolgorde-items.
### Configuratievoorbeeld
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
plugins: { entries: { codex: { enabled: true } } },
agents: {
defaults: {
model: { primary: "openai/gpt-5.5" },
},
},
}
```
Met een API-sleutelback-up houd je het model op `openai/gpt-5.5` en plaats je de
authenticatievolgorde onder `openai`. OpenClaw probeert eerst het abonnement, daarna
de API-sleutel, terwijl het op het Codex-harnas blijft:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
plugins: { entries: { codex: { enabled: true } } },
agents: {
defaults: {
model: { primary: "openai/gpt-5.5" },
},
},
auth: {
order: {
openai: [
"openai:user@example.com",
"openai:api-key-backup",
],
},
},
}
```
Onboarding importeert geen OAuth-materiaal meer uit `~/.codex`. Meld je aan met browser-OAuth (standaard) of de device-codeflow hierboven — OpenClaw beheert de resulterende referenties in zijn eigen authenticatieopslag voor agents.
### Codex OAuth-routing controleren en herstellen
Gebruik deze commando's om te zien welk model, welke runtime en welke authenticatieroute je standaard
agent gebruikt:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models status
openclaw models auth list --provider openai
openclaw config get agents.defaults.model --json
openclaw config get models.providers.openai.agentRuntime --json
```
Voor een specifieke agent voeg je `--agent ` toe:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models status --agent
openclaw models auth list --agent --provider openai
```
Als een oudere configuratie nog legacy Codex GPT-refs of een verouderde OpenAI-runtime
sessiepin zonder expliciete runtimeconfiguratie heeft, repareer je dit:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw doctor --fix
openclaw config validate
```
Als `models auth list --provider openai` geen bruikbaar profiel toont, meld je je
opnieuw aan:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth login --provider openai
openclaw models status --probe --probe-provider openai
```
Gebruik `--profile-id` wanneer je meerdere Codex OAuth-aanmeldingen in dezelfde
agent wilt en ze later wilt beheren via authenticatievolgorde of `/model ...@`:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw models auth login --provider openai --profile-id openai:ritsuko
openclaw models auth login --provider openai --profile-id openai:lain
```
`openai/*` is de modelroute voor OpenAI-agentbeurten via Codex. Voer
`openclaw doctor --fix` uit om oudere legacy OpenAI Codex-voorvoegselprofiel-id's en
volgorde-items te migreren voordat je vertrouwt op profielvolgorde.
### Statusindicator
Chat `/status` toont welke modelruntime actief is voor de huidige sessie.
Het meegeleverde Codex app-server-harnas verschijnt als `Runtime: OpenAI Codex` voor
OpenAI-agentmodelbeurten. Verouderde OpenAI-runtime sessiepins worden gerepareerd naar Codex, tenzij
de configuratie OpenClaw expliciet vastpint.
### Doctor-waarschuwing
Als legacy Codex-modelrefs of verouderde OpenAI-runtimepins in de configuratie of
sessiestatus blijven staan, herschrijft `openclaw doctor --fix` ze naar `openai/*` met de
Codex-runtime, tenzij OpenClaw expliciet is geconfigureerd.
### Contextvensterlimiet
OpenClaw behandelt modelmetadata en de runtimecontextlimiet als aparte waarden.
Voor `openai/gpt-5.5` via de Codex OAuth-catalogus:
* Native `contextWindow`: `1000000`
* Standaard runtime-`contextTokens`-limiet: `272000`
De kleinere standaardlimiet heeft in de praktijk betere latency- en kwaliteitskenmerken. Overschrijf deze met `contextTokens`:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
models: {
providers: {
openai: {
models: [{ id: "gpt-5.5", contextTokens: 160000 }],
},
},
},
}
```
Gebruik `contextWindow` om native modelmetadata te declareren. Gebruik `contextTokens` om het runtimecontextbudget te beperken.
### Catalogusherstel
OpenClaw gebruikt upstream Codex-catalogusmetadata voor `gpt-5.5` wanneer die
aanwezig is. Als live Codex-discovery de rij `gpt-5.5` weglaat terwijl
het account is geauthenticeerd, synthetiseert OpenClaw die OAuth-modelrij zodat
Cron-, sub-agent- en geconfigureerde standaardmodelruns niet mislukken met
`Unknown model`.
## Native Codex app-server-authenticatie
Het native Codex app-server-harnas gebruikt `openai/*`-modelrefs plus weggelaten
runtimeconfiguratie of provider/model `agentRuntime.id: "codex"`, maar de authenticatie is
nog steeds accountgebaseerd. OpenClaw selecteert authenticatie in deze volgorde:
1. Geordende OpenAI-authenticatieprofielen voor de agent, bij voorkeur onder
`auth.order.openai`. Voer `openclaw doctor --fix` uit om oudere
legacy Codex-authenticatieprofiel-id's en legacy Codex-authenticatievolgorde te migreren.
2. Het bestaande account van de app-server, zoals een lokale Codex CLI ChatGPT-aanmelding.
3. Alleen voor lokale stdio app-server-starts: `CODEX_API_KEY`, daarna
`OPENAI_API_KEY`, wanneer de app-server geen account rapporteert en nog steeds
OpenAI-authenticatie vereist.
Dat betekent dat een lokale ChatGPT/Codex-abonnementsaanmelding niet wordt vervangen alleen
omdat het Gateway-proces ook `OPENAI_API_KEY` heeft voor directe OpenAI-modellen
of embeddings. Env API-sleutelfallback is alleen het lokale stdio-pad zonder account; deze
wordt niet naar WebSocket app-serververbindingen gestuurd. Wanneer een abonnementachtig Codex-
profiel is geselecteerd, houdt OpenClaw ook `CODEX_API_KEY` en `OPENAI_API_KEY`
uit het gestarte stdio app-server-kindproces en stuurt het de geselecteerde referenties
via de app-server-login-RPC. Wanneer dat abonnementsprofiel wordt geblokkeerd door een
Codex-gebruikslimiet, kan OpenClaw roteren naar het volgende geordende `openai:*` API-sleutel-
profiel zonder het geselecteerde model te wijzigen of uit het Codex-
harnas te vallen. Zodra de reset-tijd van het abonnement is verstreken, komt het abonnementsprofiel
weer in aanmerking.
## Afbeeldingsgeneratie
De meegeleverde `openai`-Plugin registreert afbeeldingsgeneratie via de tool `image_generate`.
Deze ondersteunt zowel afbeeldingsgeneratie met OpenAI API-sleutel als Codex OAuth-afbeeldings-
generatie via dezelfde `openai/gpt-image-2`-modelref.
| Mogelijkheid | OpenAI API-sleutel | Codex OAuth |
| ------------------------------ | ------------------------------------------- | -------------------------------------------------- |
| Modelverwijzing | `openai/gpt-image-2` | `openai/gpt-image-2` |
| Auth | `OPENAI_API_KEY` | OpenAI Codex OAuth-aanmelding |
| Transport | OpenAI Images API | Codex Responses-backend |
| Max. afbeeldingen per aanvraag | 4 | 4 |
| Bewerkingsmodus | Ingeschakeld (tot 5 referentieafbeeldingen) | Ingeschakeld (tot 5 referentieafbeeldingen) |
| Grootte-overschrijvingen | Ondersteund, inclusief 2K/4K-formaten | Ondersteund, inclusief 2K/4K-formaten |
| Beeldverhouding / resolutie | Niet doorgestuurd naar OpenAI Images API | Waar veilig toegewezen aan een ondersteund formaat |
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
imageGenerationModel: { primary: "openai/gpt-image-2" },
},
},
}
```
Zie [Afbeeldingsgeneratie](/nl/tools/image-generation) voor gedeelde toolparameters, providerselectie en failovergedrag.
`gpt-image-2` is de standaard voor zowel OpenAI-tekst-naar-afbeeldinggeneratie als afbeeldingsbewerking. `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 transparante achtergrond; de huidige `gpt-image-2`-API weigert `background: "transparent"`.
Voor een aanvraag met transparante achtergrond moeten agents `image_generate` aanroepen 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 OpenAI- en OpenAI Codex OAuth-routes door standaard transparante aanvragen voor `openai/gpt-image-2` te herschrijven naar `gpt-image-1.5`; Azure en aangepaste OpenAI-compatibele endpoints behouden hun geconfigureerde deployment-/modelnamen.
Dezelfde instelling is beschikbaar voor headless CLI-runs:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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
```
Gebruik dezelfde vlaggen `--output-format` en `--background` met `openclaw infer image edit` wanneer je vanuit een invoerbestand start. `--openai-background` blijft beschikbaar als OpenAI-specifiek alias. Gebruik `--quality low|medium|high|auto` wanneer je de kwaliteit en kosten van OpenAI Images moet beheren. Gebruik `--openai-moderation low|auto` om OpenAI's providerspecifieke moderatiehint door te geven vanuit `image generate` of `image edit`.
Voor ChatGPT/Codex OAuth-installaties behoud je dezelfde `openai/gpt-image-2`-verwijzing. Wanneer een `openai` OAuth-profiel is geconfigureerd, lost OpenClaw dat opgeslagen OAuth-toegangstoken op en verzendt het afbeeldingsaanvragen via de Codex Responses-backend. Het probeert niet eerst `OPENAI_API_KEY` en valt voor die aanvraag niet stil terug op een API-sleutel. Configureer `models.providers.openai` expliciet met een API-sleutel, aangepaste basis-URL of Azure-endpoint wanneer je in plaats daarvan de directe OpenAI Images API-route wilt.
Als dat aangepaste afbeeldingsendpoint zich op een vertrouwd LAN-/privéadres bevindt, stel dan ook `browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true` in; OpenClaw houdt private/interne OpenAI-compatibele afbeeldingsendpoints geblokkeerd tenzij deze opt-in aanwezig is.
Genereren:
```
/tool image_generate model=openai/gpt-image-2 prompt="A polished launch poster for OpenClaw on macOS" size=3840x2160 count=1
```
Een transparante PNG genereren:
```
/tool image_generate model=openai/gpt-image-1.5 prompt="A simple red circle sticker on a transparent background" outputFormat=png background=transparent
```
Bewerken:
```
/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
```
## Videogeneratie
De gebundelde `openai` Plugin registreert videogeneratie via de tool `video_generate`.
| Mogelijkheid | Waarde |
| ------------------------ | ------------------------------------------------------------------------------------------- |
| Standaardmodel | `openai/sora-2` |
| Modi | Tekst-naar-video, afbeelding-naar-video, bewerking van één video |
| Referentie-invoer | 1 afbeelding of 1 video |
| Grootte-overschrijvingen | Ondersteund voor tekst-naar-video en afbeelding-naar-video |
| Andere overschrijvingen | `aspectRatio`, `resolution`, `audio`, `watermark` worden genegeerd met een toolwaarschuwing |
OpenAI-afbeelding-naar-video-aanvragen gebruiken `POST /v1/videos` met een afbeelding-`input_reference`. Bewerkingen van één video gebruiken `POST /v1/videos/edits` met de geüploade video in het veld `video`.
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
videoGenerationModel: { primary: "openai/sora-2" },
},
},
}
```
Zie [Videogeneratie](/nl/tools/video-generation) voor gedeelde toolparameters, providerselectie en failovergedrag.
## GPT-5-promptbijdrage
OpenClaw voegt een gedeelde GPT-5-promptbijdrage toe voor GPT-5-familieruns op door OpenClaw samengestelde promptoppervlakken. Deze wordt toegepast op basis van model-id, zodat OpenClaw-/providerroutes zoals verouderde pre-repair-verwijzingen (verouderde Codex GPT-5.5-verwijzing), `openrouter/openai/gpt-5.5`, `opencode/gpt-5.5` en andere compatibele GPT-5-verwijzingen dezelfde overlay ontvangen. Oudere GPT-4.x-modellen niet.
De gebundelde native Codex-harness ontvangt deze OpenClaw GPT-5-overlay niet via ontwikkelaarsinstructies van de Codex app-server. Native Codex behoudt door Codex beheerd basis-, model- en projectdocumentgedrag, terwijl OpenClaw de ingebouwde persoonlijkheid van Codex uitschakelt voor native threads zodat persoonlijkheidsbestanden in de agentwerkruimte leidend blijven. OpenClaw draagt alleen runtimecontext bij, zoals kanaallevering, dynamische OpenClaw-tools, ACP-delegatie, werkruimtecontext en OpenClaw Skills.
De GPT-5-bijdrage voegt een getagd gedragscontract toe voor personapersistentie, uitvoeringsveiligheid, tooldiscipline, uitvoervorm, voltooiingscontroles en verificatie op overeenkomende door OpenClaw samengestelde prompts. Kanaalspecifiek antwoord- en stilberichtgedrag blijft in de gedeelde OpenClaw-systeemprompt en het uitgaande leveringsbeleid. De vriendelijke interactiestijllaag is afzonderlijk en configureerbaar.
| Waarde | Effect |
| ------------------------ | ---------------------------------------------- |
| `"friendly"` (standaard) | Schakel de vriendelijke interactiestijllaag in |
| `"on"` | Alias voor `"friendly"` |
| `"off"` | Schakel alleen de vriendelijke stijllaag uit |
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
promptOverlays: {
gpt5: { personality: "friendly" },
},
},
},
}
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw config set agents.defaults.promptOverlays.gpt5.personality off
```
Waarden zijn tijdens runtime hoofdletterongevoelig, dus `"Off"` en `"off"` schakelen beide de vriendelijke stijllaag uit.
Verouderde `plugins.entries.openai.config.personality` wordt nog steeds gelezen als compatibiliteitsfallback wanneer de gedeelde instelling `agents.defaults.promptOverlays.gpt5.personality` niet is ingesteld.
## Stem en spraak
De gebundelde `openai` Plugin registreert spraaksynthese voor het oppervlak `messages.tts`.
| Instelling | Configuratiepad | Standaard |
| ----------- | -------------------------------------------------------- | ------------------------------------------------ |
| Model | `messages.tts.providers.openai.model` | `gpt-4o-mini-tts` |
| Stem | `messages.tts.providers.openai.speakerVoice` | `coral` |
| Snelheid | `messages.tts.providers.openai.speed` | (niet ingesteld) |
| Instructies | `messages.tts.providers.openai.instructions` | (niet ingesteld, alleen `gpt-4o-mini-tts`) |
| Formaat | `messages.tts.providers.openai.responseFormat` | `opus` voor spraaknotities, `mp3` voor bestanden |
| API-sleutel | `messages.tts.providers.openai.apiKey` | Valt terug op `OPENAI_API_KEY` |
| Basis-URL | `messages.tts.providers.openai.baseUrl` | `https://api.openai.com/v1` |
| Extra body | `messages.tts.providers.openai.extraBody` / `extra_body` | (niet ingesteld) |
Beschikbare modellen: `gpt-4o-mini-tts`, `tts-1`, `tts-1-hd`. Beschikbare stemmen: `alloy`, `ash`, `ballad`, `cedar`, `coral`, `echo`, `fable`, `juniper`, `marin`, `onyx`, `nova`, `sage`, `shimmer`, `verse`.
`extraBody` wordt samengevoegd in de aanvraag-JSON voor `/audio/speech` na de door OpenClaw gegenereerde velden, dus gebruik dit voor OpenAI-compatibele endpoints die aanvullende sleutels zoals `lang` vereisen. Prototypesleutels worden genegeerd.
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
messages: {
tts: {
providers: {
openai: { model: "gpt-4o-mini-tts", speakerVoice: "coral" },
},
},
},
}
```
Stel `OPENAI_TTS_BASE_URL` in om de TTS-basis-URL te overschrijven zonder het chat-API-endpoint te beïnvloeden. OpenAI TTS en Realtime-spraak worden beide geconfigureerd via een OpenAI Platform API-sleutel; installaties met alleen OAuth kunnen nog steeds door Codex ondersteunde chatmodellen gebruiken, maar geen live OpenAI-terugspraak.
De gebundelde `openai` Plugin registreert batch-spraak-naar-tekst via OpenClaw's media-understanding-transcriptieoppervlak.
* Standaardmodel: `gpt-4o-transcribe`
* Endpoint: OpenAI REST `/v1/audio/transcriptions`
* Invoerpad: multipart-audiobestandsupload
* Ondersteund door OpenClaw overal waar inkomende audiotranscriptie `tools.media.audio` gebruikt, inclusief Discord-spraakkanaalsegmenten en audio-bijlagen van kanalen
Om OpenAI af te dwingen voor inkomende audiotranscriptie:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
tools: {
media: {
audio: {
models: [
{
type: "provider",
provider: "openai",
model: "gpt-4o-transcribe",
},
],
},
},
},
}
```
Taal- en prompthints worden doorgestuurd naar OpenAI wanneer ze worden geleverd door de gedeelde audiomediaconfiguratie of de transcriptieaanvraag per aanroep.
De gebundelde `openai` Plugin registreert realtime-transcriptie voor de Voice Call Plugin.
| Instelling | Configuratiepad | Standaard |
| ----------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------------ |
| Model | `plugins.entries.voice-call.config.streaming.providers.openai.model` | `gpt-4o-transcribe` |
| Taal | `...openai.language` | (niet ingesteld) |
| Prompt | `...openai.prompt` | (niet ingesteld) |
| Stilteduur | `...openai.silenceDurationMs` | `800` |
| VAD-drempel | `...openai.vadThreshold` | `0.5` |
| Auth | `...openai.apiKey`, `OPENAI_API_KEY`, of `openai` OAuth | API-sleutels verbinden rechtstreeks; OAuth geeft een Realtime-transcriptieclientgeheim uit |
Gebruikt een WebSocket-verbinding naar `wss://api.openai.com/v1/realtime` met G.711 u-law (`g711_ulaw` / `audio/pcmu`)-audio. Wanneer alleen `openai` OAuth is geconfigureerd, geeft de Gateway een kortstondig Realtime-transcriptieclientgeheim uit voordat de WebSocket wordt geopend. Deze streamingprovider is bedoeld voor het realtime-transcriptiepad van Voice Call; Discord-spraak neemt momenteel korte segmenten op en gebruikt in plaats daarvan het batch-transcriptiepad `tools.media.audio`.
De gebundelde `openai` Plugin registreert realtime-spraak voor de Voice Call Plugin.
| Instelling | Configuratiepad | Standaard |
| ------------------------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| Model | `plugins.entries.voice-call.config.realtime.providers.openai.model` | `gpt-realtime-2` |
| Stem | `...openai.voice` | `alloy` |
| Temperatuur (Azure-implementatiebrug) | `...openai.temperature` | `0.8` |
| VAD-drempel | `...openai.vadThreshold` | `0.5` |
| Stilteperiode | `...openai.silenceDurationMs` | `500` |
| Prefix-padding | `...openai.prefixPaddingMs` | `300` |
| Redeneerinspanning | `...openai.reasoningEffort` | (niet ingesteld) |
| Auth | `openai` API-key-authprofiel, `...openai.apiKey`, of `OPENAI_API_KEY` | OpenAI Platform API-key vereist; OpenAI OAuth configureert geen Realtime-spraak |
Beschikbare ingebouwde Realtime-stemmen voor `gpt-realtime-2`: `alloy`, `ash`,
`ballad`, `coral`, `echo`, `sage`, `shimmer`, `verse`, `marin`, `cedar`.
OpenAI raadt `marin` en `cedar` aan voor de beste Realtime-kwaliteit. Dit
is een aparte set ten opzichte van de tekst-naar-spraakstemmen hierboven; ga er niet van uit dat een TTS-
stem zoals `fable`, `nova`, of `onyx` geldig is voor Realtime-sessies.
Backend OpenAI-realtimebruggen gebruiken de GA Realtime WebSocket-sessievorm, die `session.temperature` niet accepteert. Azure OpenAI-implementaties blijven beschikbaar via `azureEndpoint` en `azureDeployment` en behouden de implementatiecompatibele sessievorm. Ondersteunt bidirectionele toolaanroepen en G.711 u-law-audio.
Realtime-spraak wordt geselecteerd wanneer de sessie wordt gemaakt. OpenAI staat toe dat de meeste
sessievelden later worden gewijzigd, maar de stem kan niet worden gewijzigd nadat het
model audio heeft uitgezonden in die sessie. OpenClaw stelt momenteel de
ingebouwde Realtime-spraak-id's beschikbaar als strings.
Control UI Talk gebruikt OpenAI-browserrealtimesessies met een door de Gateway uitgegeven
tijdelijke clientsecret en een directe WebRTC SDP-uitwisseling vanuit de browser met de
OpenAI Realtime API. De Gateway geeft dat clientsecret uit met het geselecteerde
`openai` API-key-authprofiel of de geconfigureerde OpenAI Platform API-key. Gateway-
relay en backend-realtime-WebSocket-bruggen voor Voice Call gebruiken hetzelfde
authpad met alleen API-key voor native OpenAI-eindpunten. Liveverificatie door maintainers
is beschikbaar met
`OPENAI_API_KEY=... GEMINI_API_KEY=... node --import tsx scripts/dev/realtime-talk-live-smoke.ts`;
de OpenAI-onderdelen verifiëren zowel de backend-WebSocket-brug als de WebRTC SDP-uitwisseling
in de browser zonder secrets te loggen.
## Azure OpenAI-eindpunten
De gebundelde `openai`-provider kan een Azure OpenAI-resource gebruiken voor afbeeldingsgeneratie
door de basis-URL te overschrijven. Op het pad voor afbeeldingsgeneratie detecteert OpenClaw
Azure-hostnamen op `models.providers.openai.baseUrl` en schakelt automatisch over naar
de aanvraagvorm van Azure.
Realtime-spraak gebruikt een apart configuratiepad
(`plugins.entries.voice-call.config.realtime.providers.openai.azureEndpoint`)
en wordt niet beïnvloed door `models.providers.openai.baseUrl`. Zie de accordion **Realtime-
spraak** onder [Spraak en geluid](#voice-and-speech) voor de Azure-
instellingen.
Gebruik Azure OpenAI wanneer:
* Je al een Azure OpenAI-abonnement, quotum of enterprise-overeenkomst hebt
* Je regionale dataresidentie of compliancecontroles nodig hebt die Azure biedt
* Je verkeer binnen een bestaande Azure-tenant wilt houden
### Configuratie
Voor Azure-afbeeldingsgeneratie via de gebundelde `openai`-provider wijs je
`models.providers.openai.baseUrl` naar je Azure-resource en stel je `apiKey` in op
de Azure OpenAI-key (niet een OpenAI Platform-key):
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
models: {
providers: {
openai: {
baseUrl: "https://.openai.azure.com",
apiKey: "",
},
},
},
}
```
OpenClaw herkent deze Azure-hostsuffixen voor de route voor Azure-afbeeldingsgeneratie:
* `*.openai.azure.com`
* `*.services.ai.azure.com`
* `*.cognitiveservices.azure.com`
Voor aanvragen voor afbeeldingsgeneratie op een herkende Azure-host doet OpenClaw het volgende:
* Verstuurt de header `api-key` in plaats van `Authorization: Bearer`
* Gebruikt implementatiegebonden paden (`/openai/deployments/{deployment}/...`)
* Voegt `?api-version=...` toe aan elke aanvraag
* Gebruikt een standaardaanvraagtime-out van 600 s voor Azure-aanroepen voor afbeeldingsgeneratie.
`timeoutMs`-waarden per aanroep overschrijven deze standaardwaarde nog steeds.
Andere basis-URL's (publieke OpenAI, OpenAI-compatibele proxy's) behouden de standaard
OpenAI-aanvraagvorm voor afbeeldingen.
Azure-routering voor het pad voor afbeeldingsgeneratie van de `openai`-provider vereist
OpenClaw 2026.4.22 of later. Eerdere versies behandelen elke aangepaste
`openai.baseUrl` als het publieke OpenAI-eindpunt en mislukken tegen Azure-
afbeeldingsimplementaties.
### API-versie
Stel `AZURE_OPENAI_API_VERSION` in om een specifieke Azure-preview- of GA-versie vast te zetten
voor het pad voor Azure-afbeeldingsgeneratie:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
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 Azure-aanvragen voor afbeeldingsgeneratie
die via de gebundelde `openai`-provider worden gerouteerd, moet het veld `model` in OpenClaw
de **Azure-implementatienaam** zijn die je in de Azure-portal hebt geconfigureerd, niet
de publieke OpenAI-model-id.
Als je een implementatie maakt met de naam `gpt-image-2-prod` die `gpt-image-2` aanbiedt:
```
/tool image_generate model=openai/gpt-image-2-prod prompt="A clean poster" size=1024x1024 count=1
```
Dezelfde regel voor implementatienamen geldt voor aanroepen voor afbeeldingsgeneratie die via
de gebundelde `openai`-provider worden gerouteerd.
### Regionale beschikbaarheid
Azure-afbeeldingsgeneratie is momenteel alleen beschikbaar in een subset van regio's
(bijvoorbeeld `eastus2`, `swedencentral`, `polandcentral`, `westus3`,
`uaenorth`). Controleer de actuele regiolijst van Microsoft voordat je een
implementatie maakt, en bevestig dat het specifieke model in je regio wordt aangeboden.
### Parameterverschillen
Azure OpenAI en publieke OpenAI accepteren niet altijd dezelfde afbeeldingsparameters.
Azure kan opties weigeren die publieke OpenAI toestaat (bijvoorbeeld bepaalde
`background`-waarden op `gpt-image-2`) of ze alleen beschikbaar stellen op specifieke model-
versies. Deze verschillen komen van Azure en het onderliggende model, niet van
OpenClaw. Als een Azure-aanvraag mislukt met een validatiefout, controleer dan de
parameterset die door jouw specifieke implementatie en API-versie wordt ondersteund in de
Azure-portal.
Azure OpenAI gebruikt native transport en compatgedrag, maar ontvangt niet
de verborgen attributieheaders van OpenClaw — zie de accordion **Native versus OpenAI-compatibele
routes** onder [Geavanceerde configuratie](#advanced-configuration).
Gebruik voor chat- of Responses-verkeer op Azure (naast afbeeldingsgeneratie) de
onboardingflow of een speciale Azure-providerconfiguratie — alleen `openai.baseUrl`
neemt niet de Azure API-/authvorm over. Er bestaat een aparte
`azure-openai-responses/*`-provider; zie
de accordion Server-side Compaction hieronder.
## Geavanceerde configuratie
OpenClaw gebruikt WebSocket eerst met SSE-terugval (`"auto"`) voor `openai/*`.
In de modus `"auto"` doet OpenClaw het volgende:
* Probeert één vroege WebSocket-fout opnieuw voordat er wordt teruggevallen op SSE
* Markeert WebSocket na een fout ongeveer 60 seconden als gedegradeerd en gebruikt SSE tijdens de afkoelperiode
* Voegt stabiele sessie- en beurtidentiteitsheaders toe voor nieuwe pogingen en opnieuw verbinden
* Normaliseert gebruikstellers (`input_tokens` / `prompt_tokens`) tussen transportvarianten
| Waarde | Gedrag |
| -------------------- | ----------------------------- |
| `"auto"` (standaard) | WebSocket eerst, SSE-terugval |
| `"sse"` | Alleen SSE afdwingen |
| `"websocket"` | Alleen WebSocket afdwingen |
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
models: {
"openai/gpt-5.5": {
params: { transport: "auto" },
},
},
},
},
}
```
Gerelateerde OpenAI-documentatie:
* [Realtime API met WebSocket](https://platform.openai.com/docs/guides/realtime-websocket)
* [Streaming API-responses (SSE)](https://platform.openai.com/docs/guides/streaming-responses)
OpenClaw stelt een gedeelde schakelaar voor snelle modus beschikbaar voor `openai/*`:
* **Chat/UI:** `/fast status|auto|on|off`
* **Configuratie:** `agents.defaults.models["/"].params.fastMode`
Wanneer ingeschakeld koppelt OpenClaw snelle modus aan prioriteitsverwerking van OpenAI (`service_tier = "priority"`). Bestaande `service_tier`-waarden blijven behouden, en snelle modus herschrijft `reasoning` of `text.verbosity` niet. `fastMode: "auto"` start nieuwe modelaanroepen snel tot aan de automatische afkapgrens, en start latere retry-, fallback-, toolresultaat- of vervolgaanroepen daarna zonder snelle modus. De afkapgrens is standaard 60 seconden; stel `params.fastAutoOnSeconds` in op het actieve model om dit te wijzigen.
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
models: {
"openai/gpt-5.5": { params: { fastMode: "auto", fastAutoOnSeconds: 30 } },
},
},
},
}
```
Sessie-overschrijvingen hebben voorrang op configuratie. Door de sessie-overschrijving in de Sessions UI te wissen, keert de sessie terug naar de geconfigureerde standaardwaarde.
De API van OpenAI stelt prioriteitsverwerking beschikbaar via `service_tier`. Stel dit per model in OpenClaw in:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
models: {
"openai/gpt-5.5": { params: { serviceTier: "priority" } },
},
},
},
}
```
Ondersteunde waarden: `auto`, `default`, `flex`, `priority`.
`serviceTier` wordt alleen doorgestuurd naar native OpenAI-eindpunten (`api.openai.com`) en native Codex-eindpunten (`chatgpt.com/backend-api`). Als je een van beide providers via een proxy routeert, laat OpenClaw `service_tier` ongemoeid.
Voor directe OpenAI Responses-modellen (`openai/*` op `api.openai.com`) schakelt de OpenAI Plugin-streamwrapper van OpenClaw automatisch server-side Compaction in:
* Dwingt `store: true` af (tenzij modelcompatibiliteit `supportsStore: false` instelt)
* Injecteert `context_management: [{ type: "compaction", compact_threshold: ... }]`
* Standaard `compact_threshold`: 70% van `contextWindow` (of `80000` wanneer niet beschikbaar)
Dit geldt voor het ingebouwde runtimepad van OpenClaw en voor OpenAI-providerhooks die door ingesloten runs worden gebruikt. De native Codex app-server-harness beheert zijn eigen context via Codex en wordt geconfigureerd door de standaard agentroute van OpenAI of het runtimebeleid voor provider/model.
Nuttig voor compatibele eindpunten zoals Azure OpenAI Responses:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
models: {
"azure-openai-responses/gpt-5.5": {
params: { responsesServerCompaction: true },
},
},
},
},
}
```
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
models: {
"openai/gpt-5.5": {
params: {
responsesServerCompaction: true,
responsesCompactThreshold: 120000,
},
},
},
},
},
}
```
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
models: {
"openai/gpt-5.5": {
params: { responsesServerCompaction: false },
},
},
},
},
}
```
`responsesServerCompaction` regelt alleen de injectie van `context_management`. Directe OpenAI Responses-modellen dwingen nog steeds `store: true` af, tenzij compatibiliteit `supportsStore: false` instelt.
Voor GPT-5-familie-uitvoeringen op `openai/*` kan OpenClaw een strikter ingebed uitvoeringscontract gebruiken:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
agents: {
defaults: {
embeddedAgent: { executionContract: "strict-agentic" },
},
},
}
```
Met `strict-agentic` doet OpenClaw het volgende:
* Schakelt `update_plan` automatisch in voor substantieel werk
* Probeert structureel lege of alleen-redenering-beurten opnieuw met een voortzetting met zichtbaar antwoord
* Gebruikt expliciete harness-planevents wanneer de geselecteerde harness die levert
OpenClaw classificeert assistentproza niet om te bepalen of een beurt een plan, voortgangsupdate of eindantwoord is.
Alleen van toepassing op OpenAI- en Codex GPT-5-familie-uitvoeringen. Andere providers en oudere modelfamilies behouden standaardgedrag.
OpenClaw behandelt directe OpenAI-, Codex- en Azure OpenAI-eindpunten anders dan generieke OpenAI-compatibele `/v1`-proxy's:
**Native routes** (`openai/*`, Azure OpenAI):
* Behouden `reasoning: { effort: "none" }` alleen voor modellen die de OpenAI-inspanning `none` ondersteunen
* Laten uitgeschakelde redenering weg voor modellen of proxy's die `reasoning.effort: "none"` weigeren
* Stellen toolschema's standaard in op strikte modus
* Voegen verborgen attributieheaders alleen toe op geverifieerde native hosts
* Behouden OpenAI-specifieke requestvorming (`service_tier`, `store`, redeneringscompatibiliteit, prompt-cachehints)
**Proxy-/compatibele routes:**
* Gebruiken losser compatibiliteitsgedrag
* Verwijderen Completions `store` uit niet-native `openai-completions`-payloads
* Accepteren geavanceerde `params.extra_body`/`params.extraBody` doorgegeven JSON voor OpenAI-compatibele Completions-proxy's
* Accepteren `params.chat_template_kwargs` voor OpenAI-compatibele Completions-proxy's zoals vLLM
* Forceren geen strikte toolschema's of alleen-native headers
Azure OpenAI gebruikt native transport en compatibiliteitsgedrag, maar ontvangt de verborgen attributieheaders niet.
## Gerelateerd
Providers, modelrefs en failovergedrag kiezen.
Gedeelde parameters voor afbeeldingstools en providerselectie.
Gedeelde parameters voor videotools en providerselectie.
Auth-details en regels voor hergebruik van referenties.