Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw bevat een gebundelde Mistral-Plugin die vier contracten registreert: chataanvullingen, mediabegrip (Voxtral-batchtranscriptie), realtime STT voor Voice Call (Voxtral Realtime) en geheugenembeddings (mistral-embed).
EigenschapWaarde
Provider-idmistral
Plugingebundeld, enabledByDefault: true
Auth-env-varMISTRAL_API_KEY
Onboarding-vlag--auth-choice mistral-api-key
Directe CLI-vlag--mistral-api-key <key>
APIOpenAI-compatibel (openai-completions)
Basis-URLhttps://api.mistral.ai/v1
Standaardmodelmistral/mistral-large-latest
Embeddingmodelmistral-embed
Voxtral-batchvoxtral-mini-latest (audiotranscriptie)
Voxtral-realtimevoxtral-mini-transcribe-realtime-2602

Aan de slag

1

Haal je API-sleutel op

Maak een API-sleutel aan in de Mistral Console.
2

Voer onboarding uit

openclaw onboard --auth-choice mistral-api-key
Of geef de sleutel rechtstreeks door:
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
3

Stel een standaardmodel in

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

Controleer of het model beschikbaar is

openclaw models list --provider mistral

Ingebouwde LLM-catalogus

Mistral Medium 3.5 is het huidige gecombineerde Medium-model in de gebundelde catalogus: 128B dense gewichten, tekst- en beeldinvoer, 256K context, functieaanroepen, gestructureerde uitvoer, coderen en instelbare reasoning via de Chat Completions API. Gebruik mistral/mistral-medium-3-5 wanneer je Mistrals nieuwere uniforme agentic/coding-model wilt in plaats van de standaard mistral/mistral-large-latest. OpenClaw levert momenteel deze gebundelde Mistral-catalogus:
Model-refInvoerContextMax. uitvoerOpmerkingen
mistral/mistral-large-latesttekst, beeld262,14416,384Standaardmodel
mistral/mistral-medium-2508tekst, beeld262,1448,192Mistral Medium 3.1
mistral/mistral-medium-3-5tekst, beeld262,1448,192Mistral Medium 3.5; instelbare reasoning
mistral/mistral-small-latesttekst, beeld128,00016,384Mistral Small 4; instelbare reasoning via API reasoning_effort
mistral/pixtral-large-latesttekst, beeld128,00032,768Pixtral
mistral/codestral-latesttekst256,0004,096Coderen
mistral/devstral-medium-latesttekst262,14432,768Devstral 2
mistral/magistral-smalltekst128,00040,000Reasoning ingeschakeld
Smoke-test na onboarding Medium 3.5 zonder de Gateway te starten:
openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Reply with exactly: mistral-ok" \
  --json
Om de gebundelde catalogusrij te bekijken voordat je de configuratie wijzigt:
openclaw models list --all --provider mistral --plain

Audiotranscriptie (Voxtral)

Gebruik Voxtral voor batch-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.

Voice Call streaming STT

De gebundelde mistral-Plugin registreert Voxtral Realtime als streaming-STT-provider voor Voice Call.
InstellingConfiguratiepadStandaard
API-sleutelplugins.entries.voice-call.config.streaming.providers.mistral.apiKeyValt terug op MISTRAL_API_KEY
Model...mistral.modelvoxtral-mini-transcribe-realtime-2602
Codering...mistral.encodingpcm_mulaw
Samplefrequentie...mistral.sampleRate8000
Doelvertraging...mistral.targetStreamingDelayMs800
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}
OpenClaw stelt Mistral realtime STT standaard in op pcm_mulaw bij 8 kHz, zodat Voice Call Twilio-mediaframes rechtstreeks kan doorsturen. Gebruik encoding: "pcm_s16le" en een bijpassende sampleRate alleen als je upstream-stream al raw PCM is.

Geavanceerde configuratie

mistral/mistral-small-latest (Mistral Small 4) en mistral/mistral-medium-3-5 ondersteunen instelbare reasoning op de Chat Completions API via reasoning_effort (none minimaliseert extra denkwerk in de uitvoer; high toont volledige denksporen vóór het definitieve antwoord). Mistral raadt reasoning_effort="high" aan voor agentic- en code-usecases met Medium 3.5.OpenClaw koppelt het thinking-niveau van de sessie aan Mistrals API:
OpenClaw thinking-niveauMistral reasoning_effort
off / minimalnone
low / medium / high / xhigh / adaptive / maxhigh
Combineer de reasoning-modus van Medium 3.5 niet met temperature: 0. De Mistral HTTP API weigert reasoning_effort="high" plus temperature: 0 met een 400- respons. Laat temperatuur oningesteld zodat Mistral de standaard gebruikt, of volg de aanbevolen instellingen voor Medium 3.5 en gebruik temperature: 0.7 voor hoge reasoning. Voor deterministische directe antwoorden zet je thinking uit/minimaal, zodat OpenClaw reasoning_effort: "none" verstuurt voordat je de temperatuur verlaagt.
Voorbeeld van modelspecifieke configuratie voor Medium 3.5-reasoning:
{
  agents: {
    defaults: {
      model: { primary: "mistral/mistral-medium-3-5" },
      models: {
        "mistral/mistral-medium-3-5": {
          params: { thinking: "high" },
        },
      },
    },
  },
}
Andere gebundelde Mistral-catalogusmodellen gebruiken deze parameter niet. Blijf magistral-*-modellen gebruiken wanneer je Mistrals native reasoning-first-gedrag wilt.
Mistral kan geheugenembeddings leveren via /v1/embeddings (standaardmodel: mistral-embed).
{
  memorySearch: { provider: "mistral" },
}
  • Mistral-auth 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 chat-completions-requestvorm.
  • Het standaardmodel voor onboarding is mistral/mistral-large-latest.
  • Overschrijf de basis-URL onder models.providers.mistral.baseUrl alleen wanneer Mistral expliciet een regionale endpoint publiceert die je nodig hebt.

Gerelateerd

Modelselectie

Providers, model-refs en failover-gedrag kiezen.

Mediabegrip

Instellen van audiotranscriptie en providerselectie.