English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Providers

Mistral

OpenClaw includes a bundled Mistral plugin that registers four contracts: chat completions, media understanding (Voxtral batch transcription), realtime STT for Voice Call (Voxtral Realtime), and memory embeddings (mistral-embed).

Property Value
Provider id mistral
Plugin bundled, enabledByDefault: true
Auth env var MISTRAL_API_KEY
Onboarding flag --auth-choice mistral-api-key
Direct CLI flag --mistral-api-key <key>
API OpenAI-compatible (openai-completions)
Base URL https://api.mistral.ai/v1
Default model mistral/mistral-large-latest
Embedding model mistral-embed
Voxtral batch voxtral-mini-latest (audio transcription)
Voxtral realtime voxtral-mini-transcribe-realtime-2602

Getting started

  • Get your API key

    Create an API key in the Mistral Console.

  • Run onboarding

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

    Or pass the key directly:

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

  • Set a default model

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

  • Verify the model is available

    openclaw models list --provider mistral

    • Built-in LLM catalog

    OpenClaw currently ships this bundled Mistral catalog:

    Model ref Input Context Max output Notes
    mistral/mistral-large-latest text, image 262,144 16,384 Default model
    mistral/mistral-medium-2508 text, image 262,144 8,192 Mistral Medium 3.1
    mistral/mistral-small-latest text, image 128,000 16,384 Mistral Small 4; adjustable reasoning via API reasoning_effort
    mistral/pixtral-large-latest text, image 128,000 32,768 Pixtral
    mistral/codestral-latest text 256,000 4,096 Coding
    mistral/devstral-medium-latest text 262,144 32,768 Devstral 2
    mistral/magistral-small text 128,000 40,000 Reasoning-enabled

    Audio transcription (Voxtral)

    Use Voxtral for batch audio transcription through the media understanding pipeline.

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

    Voice Call streaming STT

    The bundled mistral plugin registers Voxtral Realtime as a Voice Call streaming STT provider.

    Setting Config path Default
    API key plugins.entries.voice-call.config.streaming.providers.mistral.apiKey Falls back to MISTRAL_API_KEY
    Model ...mistral.model voxtral-mini-transcribe-realtime-2602
    Encoding ...mistral.encoding pcm_mulaw
    Sample rate ...mistral.sampleRate 8000
    Target delay ...mistral.targetStreamingDelayMs 800 
    {
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}

    Advanced configuration

    Adjustable reasoning (mistral-small-latest)

    mistral/mistral-small-latest maps to Mistral Small 4 and supports adjustable reasoning on the Chat Completions API via reasoning_effort (none minimizes extra thinking in the output; high surfaces full thinking traces before the final answer).

    OpenClaw maps the session thinking level to Mistral's API:

    OpenClaw thinking level Mistral reasoning_effort
    off / minimal none
    low / medium / high / xhigh / adaptive / max high
    Memory embeddings

    Mistral can serve memory embeddings via /v1/embeddings (default model: mistral-embed).

    {
  memorySearch: { provider: "mistral" },
}
    Auth and base URL
    • Mistral auth uses MISTRAL_API_KEY (Bearer header).
    • Provider base URL defaults to https://api.mistral.ai/v1 and accepts the standard OpenAI-compatible chat-completions request shape.
    • Onboarding default model is mistral/mistral-large-latest.
    • Override the base URL under models.providers.mistral.baseUrl only when Mistral explicitly publishes a regional endpoint you need.
    Model selection

    Choosing providers, model refs, and failover behavior.
    Media understanding

    Audio transcription setup and provider selection.