Passer au contenu principal

​
xAI

OpenClaw inclut un Plugin fournisseur xai intégré pour les modèles Grok.

​
Premiers pas

1

Créer une clé API

Créez une clé API dans la console xAI.
2

Définir votre clé API

Définissez XAI_API_KEY, ou exécutez :
openclaw onboard --auth-choice xai-api-key
3

Choisir un modèle

{
  agents: { defaults: { model: { primary: "xai/grok-4" } } },
}
OpenClaw utilise l’API xAI Responses comme transport xAI intégré. La même clé XAI_API_KEY peut également alimenter web_search basé sur Grok, x_search natif et code_execution distant. Si vous stockez une clé xAI sous plugins.entries.xai.config.webSearch.apiKey, le fournisseur de modèles xAI intégré réutilise également cette clé comme repli. L’ajustement de code_execution se trouve sous plugins.entries.xai.config.codeExecution.

​
Catalogue de modèles intégré

OpenClaw inclut ces familles de modèles xAI prêtes à l’emploi :
FamilyModel ids
Grok 3grok-3, grok-3-fast, grok-3-mini, grok-3-mini-fast
Grok 4grok-4, grok-4-0709
Grok 4 Fastgrok-4-fast, grok-4-fast-non-reasoning
Grok 4.1 Fastgrok-4-1-fast, grok-4-1-fast-non-reasoning
Grok 4.20 Betagrok-4.20-beta-latest-reasoning, grok-4.20-beta-latest-non-reasoning
Grok Codegrok-code-fast-1
Le Plugin résout aussi en transmission les nouveaux identifiants grok-4* et grok-code-fast* lorsqu’ils suivent la même forme d’API.
grok-4-fast, grok-4-1-fast et les variantes grok-4.20-beta-* sont les références Grok compatibles image actuelles dans le catalogue intégré.

​
Correspondances du mode rapide

/fast on ou agents.defaults.models["xai/<model>"].params.fastMode: true réécrit les requêtes xAI natives comme suit :
Source modelCible du mode rapide
grok-3grok-3-fast
grok-3-minigrok-3-mini-fast
grok-4grok-4-fast
grok-4-0709grok-4-fast

​
Alias de compatibilité hérités

Les alias hérités se normalisent toujours vers les identifiants canoniques intégrés :
Legacy aliasCanonical id
grok-4-fast-reasoninggrok-4-fast
grok-4-1-fast-reasoninggrok-4-1-fast
grok-4.20-reasoninggrok-4.20-beta-latest-reasoning
grok-4.20-non-reasoninggrok-4.20-beta-latest-non-reasoning

​
Fonctionnalités

Le fournisseur de recherche web grok intégré utilise aussi XAI_API_KEY :
openclaw 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 et flux distants d’édition/extension vidéo
  • Prend en charge aspectRatio et resolution
Les tampons vidéo locaux ne sont pas acceptés. Utilisez des URL distantes http(s) pour les entrées de référence vidéo et d’édition.
Pour utiliser xAI comme fournisseur vidéo par défaut :
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "xai/grok-imagine-video",
      },
    },
  },
}
Consultez Génération vidéo pour les paramètres d’outil partagés, la sélection du fournisseur et le comportement de basculement.
Le Plugin xAI intégré expose code_execution comme outil OpenClaw pour l’exécution de code distante dans l’environnement sandbox de xAI.Chemin de configuration : plugins.entries.xai.config.codeExecution
KeyTypeDefaultDescription
enabledbooleantrue (si une clé est disponible)Activer ou désactiver l’exécution de code
modelstringgrok-4-1-fastModèle utilisé pour les requêtes d’exécution de code
maxTurnsnumber—Nombre maximal de tours
timeoutSecondsnumber—Délai d’expiration de la requête en secondes
Il s’agit d’une exécution sandbox xAI distante, et non de exec en local.
{
  plugins: {
    entries: {
      xai: {
        config: {
          codeExecution: {
            enabled: true,
            model: "grok-4-1-fast",
          },
        },
      },
    },
  },
}
  • L’authentification est uniquement par clé API pour le moment. Il n’existe pas encore de flux OAuth ou device-code xAI 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.
  • OpenClaw applique automatiquement des correctifs de compatibilité spécifiques à xAI pour les schémas d’outils et les appels d’outils sur le chemin d’exécution 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.
  • L’enveloppe xAI intégrée supprime les drapeaux stricts de schéma d’outil non pris en charge et les clés de payload de raisonnement avant l’envoi des requêtes xAI natives.
  • web_search, x_search et code_execution sont exposés comme outils OpenClaw. OpenClaw active le built-in xAI spécifique dont il a besoin dans chaque requête d’outil au lieu d’attacher tous les outils natifs à chaque tour de chat.
  • x_search et code_execution appartiennent au Plugin xAI intégré plutôt que d’être codés en dur dans l’exécution du modèle cœur.
  • code_execution est une exécution sandbox xAI distante, et non exec en local.

​
Associé

Sélection du modèle

Choisir les fournisseurs, les références de modèle et le comportement de basculement.

Génération vidéo

Paramètres partagés de l’outil vidéo et sélection du fournisseur.

Tous les fournisseurs

Vue d’ensemble plus large des fournisseurs.

Dépannage

Problèmes courants et correctifs.