xAI

Il provider di ricerca web grok incluso può usare XAI_API_KEY o una chiave di ricerca web del plugin:

openclaw config set tools.web.search.provider grok

Il plugin xai incluso registra la generazione video tramite lo strumento condiviso video_generate.

• Modello video predefinito: xai/grok-imagine-video
• Modalità: text-to-video, image-to-video, generazione con immagine di riferimento, modifica video remota ed estensione video remota
• Rapporti d'aspetto: 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
• Risoluzioni: 480P, 720P
• Durata: 1-15 secondi per generazione/image-to-video, 1-10 secondi quando si usano ruoli reference_image, 2-10 secondi per l'estensione
• Generazione con immagine di riferimento: imposta imageRoles su reference_image per ogni immagine fornita; xAI accetta fino a 7 immagini di questo tipo

Per usare xAI come provider video predefinito:

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

Il plugin xai incluso registra la generazione immagini tramite lo strumento condiviso image_generate.

• Modello immagine predefinito: xai/grok-imagine-image
• Modello aggiuntivo: xai/grok-imagine-image-pro
• Modalità: text-to-image e modifica con immagine di riferimento
• Input di riferimento: una image o fino a cinque images
• Rapporti d'aspetto: 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Risoluzioni: 1K, 2K
• Conteggio: fino a 4 immagini

OpenClaw richiede a xAI risposte immagine b64_json in modo che i media generati possano essere archiviati e consegnati tramite il normale percorso degli allegati del canale. Le immagini di riferimento locali vengono convertite in URL dati; i riferimenti remoti http(s) vengono passati così come sono.

Per usare xAI come provider immagine predefinito:

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

Il plugin xai incluso registra il text-to-speech tramite la superficie provider tts condivisa.

• Voci: eve, ara, rex, sal, leo, una
• Voce predefinita: eve
• Formati: mp3, wav, pcm, mulaw, alaw
• Lingua: codice BCP-47 o auto
• Velocità: override della velocità nativo del provider
• Il formato nativo Opus per note vocali non è supportato

Per usare xAI come provider TTS predefinito:

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

Il plugin xai incluso registra speech-to-text batch tramite la superficie di trascrizione per comprensione multimediale di OpenClaw.

• Modello predefinito: grok-stt
• Endpoint: xAI REST /v1/stt
• Percorso di input: caricamento file audio multipart
• Supportato da OpenClaw ovunque la trascrizione audio in ingresso usi tools.media.audio, inclusi i segmenti dei canali vocali Discord e gli allegati audio dei canali

Per forzare xAI per la trascrizione audio in ingresso:

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

La lingua può essere fornita tramite la configurazione multimediale audio condivisa o per singola richiesta di trascrizione. Gli hint del prompt sono accettati dalla superficie condivisa di OpenClaw, ma l'integrazione REST STT di xAI inoltra solo file, modello e lingua perché questi si mappano in modo pulito sull'attuale endpoint pubblico xAI.

Il plugin xai incluso registra anche un provider di trascrizione in tempo reale per l'audio delle chiamate vocali in diretta.

• Endpoint: xAI WebSocket wss://api.x.ai/v1/stt
• Codifica predefinita: mulaw
• Frequenza di campionamento predefinita: 8000
• Rilevamento fine turno predefinito: 800ms
• Trascrizioni provvisorie: abilitate per impostazione predefinita

Lo stream multimediale Twilio di Voice Call invia frame audio G.711 µ-law, quindi il provider xAI può inoltrare direttamente quei frame senza transcodifica:

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

La configurazione di proprietà del provider si trova in plugins.entries.voice-call.config.streaming.providers.xai. Le chiavi supportate sono apiKey, baseUrl, sampleRate, encoding (pcm, mulaw o alaw), interimResults, endpointingMs e language.

Il plugin xAI incluso espone x_search come strumento OpenClaw per cercare contenuti di X (precedentemente Twitter) tramite Grok.

Percorso di configurazione: 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,          },        },      },    },  },}

Il plugin xAI incluso espone code_execution come strumento OpenClaw per l'esecuzione di codice remota nell'ambiente sandbox di xAI.

Percorso di configurazione: plugins.entries.xai.config.codeExecution

{  plugins: {    entries: {      xai: {        config: {          codeExecution: {            enabled: true,            model: "grok-4-1-fast",          },        },      },    },  },}

• Oggi l'autenticazione avviene solo tramite chiave API. La chiave API può essere archiviata in un profilo di autenticazione xAI, in una variabile d'ambiente o nella configurazione del plugin; non esiste ancora un flusso OAuth xAI o con codice dispositivo in OpenClaw.
• grok-4.20-multi-agent-experimental-beta-0304 non è supportato nel normale percorso del provider xAI perché richiede una superficie API upstream diversa dal trasporto xAI standard di OpenClaw.
• La voce xAI Realtime non è ancora registrata come provider OpenClaw. Richiede un contratto di sessione vocale bidirezionale diverso rispetto a STT batch o trascrizione in streaming.
• quality dell'immagine xAI, mask dell'immagine e rapporti d'aspetto aggiuntivi solo nativi non sono esposti finché lo strumento condiviso image_generate non dispone di controlli cross-provider corrispondenti.

• OpenClaw applica automaticamente correzioni di compatibilità specifiche di xAI per schema degli strumenti e chiamate degli strumenti nel percorso del runner condiviso.
• Le richieste xAI native hanno tool_stream: true come predefinito. Imposta agents.defaults.models["xai/<model>"].params.tool_stream su false per disabilitarlo.
• Il wrapper xAI incluso rimuove flag di schema degli strumenti strict non supportati e chiavi del payload di reasoning prima di inviare richieste xAI native.
• web_search, x_search e code_execution sono esposti come strumenti OpenClaw. OpenClaw abilita lo specifico built-in xAI di cui ha bisogno all'interno di ogni richiesta di strumento invece di collegare tutti gli strumenti nativi a ogni turno di chat.
• Grok web_search legge plugins.entries.xai.config.webSearch.baseUrl. x_search legge plugins.entries.xai.config.xSearch.baseUrl, poi ripiega sull'URL di base della ricerca web Grok.
• x_search e code_execution sono di proprietà del plugin xAI incluso invece di essere hardcoded nel runtime del modello core.
• code_execution è esecuzione remota nella sandbox xAI, non exec locale.