xAI

De gebundelde grok-provider voor zoeken op het web geeft de voorkeur aan xAI OAuth en valt daarna terug op XAI_API_KEY of een webzoeksleutel van een plugin:

openclaw models auth login --provider xai --method oauthopenclaw config set tools.web.search.provider grok

De gebundelde xai-plugin registreert videogeneratie via de gedeelde video_generate-tool.

• Standaardmodel: xai/grok-imagine-video
• Aanvullend model: xai/grok-imagine-video-1.5
• Klassieke modi: tekst-naar-video, afbeelding-naar-video, generatie met referentieafbeeldingen, externe videobewerking en externe videoverlenging
• Video 1.5-modus: alleen afbeelding-naar-video, met precies één afbeelding voor het eerste frame
• Beeldverhoudingen: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3; klassieke afbeelding-naar-video en afbeelding-naar-video met Video 1.5 nemen de verhouding van de bronafbeelding over wanneer deze is weggelaten
• Resoluties: klassiek 480P/720P; Video 1.5 ondersteunt ook 1080P; alle generatiemodi gebruiken standaard 480P
• Duur: 1-15 seconden voor generatie/afbeelding-naar-video, 1-10 seconden bij gebruik van klassieke reference_image-rollen, 2-10 seconden voor klassieke verlenging
• Generatie met referentieafbeeldingen: stel imageRoles in op reference_image voor elke aangeleverde afbeelding; xAI accepteert maximaal 7 van zulke afbeeldingen
• Videobewerking/-verlenging neemt de beeldverhouding en resolutie van de invoervideo over; deze bewerkingen accepteren geen overschrijvingen van de geometrie
• Standaardtime-out voor bewerkingen: 600 seconden, tenzij video_generate.timeoutMs of agents.defaults.mediaModels.video.timeoutMs is ingesteld

Video 1.5 herkent ook de identifiers grok-imagine-video-1.5-preview en grok-imagine-video-1.5-2026-05-30 van xAI. OpenClaw stuurt de geselecteerde identifier ongewijzigd door, maar past dezelfde validatie voor uitsluitend afbeeldingen toe.

xAI instellen als standaardvideoprovider:

{  agents: {    defaults: {      videoGenerationModel: {        primary: "xai/grok-imagine-video",      },    },  },}

De meegeleverde Plugin xai registreert het genereren van afbeeldingen via de gedeelde tool image_generate.

• Standaard afbeeldingsmodel: xai/grok-imagine-image
• Aanvullend model: xai/grok-imagine-image-quality
• Modi: tekst-naar-afbeelding en bewerking van een referentieafbeelding
• Referentie-invoer: één image of maximaal drie images
• Beeldverhoudingen: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 2:1, 1:2, 19.5:9, 9:19.5, 20:9, 9:20
• Resoluties: 1K, 2K
• Aantal: maximaal 4 afbeeldingen
• Standaardtime-out voor bewerkingen: 600 seconden, tenzij image_generate.timeoutMs of agents.defaults.mediaModels.image.timeoutMs is ingesteld

OpenClaw vraagt xAI om afbeeldingsreacties als b64_json, zodat gegenereerde media via het normale pad voor kanaalbijlagen kunnen worden opgeslagen en afgeleverd. Lokale referentieafbeeldingen worden omgezet in data-URL's; externe http(s)-referenties worden ongewijzigd doorgegeven.

xAI als standaardprovider voor afbeeldingen gebruiken:

{  agents: {    defaults: {      imageGenerationModel: {        primary: "xai/grok-imagine-image",      },    },  },}

De meegeleverde Plugin xai registreert tekst-naar-spraak via het gedeelde provideroppervlak tts.

