Mistral

OpenClaw inclut un Plugin Mistral intégré qui enregistre quatre contrats : complétions de chat, compréhension des médias (transcription par lots Voxtral), STT en temps réel pour Appel vocal (Voxtral Realtime) et embeddings mémoire (mistral-embed).

Propriété	Valeur
ID fournisseur	`mistral`
Plugin	intégré, `enabledByDefault: true`
Var. d’env auth	`MISTRAL_API_KEY`
Option onboarding	`--auth-choice mistral-api-key`
Option CLI directe	`--mistral-api-key <key>`
API	compatible OpenAI (`openai-completions`)
URL de base	`https://api.mistral.ai/v1`
Modèle par défaut	`mistral/mistral-large-latest`
Modèle d’embedding	`mistral-embed`
Lot Voxtral	`voxtral-mini-latest` (transcription audio)
Temps réel Voxtral	`voxtral-mini-transcribe-realtime-2602`

Bien démarrer

Obtenez votre clé API

Créez une clé API dans la console Mistral.

Exécutez l’onboarding

openclaw onboard --auth-choice mistral-api-key

Ou passez directement la clé :

openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"

Définissez un modèle par défaut

{
  env: { MISTRAL_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
}

Vérifiez que le modèle est disponible

openclaw models list --provider mistral

Catalogue LLM intégré

Mistral Medium 3.5 est le modèle Medium mixte actuel dans le catalogue intégré : poids denses 128B, entrée texte et image, contexte 256K, appel de fonctions, sortie structurée, codage et raisonnement ajustable via l’API Chat Completions. Utilisez mistral/mistral-medium-3-5 lorsque vous voulez le nouveau modèle unifié agentique/codage de Mistral au lieu du modèle par défaut mistral/mistral-large-latest. OpenClaw fournit actuellement ce catalogue Mistral intégré :

Réf. du modèle	Entrée	Contexte	Sortie max	Notes
`mistral/mistral-large-latest`	texte, image	262,144	16,384	Modèle par défaut
`mistral/mistral-medium-2508`	texte, image	262,144	8,192	Mistral Medium 3.1
`mistral/mistral-medium-3-5`	texte, image	262,144	8,192	Mistral Medium 3.5 ; raisonnement ajustable
`mistral/mistral-small-latest`	texte, image	128,000	16,384	Mistral Small 4 ; raisonnement ajustable via l’API `reasoning_effort`
`mistral/pixtral-large-latest`	texte, image	128,000	32,768	Pixtral
`mistral/codestral-latest`	texte	256,000	4,096	Codage
`mistral/devstral-medium-latest`	texte	262,144	32,768	Devstral 2
`mistral/magistral-small`	texte	128,000	40,000	Raisonnement activé

Après l’onboarding, exécutez un smoke test de Medium 3.5 sans démarrer le Gateway :

openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Reply with exactly: mistral-ok" \
  --json

Pour parcourir la ligne du catalogue intégré avant de modifier la configuration :

openclaw models list --all --provider mistral --plain

Transcription audio (Voxtral)

Utilisez Voxtral pour la transcription audio par lots via le pipeline de compréhension des médias.

{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
      },
    },
  },
}

Le chemin de transcription des médias utilise /v1/audio/transcriptions. Le modèle audio par défaut pour Mistral est voxtral-mini-latest.

STT en streaming pour Appel vocal

Le Plugin mistral intégré enregistre Voxtral Realtime comme fournisseur STT en streaming pour Appel vocal.

Paramètre	Chemin de config	Par défaut
Clé API	`plugins.entries.voice-call.config.streaming.providers.mistral.apiKey`	Se rabat sur `MISTRAL_API_KEY`
Modèle	`...mistral.model`	`voxtral-mini-transcribe-realtime-2602`
Encodage	`...mistral.encoding`	`pcm_mulaw`
Fréquence d’échantillonnage	`...mistral.sampleRate`	`8000`
Délai cible	`...mistral.targetStreamingDelayMs`	`800`

{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}

OpenClaw règle par défaut le STT temps réel Mistral sur pcm_mulaw à 8 kHz afin qu’Appel vocal puisse transférer directement les trames multimédias Twilio. Utilisez encoding: "pcm_s16le" et une sampleRate correspondante uniquement si votre flux amont est déjà du PCM brut.

Configuration avancée

Raisonnement ajustable

mistral/mistral-small-latest (Mistral Small 4) et mistral/mistral-medium-3-5 prennent en charge le raisonnement ajustable sur l’API Chat Completions via reasoning_effort (none minimise la réflexion supplémentaire dans la sortie ; high expose les traces complètes de réflexion avant la réponse finale). Mistral recommande reasoning_effort="high" pour les cas d’usage agentiques et de code avec Medium 3.5.OpenClaw mappe le niveau thinking de la session vers l’API de Mistral :

Niveau thinking OpenClaw	`reasoning_effort` Mistral
off / minimal	`none`
low / medium / high / xhigh / adaptive / max	`high`

Ne combinez pas le mode de raisonnement Medium 3.5 avec temperature: 0. L’API HTTP de Mistral rejette reasoning_effort="high" plus temperature: 0 avec une réponse 400. Laissez la température non définie afin que Mistral utilise sa valeur par défaut, ou suivez les paramètres recommandés pour Medium 3.5 et utilisez temperature: 0.7 pour un raisonnement élevé. Pour des réponses directes déterministes, désactivez thinking ou réglez-le sur minimal afin qu’OpenClaw envoie reasoning_effort: "none" avant de baisser la température.

Exemple de configuration limitée au modèle pour le raisonnement Medium 3.5 :

{
  agents: {
    defaults: {
      model: { primary: "mistral/mistral-medium-3-5" },
      models: {
        "mistral/mistral-medium-3-5": {
          params: { thinking: "high" },
        },
      },
    },
  },
}

Les autres modèles du catalogue Mistral intégré n’utilisent pas ce paramètre. Continuez à utiliser les modèles magistral-* lorsque vous voulez le comportement natif de Mistral centré d’abord sur le raisonnement.

Embeddings mémoire

Mistral peut servir des embeddings mémoire via /v1/embeddings (modèle par défaut : mistral-embed).

{
  memorySearch: { provider: "mistral" },
}

Authentification et URL de base

L’authentification Mistral utilise MISTRAL_API_KEY (en-tête Bearer).
L’URL de base du fournisseur est par défaut https://api.mistral.ai/v1 et accepte la forme de requête chat-completions standard compatible OpenAI.
Le modèle par défaut de l’onboarding est mistral/mistral-large-latest.
Remplacez l’URL de base sous models.providers.mistral.baseUrl uniquement lorsque Mistral publie explicitement un endpoint régional dont vous avez besoin.

Connexe

Sélection de modèle

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

Compréhension des médias

Configuration de la transcription audio et sélection du fournisseur.

Overview

Concepts and configuration

Providers

Bien démarrer

Catalogue LLM intégré

Transcription audio (Voxtral)

STT en streaming pour Appel vocal

Configuration avancée

Connexe

Sélection de modèle

Compréhension des médias

Overview

Concepts and configuration

Providers

Documentation Index

​Bien démarrer

​Catalogue LLM intégré

​Transcription audio (Voxtral)

​STT en streaming pour Appel vocal

​Configuration avancée

​Connexe

Sélection de modèle

Compréhension des médias

Bien démarrer

Catalogue LLM intégré

Transcription audio (Voxtral)

STT en streaming pour Appel vocal

Configuration avancée

Connexe