Mistral Provider

기준일: 2026-07-26
난이도: 중급
공식 기준: Mistral

개요

이 페이지는 OpenClaw Mistral provider의 인증, 모델 ref, 온보딩 플래그, 설정 키를 공식 문서 기준으로 정리합니다.

공식 요약: Use Mistral models and Voxtral transcription with OpenClaw

model ref는 보통 provider/model 형식입니다. API key·endpoint·model id는 아래 원문 값을 그대로 쓰세요. 임의로 키나 엔드포인트를 만들지 마세요.

빠른 참조

Property	Value
Provider id	mistral
Plugin	bundled, enabled by default
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

공식 문서 기반 상세

아래는 공식 providers/mistral 문서를 Mintlify 컴포넌트만 정리하고 공통 제목을 한국어로 맞춘 내용입니다. 설정 키, env, model ref, CLI 플래그는 원문 그대로 유지합니다.

The bundled mistral plugin 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, enabled by default
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

시작하기

Get your API key

Create an API key in the [Mistral Console](https://console.mistral.ai/).

Run onboarding

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

Or pass the key directly:

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

Set a default model

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

Verify the model is available

```bash
openclaw models list --provider mistral
```

내장 LLM 카탈로그

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	262,144	16,384	Mistral Small 4 latest; adjustable reasoning_effort
mistral/mistral-small-2603	text, image	262,144	16,384	Mistral Small 4 pinned; adjustable 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

Browse the bundled catalog row before changing config:

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

Smoke-test a model without starting the Gateway:

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

오디오 전사 (Voxtral)

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

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

The media transcription path uses /v1/audio/transcriptions. The default audio model for Mistral is 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,
              },
            },
          },
        },
      },
    },
  },
}

OpenClaw defaults Mistral realtime STT to pcm_mulaw at 8 kHz so Voice Call can forward Twilio media frames directly. Use encoding: "pcm_s16le" and a matching sampleRate only if your upstream stream is already raw PCM.

고급 설정

Adjustable reasoning

`mistral/mistral-small-latest`, `mistral/mistral-small-2603`, and `mistral/mistral-medium-3-5` support [adjustable reasoning](https://docs.mistral.ai/studio-api/conversations/reasoning/adjustable) 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`                       |

Avoid combining Medium 3.5 reasoning mode with temperature: 0; the Mistral HTTP API has been reported to reject reasoning_effort="high" plus temperature: 0 with a 400 response. Leave temperature unset, or turn thinking off/minimal so OpenClaw sends reasoning_effort: "none" before you set a low temperature.

Example model-scoped config for Medium 3.5 reasoning:

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

Other bundled Mistral catalog models do not use this parameter. Keep using magistral-* models when you want Mistral's native reasoning-first behavior.

Memory embeddings

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

```json5
{
  memory: {
    search: { 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.

관련 문서

Choosing providers, model refs, and failover behavior.


Audio transcription setup and provider selection.

검증 체크리스트

• openclaw models list --provider mistral 로 모델이 보이는지 확인
• 기본 model alias를 agents.defaults.model.primary에 설정했는지 확인
• API key / OAuth / 로컬 런타임 인증 경로를 공식 문서와 대조했는지 확인
• failover 시 데이터가 다른 provider로 이동할 수 있는지 검토

관련

• Provider 목록 인덱스
• 로컬 모델과 Provider
• 공식: Provider directory, Model providers