xAI

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 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 avec 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 avec 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 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 intégré enregistre la synthèse vocale via la surface partagée de fournisseur 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 du 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 mé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 mé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 REST STT xAI ne transmet que le fichier, le modèle et la langue, car ils correspondent clairement au point de terminaison public xAI actuel.

Le Plugin xai intégré 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
• Taux 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 média Twilio de Voice Call envoie des trames audio G.711 µ-law, le fournisseur xAI peut donc 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 groupé 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 groupé 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 utilise uniquement une clé API aujourd’hui. 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 standard d’OpenClaw.
• 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.
• La quality d’image xAI, le mask d’image et les proportions supplémentaires propres au natif ne sont pas exposés tant que l’outil partagé image_generate ne dispose pas des contrôles inter-fournisseurs correspondants.

• OpenClaw applique automatiquement les correctifs de compatibilité xAI propres aux schémas d’outils et aux 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 groupé supprime les indicateurs stricts de schéma d’outil 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’intégration xAI spécifique dont il a besoin dans chaque requête d’outil au lieu d’attacher tous les outils natifs à chaque tour de discussion.
• 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 la recherche web Grok.
• x_search et code_execution appartiennent au plugin xAI groupé plutôt que d’être codés en dur dans le runtime du modèle principal.
• code_execution est une exécution sandbox xAI à distance, et non exec local.