xAI

De gebundelde webzoekprovider grok geeft de voorkeur aan xAI OAuth en valt vervolgens terug op XAI_API_KEY of een webzoeksleutel van de 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 tool video_generate.

• Standaardmodel: xai/grok-imagine-video
• Aanvullend model: xai/grok-imagine-video-1.5
• Klassieke modi: tekst-naar-video, afbeelding-naar-video, genereren met referentieafbeeldingen, externe videobewerking en externe videoverlenging
• Video 1.5-modus: alleen afbeelding-naar-video, met precies één afbeelding als eerste frame
• Beeldverhoudingen: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3; klassieke en Video 1.5-afbeelding-naar-video nemen bij weglating de beeldverhouding van de bronafbeelding over
• 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
• Genereren met referentieafbeeldingen: stel imageRoles voor elke aangeleverde afbeelding in op reference_image; xAI accepteert maximaal 7 van zulke afbeeldingen
• Videobewerking/-verlenging neemt de beeldverhouding en resolutie van de invoervideo over; deze bewerkingen accepteren geen geometrie-overschrijvingen
• Standaardtime-out voor bewerkingen: 600 seconden, tenzij video_generate.timeoutMs of agents.defaults.videoGenerationModel.timeoutMs is ingesteld

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

xAI als standaardvideoprovider gebruiken:

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

De gebundelde xai-plugin registreert afbeeldingsgeneratie 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.imageGenerationModel.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 xai-plugin registreert tekst-naar-spraak via het gedeelde tts-provideroppervlak.

• Stemmen: geauthenticeerde livecatalogus van xAI; geef deze weer met openclaw infer tts voices --provider xai
• Offline terugvalstemmen: ara, eve, leo, rex, sal
• Standaardstem: eve
• Aangepaste stem-ID's van het account worden doorgegeven, zelfs wanneer ze ontbreken in het antwoord van de ingebouwde catalogus
• Indelingen: mp3, wav, pcm, mulaw, alaw
• Taal: BCP-47-code of auto
• Snelheid: systeemeigen snelheidsoverschrijving van de provider
• De systeemeigen Opus-indeling voor spraakberichten wordt niet ondersteund

xAI als standaard-TTS-provider gebruiken:

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

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

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

xAI afdwingen voor transcriptie van inkomende audio:

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

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

De meegeleverde xai-plugin registreert ook een provider voor realtime transcriptie van audio uit live spraakoproepen.

• Eindpunt: xAI WebSocket wss://api.x.ai/v1/stt
• Standaardcodering: mulaw
• Standaardbemonsteringsfrequentie: 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 xAI-plugin biedt x_search aan als OpenClaw-hulpmiddel 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-hulpmiddel 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",          },        },      },    },  },}

• xAI-authenticatie kan een API-sleutel, omgevingsvariabele, terugvalconfiguratie van de plugin of OAuth met een geschikt xAI-account gebruiken. OAuth gebruikt verificatie met een apparaatcode zonder localhost-callback. xAI bepaalt welke accounts OAuth-API-tokens kunnen ontvangen en de toestemmingspagina kan Grok Build tonen, hoewel OpenClaw de Grok Build-app niet vereist.
• OpenClaw biedt de xAI-modelfamilie met meerdere agents momenteel niet aan. xAI levert deze modellen via de Responses API, maar ze accepteren niet de client-side of aangepaste hulpmiddelen die door de gedeelde agentlus van OpenClaw worden gebruikt. Zie de beperkingen van xAI voor meerdere agents.
• xAI Realtime-spraak is nog niet als OpenClaw-provider geregistreerd. Hiervoor is een ander contract voor bidirectionele spraaksessies nodig dan voor batch-STT of streamingtranscriptie.
• quality voor xAI-afbeeldingen, afbeeldingsmaskers via mask en de systeemeigen beeldverhouding auto worden pas aangeboden wanneer het gedeelde hulpmiddel image_generate overeenkomstige provideroverschrijdende besturingselementen heeft.

• OpenClaw past xAI-specifieke compatibiliteitsoplossingen voor hulpmiddelschema's en hulpmiddelaanroepen automatisch toe op het gedeelde uitvoeringspad.
• Systeemeigen 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 in contains en niet-ondersteunde payloadsleutels voor redeneer-inspanning voordat systeemeigen xAI-aanvragen worden verzonden. Grok 4.5 ondersteunt 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 inspanning, maar vragen nog steeds include: ["reasoning.encrypted_content"] aan, zodat eerdere versleutelde redeneringen bij vervolgronden opnieuw kunnen worden afgespeeld.
• web_search, x_search en code_execution worden aangeboden als OpenClaw- hulpmiddelen. OpenClaw koppelt alleen de specifieke ingebouwde xAI-functie die elk hulpmiddel nodig heeft aan de aanvraag van dat hulpmiddel, in plaats van elk systeemeigen hulpmiddel 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 zoeken op het web van Grok.
• x_search en code_execution zijn eigendom van de meegeleverde xAI-plugin en zijn niet hardgecodeerd in de kernruntime voor modellen.
• code_execution is externe uitvoering in de xAI-sandbox, niet lokale exec.