xAI

De gebundelde grok-webzoekprovider gebruikt ook XAI_API_KEY:

openclaw config set tools.web.search.provider grok

De gebundelde 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 aangeleverde afbeelding; xAI accepteert maximaal 7 zulke afbeeldingen

Om xAI als standaard videoprovider te gebruiken:

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

De gebundelde xai Plugin registreert afbeeldingsgeneratie via de gedeelde image_generate-tool.

• Standaard afbeeldingsmodel: xai/grok-imagine-image
• Extra model: xai/grok-imagine-image-pro
• Modi: tekst-naar-afbeelding en bewerking 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 geconverteerd 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",
      },
    },
  },
}

De gebundelde 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",
        },
      },
    },
  },
}

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

• Standaardmodel: grok-stt
• Endpoint: xAI REST /v1/stt
• Invoerpad: multipart-upload van audiobestand
• Ondersteund door OpenClaw overal waar transcriptie van binnenkomende audio tools.media.audio gebruikt, inclusief Discord-spraakkanaalsegmenten en kanaalaudiobijlagen

Om xAI af te dwingen voor transcriptie van binnenkomende audio:

{
  tools: {
    media: {
      audio: {
        models: [
          {
            type: "provider",
            provider: "xai",
            model: "grok-stt",
          },
        ],
      },
    },
  },
}

Taal kan worden opgegeven via de gedeelde audiomediaconfiguratie of per 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 overeenkomen met het huidige openbare xAI-endpoint.

De gebundelde xai Plugin registreert ook een realtime transcriptieprovider voor live spraakoproepaudio.

• Endpoint: xAI WebSocket wss://api.x.ai/v1/stt
• Standaardcodering: mulaw
• Standaardsamplefrequentie: 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 direct kan doorsturen 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 stelt x_search beschikbaar als OpenClaw-tool om X-content (voorheen Twitter) te doorzoeken via Grok.

Configuratiepad: plugins.entries.xai.config.xSearch

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

De meegeleverde xAI-Plugin stelt code_execution beschikbaar 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-1-fast",
          },
        },
      },
    },
  },
}

• Auth gebruikt vandaag alleen API-sleutels. Er is nog geen xAI OAuth- of apparaatcodeflow 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 heeft een ander bidirectioneel spraaksessiecontract nodig dan batch-STT of streamingtranscriptie.
• xAI-afbeeldingsquality, afbeeldingsmask en extra native-only beeldverhoudingen worden niet beschikbaar gesteld totdat de gedeelde tool image_generate bijbehorende cross-provider controls heeft.

• OpenClaw past automatisch xAI-specifieke compatibiliteitsoplossingen voor toolschema's en tool-calls toe op het gedeelde runnerpad.
• Native xAI-verzoeken 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 strikte toolschema-vlaggen en reasoning-payloadsleutels voordat native xAI-verzoeken worden verzonden.
• web_search, x_search en code_execution worden beschikbaar gesteld als OpenClaw- tools. OpenClaw schakelt de specifieke ingebouwde xAI-functie in die nodig is binnen elk tool- verzoek, 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-webzoekbasis-URL.
• x_search en code_execution zijn eigendom van de meegeleverde xAI-Plugin en zijn niet hardcoded in de kernmodelruntime.
• code_execution is externe xAI-sandboxuitvoering, niet lokale exec.