Mistral

De gebundelde mistral-Plugin registreert vier contracten: chatvoltooiingen, mediabegrip (Voxtral-batchtranscriptie), realtime STT voor Voice Call (Voxtral Realtime) en geheugen-embeddings (mistral-embed).

Eigenschap	Waarde
Provider-id	`mistral`
Plugin	gebundeld, standaard ingeschakeld
Auth-omgevingsvariabele	`MISTRAL_API_KEY`
Onboarding-vlag	`--auth-choice mistral-api-key`
Directe CLI-vlag	`--mistral-api-key <key>`
API	OpenAI-compatibel (`openai-completions`)
Basis-URL	`https://api.mistral.ai/v1`
Standaardmodel	`mistral/mistral-large-latest`
Embeddingmodel	`mistral-embed`
Voxtral-batch	`voxtral-mini-latest` (audiotranscriptie)
Voxtral-realtime	`voxtral-mini-transcribe-realtime-2602`

Aan de slag

Je API-sleutel verkrijgen

Maak een API-sleutel aan in de Mistral Console.

Onboarding uitvoeren

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

Of geef de sleutel rechtstreeks door:

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

Een standaardmodel instellen

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

Controleren of het model beschikbaar is

openclaw models list --provider mistral

Ingebouwde LLM-catalogus

Modelreferentie	Invoer	Context	Maximale uitvoer	Opmerkingen
`mistral/mistral-large-latest`	tekst, afbeelding	262,144	16,384	Standaardmodel
`mistral/mistral-medium-2508`	tekst, afbeelding	262,144	8,192	Mistral Medium 3.1
`mistral/mistral-medium-3-5`	tekst, afbeelding	262,144	8,192	Mistral Medium 3.5; instelbare redeneermodus
`mistral/mistral-small-latest`	tekst, afbeelding	262,144	16,384	Nieuwste Mistral Small 4; instelbare `reasoning_effort`
`mistral/mistral-small-2603`	tekst, afbeelding	262,144	16,384	Vastgezette Mistral Small 4; instelbare `reasoning_effort`
`mistral/pixtral-large-latest`	tekst, afbeelding	128,000	32,768	Pixtral
`mistral/codestral-latest`	tekst	256,000	4,096	Programmeren
`mistral/devstral-medium-latest`	tekst	262,144	32,768	Devstral 2
`mistral/magistral-small`	tekst	128,000	40,000	Redeneren ingeschakeld

Bekijk de rij in de gebundelde catalogus voordat je de configuratie wijzigt:

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

Voer een rooktest van een model uit zonder de Gateway te starten:

openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Antwoord exact met: mistral-ok" \
  --json

Audiotranscriptie (Voxtral)

Gebruik Voxtral voor batchgewijze audiotranscriptie via de pijplijn voor mediabegrip:

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

Het mediatranscriptiepad gebruikt /v1/audio/transcriptions. Het standaardaudiomodel voor Mistral is voxtral-mini-latest.

Streaming-STT voor Voice Call

De gebundelde mistral-Plugin registreert Voxtral Realtime als streaming-STT-provider voor Voice Call.

Instelling	Configuratiepad	Standaardwaarde
API-sleutel	`plugins.entries.voice-call.config.streaming.providers.mistral.apiKey`	Valt terug op `MISTRAL_API_KEY`
Model	`...mistral.model`	`voxtral-mini-transcribe-realtime-2602`
Codering	`...mistral.encoding`	`pcm_mulaw`
Samplefrequentie	`...mistral.sampleRate`	`8000`
Doelvertraging	`...mistral.targetStreamingDelayMs`	`800`

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

OpenClaw gebruikt voor Mistral realtime STT standaard pcm_mulaw op 8 kHz, zodat Voice Call mediaframes van Twilio rechtstreeks kan doorsturen. Gebruik encoding: "pcm_s16le" en een overeenkomende sampleRate alleen als je upstreamstream al onbewerkte PCM is.

Geavanceerde configuratie

Instelbare redeneermodus

mistral/mistral-small-latest, mistral/mistral-small-2603 en mistral/mistral-medium-3-5 ondersteunen instelbare redeneermodus in de Chat Completions-API via reasoning_effort (none minimaliseert extra denkwerk in de uitvoer; high toont volledige denksporen vóór het definitieve antwoord).OpenClaw koppelt het thinking-niveau van de sessie als volgt aan de API van Mistral:

Thinking-niveau van OpenClaw	Mistral `reasoning_effort`
uit / minimaal	`none`
laag / gemiddeld / hoog / xhoog / adaptief / max	`high`

Combineer de redeneermodus van Medium 3.5 niet met temperature: 0; naar verluidt weigert de HTTP-API van Mistral reasoning_effort="high" in combinatie met temperature: 0 met een 400-respons. Laat de temperatuur oningesteld of schakel thinking uit of op minimaal, zodat OpenClaw reasoning_effort: "none" verzendt voordat je een lage temperatuur instelt.

Voorbeeld van modelspecifieke configuratie voor de redeneermodus van Medium 3.5:

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

Andere gebundelde Mistral-modellen in de catalogus gebruiken deze parameter niet. Blijf magistral-*-modellen gebruiken wanneer je het systeemeigen, op redeneren gerichte gedrag van Mistral wilt.

Geheugen-embeddings

Mistral kan geheugen-embeddings aanbieden via /v1/embeddings (standaardmodel: mistral-embed):

{
  memory: {
    search: { provider: "mistral" },
  },
}

Authenticatie en basis-URL

Mistral-authenticatie gebruikt MISTRAL_API_KEY (Bearer-header).
De basis-URL van de provider is standaard https://api.mistral.ai/v1 en accepteert de standaard OpenAI-compatibele aanvraagstructuur voor chatvoltooiingen.
Het standaardmodel voor onboarding is mistral/mistral-large-latest.
Overschrijf de basis-URL onder models.providers.mistral.baseUrl alleen wanneer Mistral expliciet een regionaal eindpunt publiceert dat je nodig hebt.

Overview

Concepts and configuration

Providers

Aan de slag

Ingebouwde LLM-catalogus

Audiotranscriptie (Voxtral)

Streaming-STT voor Voice Call

Geavanceerde configuratie

Gerelateerd

Modelselectie

Mediabegrip

​Aan de slag

​Ingebouwde LLM-catalogus

​Audiotranscriptie (Voxtral)

​Streaming-STT voor Voice Call

​Geavanceerde configuratie

​Gerelateerd

Modelselectie

Mediabegrip

Aan de slag

Ingebouwde LLM-catalogus

Audiotranscriptie (Voxtral)

Streaming-STT voor Voice Call

Geavanceerde configuratie

Gerelateerd