xAI

Le fournisseur de recherche web grok intégré préfère OAuth xAI, puis se rabat sur XAI_API_KEY ou une clé de recherche web du Plugin :

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

Le Plugin xai intégré enregistre la génération vidéo via l’outil partagé video_generate.

• Modèle vidéo par défaut : xai/grok-imagine-video
• Modes : texte-vers-vidéo, image-vers-vidéo, génération par image de référence, modification vidéo distante et extension vidéo distante
• Formats d’image : 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3
• Résolutions : 480P, 720P
• Durée : 1 à 15 secondes pour la génération/image-vers-vidéo, 1 à 10 secondes lors de l’utilisation de rôles reference_image, 2 à 10 secondes pour l’extension
• Génération par image de référence : définissez imageRoles sur reference_image pour chaque image fournie ; xAI accepte jusqu’à 7 images de ce type
• Délai d’expiration par défaut de l’opération : 600 secondes, sauf si video_generate.timeoutMs ou agents.defaults.videoGenerationModel.timeoutMs est défini

Pour utiliser xAI comme fournisseur vidéo par défaut :

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

Le Plugin xai intégré enregistre la génération d’images via l’outil partagé image_generate.

• Modèle d’image par défaut : xai/grok-imagine-image
• Modèle supplémentaire : xai/grok-imagine-image-quality
• Modes : texte-vers-image et modification par image de référence
• Entrées de référence : une image ou jusqu’à cinq images
• Formats d’image : 1:1, 16:9, 9:16, 4:3, 3:4, 2:3, 3:2
• Résolutions : 1K, 2K
• Nombre : jusqu’à 4 images
• Délai d’expiration par défaut de l’opération : 600 secondes, sauf si image_generate.timeoutMs ou agents.defaults.imageGenerationModel.timeoutMs est défini

OpenClaw demande à xAI des réponses d’image b64_json afin que les médias générés puissent être stockés et livrés via le chemin normal des pièces jointes de canal. Les images de référence locales sont converties en URL de données ; les références http(s) distantes sont transmises telles quelles.

Pour utiliser xAI comme fournisseur d’images par défaut :

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

Le Plugin xai inclus enregistre la synthèse vocale via la surface de fournisseur tts partagée.

• Voix : eve, ara, rex, sal, leo, una
• Voix par défaut : eve
• Formats : mp3, wav, pcm, mulaw, alaw
• Langue : code BCP-47 ou auto
• Vitesse : surcharge de vitesse native du fournisseur
• Le format natif Opus de note vocale n'est pas pris en charge

Pour utiliser xAI comme fournisseur TTS par défaut :

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

Le Plugin xai inclus enregistre la reconnaissance vocale par lots via la surface de transcription de compréhension des médias d'OpenClaw.

• Modèle par défaut : grok-stt
• Point de terminaison : REST xAI /v1/stt
• Chemin d'entrée : téléversement de fichier audio multipart
• Pris en charge par OpenClaw partout où la transcription audio entrante utilise tools.media.audio, notamment les segments de canaux vocaux Discord et les pièces jointes audio des canaux

Pour forcer xAI pour la transcription audio entrante :

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

La langue peut être fournie via la configuration de média audio partagée ou par requête de transcription. Les indications de prompt sont acceptées par la surface OpenClaw partagée, mais l'intégration STT REST de xAI ne transmet que le fichier, le modèle et la langue, car ces éléments correspondent clairement au point de terminaison public xAI actuel.

Le Plugin xai inclus enregistre aussi un fournisseur de transcription en temps réel pour l'audio des appels vocaux en direct.

• Point de terminaison : WebSocket xAI wss://api.x.ai/v1/stt
• Encodage par défaut : mulaw
• Fréquence d'échantillonnage par défaut : 8000
• Détection de fin par défaut : 800ms
• Transcriptions intermédiaires : activées par défaut

Le flux média Twilio de Voice Call envoie des trames audio G.711 µ-law, donc le fournisseur xAI peut transmettre ces trames directement sans transcodage :

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

La configuration détenue par le fournisseur se trouve sous plugins.entries.voice-call.config.streaming.providers.xai. Les clés prises en charge sont apiKey, baseUrl, sampleRate, encoding (pcm, mulaw ou alaw), interimResults, endpointingMs et language.

Le Plugin xAI inclus expose x_search comme outil OpenClaw pour rechercher du contenu X (anciennement Twitter) via Grok.

Chemin de configuration : 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,          },        },      },    },  },}

Le Plugin xAI inclus expose code_execution comme outil OpenClaw pour l'exécution de code à distance dans l'environnement sandbox de xAI.

Chemin de configuration : plugins.entries.xai.config.codeExecution

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

• L'authentification xAI peut utiliser une clé d'API, une variable d'environnement, un repli de configuration du Plugin ou OAuth avec un compte xAI éligible. OAuth utilise une vérification par code d'appareil sans rappel localhost. xAI décide quels comptes peuvent recevoir des jetons d'API OAuth, et la page de consentement peut afficher Grok Build même si OpenClaw n'exige pas l'application Grok Build.
• OpenClaw n'expose pas actuellement la famille de modèles multi-agents de xAI. xAI sert ces modèles via l'API Responses, mais ils n'acceptent pas les outils côté client ni les outils personnalisés utilisés par la boucle d'agent partagée d'OpenClaw. Consultez les limites multi-agents de xAI.
• La voix Realtime de xAI n'est pas encore enregistrée comme fournisseur OpenClaw. Elle nécessite un contrat de session vocale bidirectionnelle différent de la STT par lots ou de la transcription en streaming.
• Les options d'image xAI quality, mask et les ratios d'aspect supplémentaires uniquement natifs ne sont pas exposés tant que l'outil partagé image_generate ne dispose pas de contrôles correspondants entre fournisseurs.

• OpenClaw applique automatiquement les correctifs de compatibilité de schéma d'outils et d'appels d'outils propres à xAI sur le chemin du lanceur partagé.
• Les requêtes xAI natives utilisent par défaut tool_stream: true. Définissez agents.defaults.models["xai/<model>"].params.tool_stream sur false pour le désactiver.
• Le wrapper xAI inclus retire les indicateurs stricts de schéma d'outils non pris en charge et les clés de charge utile de raisonnement effort avant d'envoyer les requêtes xAI natives. Seuls grok-4.3 / grok-4.3-* annoncent un effort de raisonnement configurable ; tous les autres modèles xAI capables de raisonnement demandent toujours include: ["reasoning.encrypted_content"] afin que le raisonnement chiffré précédent puisse être rejoué lors des tours suivants.
• web_search, x_search et code_execution sont exposés comme outils OpenClaw. OpenClaw active l'intégration xAI intégrée précise dont il a besoin dans chaque requête d'outil au lieu d'attacher tous les outils natifs à chaque tour de chat.
• Le web_search de Grok lit plugins.entries.xai.config.webSearch.baseUrl. x_search lit plugins.entries.xai.config.xSearch.baseUrl, puis se replie sur l'URL de base de recherche Web Grok.
• x_search et code_execution appartiennent au Plugin xAI inclus plutôt que d'être codés en dur dans le runtime de modèle principal.
• code_execution est l'exécution sandbox xAI à distance, pas exec local.