xAI

Le fournisseur de recherche web grok intégré peut utiliser XAI_API_KEY ou une clé de recherche web du plugin :

openclaw config set tools.web.search.provider grok

Le plugin xai intégré enregistre la génération de vidéos 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 d’image de référence, modification de vidéo distante et extension de 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

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-pro
• Modes : texte vers image et modification avec 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

OpenClaw demande à xAI des réponses d’image b64_json afin que les médias générés puissent être stockés et distribué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 intégré enregistre la synthèse vocale via la surface de fournisseur partagée tts.

• 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 : remplacement de vitesse natif au fournisseur
• Le format natif de note vocale Opus n’est pas pris en charge

Pour utiliser xAI comme fournisseur TTS par défaut :

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

Le plugin xai intégré enregistre la reconnaissance vocale par lot via la surface de transcription de compréhension multimédia 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, y compris les segments de canal vocal Discord et les pièces jointes audio de canal

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 multimédia audio partagée ou par requête de transcription individuelle. Les indications de prompt sont acceptées par la surface OpenClaw partagée, mais l’intégration STT REST xAI ne transmet que le fichier, le modèle et la langue, car ceux-ci correspondent proprement au point de terminaison xAI public actuel.

Le plugin xai intégré enregistre également 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 de parole par défaut : 800ms
• Transcriptions intermédiaires : activées par défaut

Le flux multimé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 intégré 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 intégré 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 se fait uniquement par clé d’API aujourd’hui. La clé d’API peut être stockée dans un profil d’authentification xAI, une variable d’environnement ou la configuration du Plugin ; il n’existe pas encore de flux OAuth xAI ni de flux par code d’appareil dans OpenClaw.
• grok-4.20-multi-agent-experimental-beta-0304 n’est pas pris en charge sur le chemin normal du fournisseur xAI, car il nécessite une surface d’API amont différente du transport xAI OpenClaw standard.
• La voix xAI Realtime n’est pas encore enregistrée comme fournisseur OpenClaw. Elle nécessite un contrat de session vocale bidirectionnelle différent de la STT par lot ou de la transcription en streaming.
• Les paramètres d’image xAI quality, mask d’image et les formats d’image supplémentaires uniquement natifs ne sont pas exposés tant que l’outil partagé image_generate ne dispose pas des contrôles multifournisseurs correspondants.

• OpenClaw applique automatiquement les correctifs de compatibilité propres à xAI pour les schémas d’outils et les appels d’outils sur le chemin du runner partagé.
• Les requêtes xAI natives utilisent tool_stream: true par défaut. Définissez agents.defaults.models["xai/<model>"].params.tool_stream sur false pour le désactiver.
• Le wrapper xAI intégré supprime les indicateurs de schéma d’outils stricts non pris en charge et les clés de charge utile de raisonnement avant d’envoyer les requêtes xAI natives.
• web_search, x_search et code_execution sont exposés comme outils OpenClaw. OpenClaw active l’outil intégré xAI précis dont il a besoin dans chaque requête d’outil au lieu d’attacher tous les outils natifs à chaque tour de chat.
• Grok web_search lit plugins.entries.xai.config.webSearch.baseUrl. x_search lit plugins.entries.xai.config.xSearch.baseUrl, puis revient à l’URL de base de la recherche web Grok.
• x_search et code_execution appartiennent au Plugin xAI intégré plutôt que d’être codés en dur dans le runtime du modèle principal.
• code_execution correspond à l’exécution à distance dans la sandbox xAI, et non à exec local.