xai intégré pour les modèles Grok. La
méthode recommandée est Grok OAuth avec un abonnement SuperGrok ou X Premium
éligible. Le Gateway, la configuration, le routage et les outils restent locaux ; seules les requêtes
Grok sont envoyées à l’API de xAI.
OAuth ne nécessite ni clé API xAI ni application Grok Build. xAI peut néanmoins
afficher Grok Build sur l’écran de consentement, car OpenClaw utilise le client
OAuth partagé de xAI.
Configuration
1
Nouvelle installation
Exécutez l’intégration avec l’installation du démon, puis choisissez xAI/Grok OAuth à l’étape
du modèle/de l’authentification :Sur un VPS ou via SSH, sélectionnez directement xAI OAuth ; cette méthode utilise la vérification
par code d’appareil et ne nécessite aucun rappel localhost :
2
Installation existante
Connectez-vous uniquement à xAI ; ne relancez pas toute l’intégration simplement pour connecter Grok :Définissez séparément Grok comme modèle par défaut :Ne relancez toute l’intégration que si vous souhaitez intentionnellement modifier le Gateway,
le démon, le canal, l’espace de travail ou d’autres choix de configuration.
3
Méthode par clé API
La configuration par clé API fonctionne toujours pour les clés de xAI Console et pour les surfaces multimédias
qui nécessitent une configuration de fournisseur reposant sur une clé :
4
Choisir un modèle
OpenClaw utilise l’API Responses de xAI comme transport xAI intégré. Le même
identifiant provenant de
openclaw models auth login --provider xai --method oauth ou
--method api-key alimente également web_search (identifiant du fournisseur grok), x_search,
code_execution, la parole/transcription ainsi que la génération d’images/vidéos par xAI. Si vous
stockez une clé xAI sous plugins.entries.xai.config.webSearch.apiKey, le
fournisseur de modèles xAI intégré la réutilise également comme solution de secours.Dépannage d’OAuth
-
Pour SSH, Docker, un VPS ou d’autres configurations distantes, utilisez
openclaw models auth login --provider xai --method oauth; cette méthode utilise la vérification par code d’appareil, et non un rappel localhost. -
Si la connexion réussit mais que Grok n’est pas le modèle par défaut, exécutez
openclaw models set xai/grok-4.3. -
Inspectez les profils d’authentification xAI enregistrés :
- xAI détermine quels comptes peuvent recevoir des jetons d’API OAuth. Si un compte n’est pas éligible, utilisez la méthode par clé API ou vérifiez l’abonnement du côté de xAI.
Catalogue intégré
Identifiants sélectionnables dans les sélecteurs de modèles. Le plugin résout toujours les anciens identifiants Grok 3, Grok 4, Grok 4 Fast, Grok 4.1 Fast et Grok Code pour les configurations existantes ; consultez compatibilité héritée et alias évolutifs.Couverture fonctionnelle
Le plugin intégré associe les API xAI prises en charge aux contrats partagés de fournisseur et d’outils d’OpenClaw. Les fonctionnalités qui ne correspondent pas au contrat partagé sont répertoriées ci-dessous ou dans les limitations connues.OpenClaw utilise les API REST d’image/vidéo/TTS/STT de xAI pour la génération multimédia et
la transcription par lots, le WebSocket STT en streaming de xAI pour la transcription en direct
des appels vocaux, le WebSocket Grok Voice Agent de xAI pour les sessions Talk en temps réel,
et l’API Responses pour le chat, la recherche et les outils d’exécution de code.
Compatibilité héritée du mode rapide
/fast on ou agents.defaults.models["xai/<model>"].params.fastMode: true
réécrit toujours les anciennes configurations xAI comme suit. Ces identifiants cibles sont
conservés uniquement à des fins de compatibilité ; utilisez les modèles actuellement sélectionnables pour les nouvelles
configurations.
Compatibilité héritée et alias évolutifs
Les anciens alias sont normalisés comme suit :
Les identifiants datés 0309 constituent les entrées sélectionnables du catalogue. OpenClaw envoie tous les autres
alias Grok 4.20 actuels tels quels afin que xAI conserve le contrôle de la sémantique des alias stables, latest,
bêta, expérimentaux et datés. L’alias global
grok-latest est
également conservé tel quel.
xAI a retiré les identifiants exacts suivants. OpenClaw les conserve sous forme de lignes de compatibilité masquées
pour les configurations publiées, avec les limites et la tarification de leurs cibles de
redirection actuelles :
openclaw doctor --fix met à jour les valeurs par défaut persistantes des outils serveur xAI et
l’identifiant d’image de qualité retiré, supprime les lignes obsolètes du catalogue généré et répare
les métadonnées de contexte obsolètes sur les lignes 4.20 actives. Il n’épingle pas les alias
beta-latest 4.20 actifs à un instantané daté.
Fonctionnalités
Recherche web
Recherche web
Le fournisseur de recherche web
grok intégré privilégie xAI OAuth, puis utilise en solution de secours
XAI_API_KEY ou une clé de recherche web de plugin :Génération de vidéos
Génération de vidéos
Le plugin
xai intégré enregistre la génération de vidéos via l’outil partagé
video_generate.- Modèle par défaut :
xai/grok-imagine-video - Modèle supplémentaire :
xai/grok-imagine-video-1.5 - Modes classiques : texte vers vidéo, image vers vidéo, génération à partir d’images de référence, modification de vidéo distante et extension de vidéo distante
- Mode Video 1.5 : image vers vidéo uniquement, avec exactement une image de première trame
- Formats d’image :
1:1,16:9,9:16,4:3,3:4,3:2,2:3; les modes classiques et Video 1.5 d’image vers vidéo héritent du format de l’image source lorsqu’il est omis - Résolutions : modes classiques
480P/720P; Video 1.5 prend également en charge1080P; tous les modes de génération utilisent480Ppar défaut - Durée : 1-15 secondes pour la génération/l’image vers vidéo, 1-10 secondes lors de
l’utilisation des rôles classiques
reference_image, 2-10 secondes pour l’extension classique - Génération à partir d’images de référence : définissez
imageRolessurreference_imagepour chaque image fournie ; xAI accepte jusqu’à 7 images de ce type - La modification/l’extension de vidéo hérite du format et de la résolution de la vidéo d’entrée ; ces opérations n’acceptent aucune substitution de géométrie
- Délai d’expiration par défaut de l’opération : 600 secondes, sauf si
video_generate.timeoutMsouagents.defaults.videoGenerationModel.timeoutMsest défini
grok-imagine-video-1.5-preview et
grok-imagine-video-1.5-2026-05-30 de xAI. OpenClaw transmet
l’identifiant sélectionné sans le modifier, mais applique la même validation limitée aux images.Pour utiliser xAI comme fournisseur vidéo par défaut :Consultez Génération de vidéos pour connaître les paramètres partagés de l’outil,
la sélection du fournisseur et le comportement de basculement.
Génération d’images
Génération d’images
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 : génération de texte vers image et modification d’une image de référence
- Entrées de référence : un
imageou jusqu’à troisimages - Formats d’image :
1:1,16:9,9:16,4:3,3:4,3:2,2:3,2:1,1:2,19.5:9,9:19.5,20:9,9:20 - 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.timeoutMsouagents.defaults.imageGenerationModel.timeoutMsest défini
b64_json afin que les médias générés puissent être
stockés et transmis par le chemin normal des pièces jointes du canal. Les images de
référence locales sont converties en URL de données ; les références http(s) distantes
sont transmises sans modification.Pour utiliser xAI comme fournisseur d’images par défaut :xAI documente également
quality, mask, user et un format d’image auto.
OpenClaw ne transmet actuellement que les contrôles d’image communs aux différents fournisseurs ;
ces paramètres propres au fournisseur ne sont pas exposés par image_generate.Synthèse vocale
Synthèse vocale
Le plugin
xai intégré enregistre la synthèse vocale par l’intermédiaire de la surface
de fournisseur tts partagée.- Voix : catalogue dynamique authentifié provenant de xAI ; affichez-le avec
openclaw infer tts voices --provider xai - Voix de secours hors ligne :
ara,eve,leo,rex,sal - Voix par défaut :
eve - Les identifiants de voix personnalisées du compte sont transmis même s’ils sont absents de la réponse du catalogue intégré
- Formats :
mp3,wav,pcm,mulaw,alaw - Langue : code BCP-47 ou
auto - Vitesse : remplacement de la vitesse propre au fournisseur
- Le format natif Opus des messages vocaux n’est pas pris en charge
OpenClaw utilise le point de terminaison par lots
/v1/tts de xAI pour la synthèse mise en mémoire tampon,
la découverte authentifiée du catalogue /v1/tts/voices et le protocole
wss://api.x.ai/v1/tts natif pour la synthèse en streaming. Le streaming est limité à
l’hôte api.x.ai natif ; les valeurs baseUrl personnalisées sont donc refusées sur ce
chemin. Il utilise les contrôles existants de langue, de voix, de codec et de vitesse ; les
valeurs par défaut de xAI s’appliquent à la fréquence d’échantillonnage et au débit binaire. La synthèse de fichiers audio respecte tous
les codecs configurés. Les cibles de messages vocaux utilisent le MP3 pour le streaming et le mode de secours
mis en mémoire tampon, car les codecs bruts de xAI ne contiennent pas de métadonnées de codec ou de fréquence. Le
flux envoie text.delta, puis
text.done, reçoit audio.delta, audio.done ou error, et applique un
timeoutMs d’inactivité actualisé à chaque bloc audio. Il est distinct des
sessions vocales en temps réel. Consultez le contrat de l’API TTS en streaming de xAI.Transcription vocale
Transcription vocale
Le plugin La langue peut être fournie par la configuration multimédia audio partagée ou par une demande de
transcription individuelle. Les indications d’invite sont acceptées par la surface OpenClaw
partagée, mais l’intégration STT REST de xAI transmet uniquement le fichier et la langue,
car seuls ces éléments correspondent au point de terminaison public actuel de xAI.
xai intégré enregistre la transcription vocale par lots par l’intermédiaire de la
surface de transcription de compréhension multimédia d’OpenClaw.- Point de terminaison : REST xAI
/v1/stt - Chemin d’entrée : téléversement multipart d’un fichier audio
- Sélection du modèle : xAI choisit le modèle de transcription en interne ; le point de terminaison ne comporte aucun sélecteur de modèle
- Utilisé partout où la transcription audio entrante lit
tools.media.audio, notamment pour les segments de canaux vocaux Discord et les pièces jointes audio des canaux
Transcription vocale en streaming
Transcription vocale en streaming
Le plugin La configuration détenue par le fournisseur se trouve sous
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
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.Ce fournisseur de streaming est destiné au chemin de transcription en temps réel de Voice Call.
Discord enregistre de courts segments et utilise à la place le chemin de transcription par lots
tools.media.audio.Voix en temps réel (Talk)
Voix en temps réel (Talk)
Le plugin La configuration détenue par le fournisseur est également résolue depuis
xai intégré enregistre les sessions en temps réel de Grok Voice Agent pour
le mode Talk par l’intermédiaire du contrat registerRealtimeVoiceProvider partagé.- Point de terminaison :
wss://api.x.ai/v1/realtime?model=<voice-model> - Modèle par défaut :
grok-voice-latest - Voix par défaut :
eve - Transport :
gateway-relay(chemins de relais iOS, Android et Control UI) - Audio : PCM16 24 kHz ou G.711 µ-law 8 kHz
- Interruption : le VAD du serveur xAI interrompt la réponse ; OpenClaw efface la lecture en attente et tronque l’historique du fournisseur qui n’a pas été lu
plugins.entries.voice-call.config.realtime.providers.xai lorsque Voice Call
ou les sélecteurs en temps réel partagés réutilisent la même correspondance de fournisseurs. Les clés prises en charge sont
apiKey, baseUrl, model, voice, vadThreshold, silenceDurationMs,
prefixPaddingMs, reasoningEffort et sessionResumption.
reasoningEffort accepte uniquement high ou none, conformément à l’API xAI Voice Agent.Le VAD du serveur xAI crée toujours les réponses et gère les interruptions audio.
Utilisez consultRouting: "provider-direct" ; le routage forcé des transcriptions et la désactivation
de l’interruption de l’audio entrant ne sont pas pris en charge par le protocole xAI Voice Agent.xAI OAuth ou
XAI_API_KEY peuvent authentifier la voix en temps réel. Le WebRTC géré par le
navigateur ne fait pas encore partie de cette surface de fournisseur ; utilisez le mode Talk par relais du Gateway sur
les nœuds natifs ou le chemin de relais de Control UI.sessionResumption utilise par défaut false. Lorsque cette option est définie sur true, OpenClaw demande
à xAI de conserver suffisamment d’état de session pour reprendre la même conversation après une
reconnexion, puis se reconnecte avec l’identifiant de conversation renvoyé. Laissez cette option
désactivée lorsque la relecture ou la conservation côté fournisseur n’est pas acceptable ; les sockets
interrompus échouent alors de manière fermée au lieu de démarrer silencieusement une nouvelle conversation.Configuration de x_search
Configuration de x_search
Le plugin xAI intégré expose
x_search comme outil OpenClaw pour
rechercher du contenu X (anciennement Twitter) par l’intermédiaire de Grok.Chemin de configuration : plugins.entries.xai.config.xSearchConfiguration de l’exécution de code
Configuration de l’exécution de code
Le plugin xAI intégré expose
code_execution comme outil OpenClaw pour
l’exécution de code à distance dans l’environnement bac à sable de xAI.Chemin de configuration : plugins.entries.xai.config.codeExecutionIl s’agit d’une exécution à distance dans le bac à sable de xAI, et non de l’
exec locale.Limites connues
Limites connues
- L’authentification xAI peut utiliser une clé API, une variable d’environnement, une configuration de Plugin de secours ou OAuth avec un compte xAI admissible. OAuth utilise une vérification par code d’appareil sans rappel localhost. xAI détermine quels comptes peuvent recevoir des jetons API OAuth, et la page de consentement peut afficher Grok Build même si OpenClaw ne nécessite pas l’application Grok Build.
- OpenClaw n’expose actuellement pas la famille de modèles multi-agents de xAI. xAI fournit ces modèles par l’intermédiaire de l’API Responses, mais ils n’acceptent pas les outils côté client ou personnalisés utilisés par la boucle d’agent partagée d’OpenClaw. Consultez les limitations multi-agents de xAI.
- La voix xAI Realtime n’expose actuellement que le transport Talk par relais du Gateway. Les sessions WebSocket du fournisseur gérées par le navigateur ne sont pas encore intégrées à l’interface de contrôle.
- L’image xAI
quality, l’imagemasket les rapports hauteur/largeur supplémentaires exclusivement natifs ne sont pas exposés tant que l’outil partagéimage_generatene dispose pas de contrôles inter-fournisseurs correspondants.
Remarques avancées
Remarques avancées
- OpenClaw applique automatiquement les correctifs de compatibilité xAI propres aux schémas d’outils et aux appels d’outils sur le chemin d’exécution partagé.
- Les requêtes xAI natives utilisent par défaut
tool_stream: true. Définissezagents.defaults.models["xai/<model>"].params.tool_streamsurfalsepour le désactiver. - Le wrapper xAI intégré supprime les limites de nombre d’occurrences non prises en charge dans les schémas ainsi que les clés de charge utile effort de raisonnement non prises en charge avant l’envoi de requêtes xAI natives. Grok 4.5 prend en charge un effort faible, moyen et élevé (élevé par défaut). Grok 4.3 prend en charge les valeurs aucun, faible, moyen et élevé (faible par défaut). Les autres modèles xAI capables de raisonnement n’exposent pas de contrôle configurable de l’effort, mais demandent tout de même
include: ["reasoning.encrypted_content"]afin que le raisonnement chiffré antérieur puisse être réutilisé lors des tours suivants. web_search,x_searchetcode_executionsont exposés comme outils OpenClaw. OpenClaw joint uniquement la fonctionnalité xAI intégrée spécifique requise par chaque outil à la requête de cet outil, au lieu de joindre tous les outils natifs à chaque tour de conversation.- Grok
web_searchlitplugins.entries.xai.config.webSearch.baseUrl.x_searchlitplugins.entries.xai.config.xSearch.baseUrl, puis utilise en secours l’URL de base de recherche Web de Grok. x_searchetcode_executionappartiennent au Plugin xAI intégré plutôt que d’être codés en dur dans le runtime principal des modèles.code_executioncorrespond à une exécution distante dans le bac à sable xAI, et non à une exécution localeexec.
Tests en conditions réelles
Les chemins multimédias xAI sont couverts par des tests unitaires et des suites en conditions réelles à activation explicite. ExportezXAI_API_KEY dans l’environnement du processus avant d’exécuter les sondes en conditions réelles.
Contenu associé
Sélection du modèle
Choix des fournisseurs, des références de modèles et du comportement de basculement.
Génération vidéo
Paramètres de l’outil vidéo partagé et sélection du fournisseur.
Tous les fournisseurs
Vue d’ensemble plus générale des fournisseurs.
Dépannage
Problèmes courants et solutions.