• Stemmen: geverifieerde livecatalogus van xAI; geef deze weer met openclaw infer tts voices --provider xai
• Offline fallbackstemmen: ara, eve, leo, rex, sal
• Standaardstem: eve
• Aangepaste stem-ID's van accounts worden doorgegeven, ook als ze ontbreken in het antwoord van de ingebouwde catalogus
• Indelingen: mp3, wav, pcm, mulaw, alaw
• Taal: BCP-47-code of auto
• Snelheid: providerspecifieke overschrijving van de snelheid
• De native Opus-indeling voor spraakberichten wordt niet ondersteund

xAI als standaard-TTS-provider gebruiken:

{  tts: {    provider: "xai",    providers: {      xai: {        voiceId: "eve",      },    },  },}

De meegeleverde Plugin xai registreert batchgewijze spraak-naar-tekst via het transcriptieoppervlak voor mediabegrip van OpenClaw.

• Endpoint: xAI REST /v1/stt
• Invoerpad: multipart-upload van audiobestanden
• Modelselectie: xAI kiest het transcriptiemodel intern; het endpoint heeft geen modelkiezer
• Wordt overal gebruikt waar transcriptie van inkomende audio tools.media.audio leest, waaronder segmenten van Discord-spraakkanalen en audiobijlagen van kanalen

xAI afdwingen voor transcriptie van inkomende audio:

{  tools: {    media: {      audio: {        models: [          {            type: "provider",            provider: "xai",          },        ],      },    },  },}

De taal kan via de gedeelde configuratie voor audiomedia of per transcriptieverzoek worden opgegeven. Promptaanwijzingen worden door het gedeelde OpenClaw- oppervlak geaccepteerd, maar de xAI REST STT-integratie geeft alleen het bestand en de taal door, omdat alleen die overeenkomen met het huidige openbare xAI-endpoint.

De meegeleverde Plugin xai registreert ook een realtime transcriptieprovider voor audio van live-spraakoproepen.

• Endpoint: xAI WebSocket wss://api.x.ai/v1/stt
• Standaardcodering: mulaw
• Standaardsamplefrequentie: 8000
• Standaardeindpuntdetectie: 800ms
• Tussentijdse transcripties: standaard ingeschakeld

De Twilio-mediastream van Voice Call verzendt G.711 mu-law-audioframes, zodat de xAI-provider deze frames rechtstreeks doorgeeft zonder transcodering:

{  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "xai",            providers: {              xai: {                apiKey: "${XAI_API_KEY}",                endpointingMs: 800,                language: "en",              },            },          },        },      },    },  },}

Configuratie die eigendom is 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.

De meegeleverde Plugin xai registreert realtime Grok Voice Agent-sessies voor de Talk-modus via het gedeelde contract registerRealtimeVoiceProvider.

• Endpoint: wss://api.x.ai/v1/realtime?model=<voice-model>
• Standaardmodel: grok-voice-latest
• Standaardstem: eve
• Transport: gateway-relay (relaypaden voor iOS, Android en Control UI)
• Audio: PCM16 24 kHz of G.711 µ-law 8 kHz
• Onderbreken: xAI-server-VAD onderbreekt het antwoord; OpenClaw wist de afspeelwachtrij en kapt niet-afgespeelde providergeschiedenis af

Talk configureren op de Gateway:

