---
read_when:
- Je wilt Grok-modellen gebruiken in OpenClaw
- Je configureert xAI-authenticatie of model-id’s
summary: xAI Grok-modellen gebruiken in OpenClaw
title: xAI
x-i18n:
generated_at: "2026-05-11T20:47:40Z"
model: gpt-5.5
provider: openai
source_hash: f11c31e7ff39e7e13465b48d819db3921a32ed624676a57dc38f97c0dbd21e46
source_path: providers/xai.md
workflow: 16
---
OpenClaw levert een meegeleverde `xai` provider-Plugin voor Grok-modellen.
## Aan de slag
Maak een API-sleutel aan in de [xAI-console](https://console.x.ai/).
Stel `XAI_API_KEY` in, of voer uit:
```bash
openclaw onboard --auth-choice xai-api-key
```
```json5
{
agents: { defaults: { model: { primary: "xai/grok-4.3" } } },
}
```
OpenClaw gebruikt de xAI Responses API als het meegeleverde xAI-transport. Dezelfde
API-sleutel van `openclaw onboard --auth-choice xai-api-key` kan ook eersteklas
`x_search` en externe `code_execution` aandrijven; `XAI_API_KEY` of Plugin-
webzoekconfiguratie kan ook door Grok ondersteunde `web_search` aandrijven.
Als je een xAI-sleutel opslaat onder `plugins.entries.xai.config.webSearch.apiKey`,
hergebruikt de meegeleverde xAI-modelprovider die sleutel ook als fallback.
Stel `plugins.entries.xai.config.webSearch.baseUrl` in om Grok `web_search`
en, standaard, `x_search` via een xAI Responses-proxy van de operator te routeren.
Afstemming van `code_execution` staat onder `plugins.entries.xai.config.codeExecution`.
## Ingebouwde catalogus
OpenClaw bevat standaard deze xAI-modelfamilies:
| Familie | Model-id's |
| -------------- | ------------------------------------------------------------------------ |
| Grok 3 | `grok-3`, `grok-3-fast`, `grok-3-mini`, `grok-3-mini-fast` |
| Grok 4.3 | `grok-4.3` |
| Grok 4 | `grok-4`, `grok-4-0709` |
| Grok 4 Fast | `grok-4-fast`, `grok-4-fast-non-reasoning` |
| Grok 4.1 Fast | `grok-4-1-fast`, `grok-4-1-fast-non-reasoning` |
| Grok 4.20 Beta | `grok-4.20-beta-latest-reasoning`, `grok-4.20-beta-latest-non-reasoning` |
| Grok Code | `grok-code-fast-1` |
De Plugin lost ook nieuwere `grok-4*`- en `grok-code-fast*`-id's voorwaarts op wanneer
ze dezelfde API-vorm volgen.
`grok-4.3`, `grok-4-fast`, `grok-4-1-fast` en de `grok-4.20-beta-*`-
varianten zijn de huidige beeldgeschikte Grok-referenties in de meegeleverde catalogus.
## OpenClaw-functiedekking
De meegeleverde Plugin koppelt het huidige openbare API-oppervlak van xAI aan de gedeelde
provider- en toolcontracten van OpenClaw. Mogelijkheden die niet in het gedeelde contract passen
(bijvoorbeeld streaming-TTS en realtime spraak) worden niet beschikbaar gemaakt - zie de tabel
hieronder.
| xAI-mogelijkheid | OpenClaw-oppervlak | Status |
| -------------------------- | ----------------------------------------- | ------------------------------------------------------------------- |
| Chat / Responses | `xai/` modelprovider | Ja |
| Webzoekopdracht aan serverzijde | `web_search` provider `grok` | Ja |
| X-zoekopdracht aan serverzijde | `x_search` tool | Ja |
| Code-uitvoering aan serverzijde | `code_execution` tool | Ja |
| Afbeeldingen | `image_generate` | Ja |
| Video's | `video_generate` | Ja |
| Batch tekst-naar-spraak | `messages.tts.provider: "xai"` / `tts` | Ja |
| Streaming-TTS | - | Niet beschikbaar gemaakt; OpenClaw's TTS-contract retourneert volledige audiobuffers |
| Batch spraak-naar-tekst | `tools.media.audio` / mediabegrip | Ja |
| Streaming spraak-naar-tekst | Voice Call `streaming.provider: "xai"` | Ja |
| Realtime spraak | - | Nog niet beschikbaar gemaakt; ander sessie-/WebSocket-contract |
| Bestanden / batches | Alleen generieke model-API-compatibiliteit | Geen eersteklas OpenClaw-tool |
OpenClaw gebruikt xAI's REST-API's voor afbeeldingen/video/TTS/STT voor mediageneratie,
spraak en batchtranscriptie, xAI's streaming-STT-WebSocket voor live
transcriptie van spraakoproepen, en de Responses API voor model-, zoek- en
code-uitvoeringstools. Functies die andere OpenClaw-contracten nodig hebben, zoals
realtime spraaksessies, worden hier gedocumenteerd als upstream-mogelijkheden in plaats van
verborgen Plugin-gedrag.
### Fast-modus-toewijzingen
`/fast on` of `agents.defaults.models["xai/"].params.fastMode: true`
herschrijft native xAI-verzoeken als volgt:
| Bronmodel | Fast-modus-doel |
| ------------- | ------------------ |
| `grok-3` | `grok-3-fast` |
| `grok-3-mini` | `grok-3-mini-fast` |
| `grok-4` | `grok-4-fast` |
| `grok-4-0709` | `grok-4-fast` |
### Legacy-compatibiliteitsaliassen
Legacy-aliassen normaliseren nog steeds naar de canonieke meegeleverde id's:
| Legacy-alias | Canonieke id |
| ------------------------- | ------------------------------------- |
| `grok-4-fast-reasoning` | `grok-4-fast` |
| `grok-4-1-fast-reasoning` | `grok-4-1-fast` |
| `grok-4.20-reasoning` | `grok-4.20-beta-latest-reasoning` |
| `grok-4.20-non-reasoning` | `grok-4.20-beta-latest-non-reasoning` |
## Functies
De meegeleverde `grok` webzoekprovider kan `XAI_API_KEY` of een Plugin-
webzoeksleutel gebruiken:
```bash
openclaw config set tools.web.search.provider grok
```
De meegeleverde `xai`-Plugin registreert videogeneratie via de gedeelde
`video_generate` tool.
- Standaard videomodel: `xai/grok-imagine-video`
- Modi: tekst-naar-video, afbeelding-naar-video, generatie met referentieafbeelding, externe
videobewerking en externe video-uitbreiding
- Beeldverhoudingen: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`
- Resoluties: `480P`, `720P`
- Duur: 1-15 seconden voor generatie/afbeelding-naar-video, 1-10 seconden bij
gebruik van `reference_image`-rollen, 2-10 seconden voor uitbreiding
- Generatie met referentieafbeelding: stel `imageRoles` in op `reference_image` voor
elke meegeleverde afbeelding; xAI accepteert maximaal 7 zulke afbeeldingen
Lokale videobuffers worden niet geaccepteerd. Gebruik externe `http(s)`-URL's voor
video-invoer voor bewerken/uitbreiden. Afbeelding-naar-video accepteert lokale afbeeldingsbuffers omdat
OpenClaw die als data-URL's voor xAI kan coderen.
Om xAI als standaard videoprovider te gebruiken:
```json5
{
agents: {
defaults: {
videoGenerationModel: {
primary: "xai/grok-imagine-video",
},
},
},
}
```
Zie [Videogeneratie](/nl/tools/video-generation) voor gedeelde toolparameters,
providerselectie en failover-gedrag.
De meegeleverde `xai`-Plugin registreert afbeeldingsgeneratie via de gedeelde
`image_generate` tool.
- Standaard afbeeldingsmodel: `xai/grok-imagine-image`
- Aanvullend model: `xai/grok-imagine-image-pro`
- Modi: tekst-naar-afbeelding en bewerken met referentieafbeelding
- Referentie-invoer: één `image` of maximaal vijf `images`
- Beeldverhoudingen: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `2:3`, `3:2`
- Resoluties: `1K`, `2K`
- Aantal: maximaal 4 afbeeldingen
OpenClaw vraagt xAI om `b64_json` afbeeldingsreacties zodat gegenereerde media kunnen worden
opgeslagen en geleverd via het normale pad voor kanaalbijlagen. Lokale
referentieafbeeldingen worden omgezet naar data-URL's; externe `http(s)`-referenties worden
doorgegeven.
Om xAI als standaard afbeeldingsprovider te gebruiken:
```json5
{
agents: {
defaults: {
imageGenerationModel: {
primary: "xai/grok-imagine-image",
},
},
},
}
```
xAI documenteert ook `quality`, `mask`, `user` en aanvullende native verhoudingen
zoals `1:2`, `2:1`, `9:20` en `20:9`. OpenClaw stuurt vandaag alleen de
gedeelde cross-provider afbeeldingsinstellingen door; niet-ondersteunde, alleen native knoppen
worden bewust niet beschikbaar gemaakt via `image_generate`.
De meegeleverde `xai`-Plugin registreert tekst-naar-spraak via het gedeelde `tts`
provideroppervlak.
- Stemmen: `eve`, `ara`, `rex`, `sal`, `leo`, `una`
- Standaardstem: `eve`
- Formaten: `mp3`, `wav`, `pcm`, `mulaw`, `alaw`
- Taal: BCP-47-code of `auto`
- Snelheid: provider-native snelheidsoverschrijving
- Native Opus-spraaknotitieformaat wordt niet ondersteund
Om xAI als standaard TTS-provider te gebruiken:
```json5
{
messages: {
tts: {
provider: "xai",
providers: {
xai: {
voiceId: "eve",
},
},
},
},
}
```
OpenClaw gebruikt xAI's batch-`/v1/tts`-endpoint. xAI biedt ook streaming-TTS
via WebSocket, maar het spraakprovidercontract van OpenClaw verwacht momenteel
een volledige audiobuffer vóór aflevering van het antwoord.
De meegeleverde `xai`-Plugin registreert batch spraak-naar-tekst via OpenClaw's
transcriptieoppervlak voor mediabegrip.
- Standaardmodel: `grok-stt`
- Endpoint: xAI REST `/v1/stt`
- Invoerpad: upload van multipart-audiobestand
- Ondersteund door OpenClaw overal waar transcriptie van inkomende audio
`tools.media.audio` gebruikt, inclusief Discord-spraakkanaalsegmenten en
audiobijlagen van kanalen
Om xAI af te dwingen voor transcriptie van inkomende audio:
```json5
{
tools: {
media: {
audio: {
models: [
{
type: "provider",
provider: "xai",
model: "grok-stt",
},
],
},
},
},
}
```
Taal kan worden opgegeven via de gedeelde audiomediaconfiguratie of per-call
transcriptieverzoek. Prompt-hints worden geaccepteerd door het gedeelde OpenClaw-
oppervlak, maar de xAI REST STT-integratie stuurt alleen bestand, model en
taal door omdat die netjes aansluiten op het huidige openbare xAI-endpoint.
De meegeleverde `xai`-Plugin registreert ook een realtime transcriptieprovider
voor live spraakoproepaudio.
- Endpoint: xAI WebSocket `wss://api.x.ai/v1/stt`
- Standaardcodering: `mulaw`
- Standaard samplefrequentie: `8000`
- Standaard endpointing: `800ms`
- Tussentijdse transcripties: standaard ingeschakeld
De Twilio-mediastream van Voice Call verzendt G.711 µ-law-audioframes, zodat de
xAI-provider die frames rechtstreeks kan doorsturen zonder transcoding:
```json5
{
plugins: {
entries: {
"voice-call": {
config: {
streaming: {
enabled: true,
provider: "xai",
providers: {
xai: {
apiKey: "${XAI_API_KEY}",
endpointingMs: 800,
language: "en",
},
},
},
},
},
},
},
}
```
Config in eigendom van de provider staat onder
`plugins.entries.voice-call.config.streaming.providers.xai`. Ondersteunde
sleutels zijn `apiKey`, `baseUrl`, `sampleRate`, `encoding` (`pcm`, `mulaw` of
`alaw`), `interimResults`, `endpointingMs` en `language`.
Deze streamingprovider is voor het realtime transcriptiepad van Voice Call.
Discord-spraak neemt momenteel korte segmenten op en gebruikt in plaats daarvan
het batchtranscriptiepad `tools.media.audio`.
De gebundelde xAI-Plugin stelt `x_search` beschikbaar als een OpenClaw-tool voor het doorzoeken
van X-content (voorheen Twitter) via Grok.
Configuratiepad: `plugins.entries.xai.config.xSearch`
| Sleutel | Type | Standaard | Beschrijving |
| ------------------ | ------- | ------------------ | ------------------------------------ |
| `enabled` | boolean | - | Schakel x_search in of uit |
| `model` | string | `grok-4-1-fast` | Model dat wordt gebruikt voor x_search-aanvragen |
| `baseUrl` | string | - | Overschrijving van de xAI Responses-basis-URL |
| `inlineCitations` | boolean | - | Inline citaties opnemen in resultaten |
| `maxTurns` | number | - | Maximumaantal gespreksbeurten |
| `timeoutSeconds` | number | - | Aanvraagtime-out in seconden |
| `cacheTtlMinutes` | number | - | Cache-time-to-live in minuten |
```json5
{
plugins: {
entries: {
xai: {
config: {
xSearch: {
enabled: true,
model: "grok-4-1-fast",
baseUrl: "https://api.x.ai/v1",
inlineCitations: true,
},
},
},
},
},
}
```
De gebundelde xAI-Plugin stelt `code_execution` beschikbaar als een OpenClaw-tool voor
externe code-uitvoering in de sandboxomgeving van xAI.
Configuratiepad: `plugins.entries.xai.config.codeExecution`
| Sleutel | Type | Standaard | Beschrijving |
| ----------------- | ------- | ------------------ | ------------------------------------ |
| `enabled` | boolean | `true` (als sleutel beschikbaar is) | Schakel code-uitvoering in of uit |
| `model` | string | `grok-4-1-fast` | Model dat wordt gebruikt voor code-uitvoeringsaanvragen |
| `maxTurns` | number | - | Maximumaantal gespreksbeurten |
| `timeoutSeconds` | number | - | Aanvraagtime-out in seconden |
Dit is externe xAI-sandboxuitvoering, geen lokale [`exec`](/nl/tools/exec).
```json5
{
plugins: {
entries: {
xai: {
config: {
codeExecution: {
enabled: true,
model: "grok-4-1-fast",
},
},
},
},
},
}
```
- Auth is vandaag alleen API-sleutelgebaseerd. De API-sleutel kan worden opgeslagen in een xAI-authprofiel,
omgevingsvariabele of Plugin-configuratie; er is nog geen xAI OAuth- of
device-code-flow in OpenClaw.
- `grok-4.20-multi-agent-experimental-beta-0304` wordt niet ondersteund op het
normale xAI-providerpad, omdat het een ander upstream-API-oppervlak vereist
dan het standaard OpenClaw xAI-transport.
- xAI Realtime-spraak is nog niet geregistreerd als OpenClaw-provider. Het
vereist een ander bidirectioneel spraaksessiecontract dan batch-STT of
streamingtranscriptie.
- xAI-afbeeldings`quality`, afbeeldings`mask` en extra uitsluitend-native beeldverhoudingen worden
niet beschikbaar gesteld totdat de gedeelde `image_generate`-tool bijbehorende
provideroverschrijdende besturingselementen heeft.
- OpenClaw past automatisch xAI-specifieke compatibiliteitsfixes voor toolschema's en toolaanroepen
toe op het gedeelde runnerpad.
- Native xAI-aanvragen gebruiken standaard `tool_stream: true`. Stel
`agents.defaults.models["xai/"].params.tool_stream` in op `false` om
dit uit te schakelen.
- De gebundelde xAI-wrapper verwijdert niet-ondersteunde strikte toolschema-vlaggen en
reasoning-payloadsleutels voordat native xAI-aanvragen worden verzonden.
- `web_search`, `x_search` en `code_execution` worden beschikbaar gesteld als OpenClaw-
tools. OpenClaw schakelt de specifieke ingebouwde xAI-functionaliteit die het nodig heeft in binnen elke tool-
aanvraag, in plaats van alle native tools aan elke chatbeurt te koppelen.
- Grok `web_search` leest `plugins.entries.xai.config.webSearch.baseUrl`.
`x_search` leest `plugins.entries.xai.config.xSearch.baseUrl` en
valt daarna terug op de Grok web-search-basis-URL.
- `x_search` en `code_execution` zijn eigendom van de gebundelde xAI-Plugin in plaats van
hardcoded in de core modelruntime.
- `code_execution` is externe xAI-sandboxuitvoering, geen lokale
[`exec`](/nl/tools/exec).
## Live testen
De xAI-mediapaden worden gedekt door unittests en opt-in live suites. De live
commando's laden geheimen uit je login-shell, inclusief `~/.profile`, voordat
`XAI_API_KEY` wordt onderzocht.
```bash
pnpm test extensions/xai
OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_TEST_QUIET=1 pnpm test:live -- extensions/xai/xai.live.test.ts
OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_TEST_QUIET=1 OPENCLAW_LIVE_IMAGE_GENERATION_PROVIDERS=xai pnpm test:live -- test/image-generation.runtime.live.test.ts
```
Het providerspecifieke live bestand synthetiseert normale TTS, telefonievriendelijke PCM-
TTS, transcribeert audio via xAI batch-STT, streamt dezelfde PCM via xAI
realtime STT, genereert tekst-naar-afbeelding-uitvoer en bewerkt een referentieafbeelding. Het
gedeelde live afbeeldingsbestand verifieert dezelfde xAI-provider via OpenClaw's
runtimeselectie, fallback, normalisatie en media-attachmentpad.
## Gerelateerd
Providers, modelreferenties en failovergedrag kiezen.
Gedeelde videotoolparameters en providerselectie.
Het bredere provideroverzicht.
Veelvoorkomende problemen en oplossingen.