---
read_when:
    - Vous voulez utiliser les modèles Mistral dans OpenClaw
    - Vous souhaitez la transcription en temps réel de Voxtral pour les appels vocaux
    - Vous avez besoin de l’intégration de la clé API Mistral et des références de modèles
summary: Utiliser les modèles Mistral et la transcription Voxtral avec OpenClaw
title: Mistral
x-i18n:
    generated_at: "2026-04-30T07:44:43Z"
    model: gpt-5.5
    provider: openai
    source_hash: 7fdba72a5a526bed78ef3a6ea633839634efca3f9d2e96b305315d534d115122
    source_path: providers/mistral.md
    workflow: 16
---

OpenClaw prend en charge Mistral pour le routage des modèles texte/image (`mistral/...`) ainsi que pour
la transcription audio via Voxtral dans la compréhension des médias.
Mistral peut également être utilisé pour les embeddings de mémoire (`memorySearch.provider = "mistral"`).

- Fournisseur : `mistral`
- Authentification : `MISTRAL_API_KEY`
- API : Chat Completions de Mistral (`https://api.mistral.ai/v1`)

## Bien démarrer

<Steps>
  <Step title="Obtenir votre clé API">
    Créez une clé API dans la [console Mistral](https://console.mistral.ai/).
  </Step>
  <Step title="Exécuter l’onboarding">
    ```bash
    openclaw onboard --auth-choice mistral-api-key
    ```

    Ou transmettez directement la clé :

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

  </Step>
  <Step title="Définir un modèle par défaut">
    ```json5
    {
      env: { MISTRAL_API_KEY: "sk-..." },
      agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
    }
    ```
  </Step>
  <Step title="Vérifier que le modèle est disponible">
    ```bash
    openclaw models list --provider mistral
    ```
  </Step>
</Steps>

## Catalogue LLM intégré

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-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é                                              |

## Transcription audio (Voxtral)

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

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

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

## STT en streaming pour Voice Call

Le Plugin `mistral` intégré enregistre Voxtral Realtime comme fournisseur STT
en streaming pour Voice Call.

| Paramètre    | Chemin de configuration                                                | 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`                             |
| Taux d’échantillonnage | `...mistral.sampleRate`                                      | `8000`                                  |
| Délai cible  | `...mistral.targetStreamingDelayMs`                                    | `800`                                   |

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

<Note>
OpenClaw définit par défaut le STT temps réel de Mistral sur `pcm_mulaw` à 8 kHz afin que Voice Call
puisse transférer directement les trames multimédias Twilio. Utilisez `encoding: "pcm_s16le"` et un
`sampleRate` correspondant uniquement si votre flux amont est déjà du PCM brut.
</Note>

## Configuration avancée

<AccordionGroup>
  <Accordion title="Raisonnement ajustable (mistral-small-latest)">
    `mistral/mistral-small-latest` correspond à Mistral Small 4 et prend en charge le [raisonnement ajustable](https://docs.mistral.ai/capabilities/reasoning/adjustable) 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).

    OpenClaw mappe le niveau de **thinking** de la session à l’API de Mistral :

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

    <Note>
    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 axé d’abord sur le raisonnement.
    </Note>

  </Accordion>

  <Accordion title="Embeddings de mémoire">
    Mistral peut fournir des embeddings de mémoire via `/v1/embeddings` (modèle par défaut : `mistral-embed`).

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

  </Accordion>

  <Accordion title="Authentification et URL de base">
    - L’authentification Mistral utilise `MISTRAL_API_KEY`.
    - L’URL de base du fournisseur est par défaut `https://api.mistral.ai/v1`.
    - Le modèle par défaut d’onboarding est `mistral/mistral-large-latest`.
    - Z.AI utilise l’authentification Bearer avec votre clé API.

  </Accordion>
</AccordionGroup>

## Articles associés

<CardGroup cols={2}>
  <Card title="Sélection du modèle" href="/fr/concepts/model-providers" icon="layers">
    Choisir les fournisseurs, les références de modèle et le comportement de basculement.
  </Card>
  <Card title="Compréhension des médias" href="/fr/nodes/media-understanding" icon="microphone">
    Configuration de la transcription audio et sélection du fournisseur.
  </Card>
</CardGroup>