{  talk: {    realtime: {      provider: "xai",      mode: "realtime",      transport: "gateway-relay",      brain: "agent-consult",      providers: {        xai: {          model: "grok-voice-latest",          voice: "eve",          // Schakel dit alleen in als het opnieuw afspelen van sessies aan de providerzijde aanvaardbaar is.          sessionResumption: false,        },      },    },  },  env: { XAI_API_KEY: "xai-..." },}

Configuratie die eigendom is van de provider wordt ook opgehaald uit plugins.entries.voice-call.config.realtime.providers.xai wanneer Voice Call of gedeelde realtime kiezers dezelfde providertoewijzing hergebruiken. Ondersteunde sleutels zijn apiKey, baseUrl, model, voice, vadThreshold, silenceDurationMs, prefixPaddingMs, reasoningEffort en sessionResumption. reasoningEffort accepteert alleen high of none, overeenkomstig de xAI Voice Agent-API.

De server-VAD van xAI maakt altijd antwoorden aan en handelt audio-onderbrekingen af. Gebruik consultRouting: "provider-direct"; geforceerde transcriptroutering en het uitschakelen van onderbreking van invoeraudio worden niet ondersteund door het xAI Voice Agent-protocol.

De meegeleverde xAI-Plugin biedt x_search aan als OpenClaw-tool voor het doorzoeken van inhoud op X (voorheen Twitter) via Grok.

Configuratiepad: plugins.entries.xai.config.xSearch

{  plugins: {    entries: {      xai: {        config: {          xSearch: {            enabled: true,            model: "grok-4.3",            baseUrl: "https://api.x.ai/v1",            inlineCitations: true,          },        },      },    },  },}

De meegeleverde xAI-Plugin biedt code_execution aan als OpenClaw-tool voor externe code-uitvoering in de sandboxomgeving van xAI.

Configuratiepad: plugins.entries.xai.config.codeExecution

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4.3",          },        },      },    },  },}

• Voor xAI-authenticatie kan een API-sleutel, omgevingsvariabele, terugvalwaarde uit de pluginconfiguratie of OAuth met een geschikt xAI-account worden gebruikt. OAuth gebruikt verificatie via een apparaatcode zonder localhost-callback. xAI bepaalt welke accounts OAuth-API-tokens kunnen ontvangen en op de toestemmingspagina kan Grok Build worden weergegeven, hoewel OpenClaw de Grok Build-app niet vereist.
• OpenClaw stelt de xAI-modelfamilie voor meerdere agents momenteel niet beschikbaar. xAI biedt deze modellen aan via de Responses API, maar ze accepteren niet de client-side of aangepaste tools die door de gedeelde agentlus van OpenClaw worden gebruikt. Zie de beperkingen van xAI voor meerdere agents.
• xAI Realtime-spraak biedt momenteel alleen het Talk-transport via een Gateway-relay. WebSocket-sessies van providers die door de browser worden beheerd, zijn nog niet gekoppeld in de Control UI.
• xAI-afbeelding quality, afbeelding mask en aanvullende uitsluitend native beschikbare beeldverhoudingen worden pas beschikbaar gesteld wanneer de gedeelde tool image_generate overeenkomstige provideroverschrijdende bedieningselementen heeft.

• OpenClaw past automatisch xAI-specifieke compatibiliteitscorrecties voor toolschema's en toolaanroepen toe op het gedeelde runnerpad.
• Native xAI-aanvragen gebruiken standaard tool_stream: true. Stel agents.defaults.models["xai/<model>"].params.tool_stream in op false om dit uit te schakelen.
• De meegeleverde xAI-wrapper verwijdert niet-ondersteunde schemagrenzen voor aantallen van contains en niet-ondersteunde payloadsleutels voor effort bij redeneren voordat native xAI-aanvragen worden verzonden. Grok 4.5 ondersteunt een lage, gemiddelde en hoge inspanning (standaard hoog). Grok 4.3 ondersteunt geen, lage, gemiddelde en hoge inspanning (standaard laag). Andere xAI-modellen die kunnen redeneren, bieden geen configureerbare regeling voor de inspanning, maar vragen nog steeds include: ["reasoning.encrypted_content"] aan, zodat eerder versleutelde redeneringen bij vervolgbeurten opnieuw kunnen worden afgespeeld.
• web_search, x_search en code_execution worden beschikbaar gesteld als OpenClaw-tools. OpenClaw koppelt alleen de specifieke ingebouwde xAI-functie die elke tool nodig heeft aan de aanvraag van die tool, in plaats van elke native tool 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 vervolgens terug op de basis-URL voor Grok-webzoekopdrachten.
• x_search en code_execution worden beheerd door de meegeleverde xAI-plugin en zijn niet hardgecodeerd in de kernruntime voor modellen.
• code_execution is uitvoering in een externe xAI-sandbox, niet lokale exec.