OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Mistral

De gebundelde mistral-Plugin registreert vier contracten: chataanvullingen, 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

  • Haal je API-sleutel op

    Maak een API-sleutel aan in de Mistral Console.

  • Voer de onboarding uit

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

    Of geef de sleutel rechtstreeks door:

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

  • Stel een standaardmodel in

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

  • Controleer of het model beschikbaar is

    bash
    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 redeneercapaciteit
    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 betreffende rij in de gebundelde catalogus voordat je de configuratie wijzigt:

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

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

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

    Audiotranscriptie (Voxtral)

    Gebruik Voxtral voor batchgewijze audiotranscriptie via de pipeline voor mediabegrip:

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

    Streaming-STT voor Voice Call

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

    Instelling Configuratiepad Standaard
    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
    Bemonsteringsfrequentie ...mistral.sampleRate 8000
    Doelvertraging ...mistral.targetStreamingDelayMs 800
    json5
    {  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "mistral",            providers: {              mistral: {                apiKey: "${MISTRAL_API_KEY}",                targetStreamingDelayMs: 800,              },            },          },        },      },    },  },}

    Geavanceerde configuratie

    Instelbare redeneercapaciteit

    mistral/mistral-small-latest, mistral/mistral-small-2603 en mistral/mistral-medium-3-5 ondersteunen instelbare redeneercapaciteit 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 denkniveau van de sessie als volgt aan de API van Mistral:

    OpenClaw-denkniveau Mistral reasoning_effort
    uit / minimaal none
    laag / gemiddeld / hoog / xhoog / adaptief / maximaal high

    Voorbeeld van modelspecifieke configuratie voor het redeneren van Medium 3.5:

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

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

    json5
    {  agents: {    defaults: {      memorySearch: { 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 chataanvullingen.
    • 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.

    Gerelateerd

    Modelselectie

    Providers, modelreferenties en failovergedrag kiezen.
    Mediabegrip

    Audiotranscriptie instellen en een provider selecteren.
    Was this useful?
    On this page

    On this page