Naar hoofdinhoud gaan

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.

OpenClaw levert een meegeleverde xai provider-Plugin voor Grok-modellen.

​
Aan de slag

1

Maak een API-sleutel

Maak een API-sleutel aan in de xAI-console.
2

Stel je API-sleutel in

Stel XAI_API_KEY in, of voer uit:
openclaw onboard --auth-choice xai-api-key
3

Kies een model

{
  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:
FamilieModel-id’s
Grok 3grok-3, grok-3-fast, grok-3-mini, grok-3-mini-fast
Grok 4.3grok-4.3
Grok 4grok-4, grok-4-0709
Grok 4 Fastgrok-4-fast, grok-4-fast-non-reasoning
Grok 4.1 Fastgrok-4-1-fast, grok-4-1-fast-non-reasoning
Grok 4.20 Betagrok-4.20-beta-latest-reasoning, grok-4.20-beta-latest-non-reasoning
Grok Codegrok-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-mogelijkheidOpenClaw-oppervlakStatus
Chat / Responsesxai/<model> modelproviderJa
Webzoekopdracht aan serverzijdeweb_search provider grokJa
X-zoekopdracht aan serverzijdex_search toolJa
Code-uitvoering aan serverzijdecode_execution toolJa
Afbeeldingenimage_generateJa
Video’svideo_generateJa
Batch tekst-naar-spraakmessages.tts.provider: "xai" / ttsJa
Streaming-TTS-Niet beschikbaar gemaakt; OpenClaw’s TTS-contract retourneert volledige audiobuffers
Batch spraak-naar-teksttools.media.audio / mediabegripJa
Streaming spraak-naar-tekstVoice Call streaming.provider: "xai"Ja
Realtime spraak-Nog niet beschikbaar gemaakt; ander sessie-/WebSocket-contract
Bestanden / batchesAlleen generieke model-API-compatibiliteitGeen 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/<model>"].params.fastMode: true herschrijft native xAI-verzoeken als volgt:
BronmodelFast-modus-doel
grok-3grok-3-fast
grok-3-minigrok-3-mini-fast
grok-4grok-4-fast
grok-4-0709grok-4-fast

​
Legacy-compatibiliteitsaliassen

Legacy-aliassen normaliseren nog steeds naar de canonieke meegeleverde id’s:
Legacy-aliasCanonieke id
grok-4-fast-reasoninggrok-4-fast
grok-4-1-fast-reasoninggrok-4-1-fast
grok-4.20-reasoninggrok-4.20-beta-latest-reasoning
grok-4.20-non-reasoninggrok-4.20-beta-latest-non-reasoning

​
Functies

De meegeleverde grok webzoekprovider kan XAI_API_KEY of een Plugin- webzoeksleutel gebruiken:
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:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "xai/grok-imagine-video",
      },
    },
  },
}
Zie Videogeneratie 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:
{
  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:
{
  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:
{
  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:
{
  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
SleutelTypeStandaardBeschrijving
enabledboolean-Schakel x_search in of uit
modelstringgrok-4-1-fastModel dat wordt gebruikt voor x_search-aanvragen
baseUrlstring-Overschrijving van de xAI Responses-basis-URL
inlineCitationsboolean-Inline citaties opnemen in resultaten
maxTurnsnumber-Maximumaantal gespreksbeurten
timeoutSecondsnumber-Aanvraagtime-out in seconden
cacheTtlMinutesnumber-Cache-time-to-live in minuten
{
  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
SleutelTypeStandaardBeschrijving
enabledbooleantrue (als sleutel beschikbaar is)Schakel code-uitvoering in of uit
modelstringgrok-4-1-fastModel dat wordt gebruikt voor code-uitvoeringsaanvragen
maxTurnsnumber-Maximumaantal gespreksbeurten
timeoutSecondsnumber-Aanvraagtime-out in seconden
Dit is externe xAI-sandboxuitvoering, geen lokale exec.
{
  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-afbeeldingsquality, afbeeldingsmask 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/<model>"].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.

​
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. 
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

Modelselectie

Providers, modelreferenties en failovergedrag kiezen.

Videogeneratie

Gedeelde videotoolparameters en providerselectie.

Alle providers

Het bredere provideroverzicht.

Probleemoplossing

Veelvoorkomende problemen en oplossingen.