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
Terminal window
```
openclaw models list --provider mistral
```

Built-in LLM catalog

Mistral Medium 3.5 is the current blended Medium model in the bundled catalog: 128B dense weights, text and image input, 256K context, function calling, structured output, coding, and adjustable reasoning through the Chat Completions API. Use mistral/mistral-medium-3-5 when you want Mistral’s newer unified agentic/coding model instead of the default mistral/mistral-large-latest.

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-medium-3-5`	text, image	262,144	8,192	Mistral Medium 3.5; adjustable reasoning
`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

After onboarding, smoke-test Medium 3.5 without starting the Gateway:

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

To browse the bundled catalog row before changing config:

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

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/mistral-small-latest (Mistral Small 4) and mistral/mistral-medium-3-5 support 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). Mistral recommends reasoning_effort="high" for Medium 3.5 agentic and code use cases.

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`

Example model-scoped config for Medium 3.5 reasoning:

{
  agents: {
    defaults: {
      model: { primary: "mistral/mistral-medium-3-5" },
      models: {
        "mistral/mistral-medium-3-5": {
          params: { thinking: "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.