Providers
Mistral
OpenClaw enthält ein gebündeltes Mistral-Plugin, das vier Verträge registriert: Chat-Vervollständigungen, Medienverständnis (Voxtral-Batch-Transkription), Echtzeit-STT für Voice Call (Voxtral Realtime) und Memory-Embeddings (mistral-embed).
| Eigenschaft | Wert |
|---|---|
| Provider-ID | mistral |
| Plugin | gebündelt, enabledByDefault: true |
| Auth-Env-Var | MISTRAL_API_KEY |
| Onboarding-Flag | --auth-choice mistral-api-key |
| Direktes CLI-Flag | --mistral-api-key <key> |
| API | OpenAI-kompatibel (openai-completions) |
| Basis-URL | https://api.mistral.ai/v1 |
| Standardmodell | mistral/mistral-large-latest |
| Embedding-Modell | mistral-embed |
| Voxtral-Batch | voxtral-mini-latest (Audiotranskription) |
| Voxtral-Echtzeit | voxtral-mini-transcribe-realtime-2602 |
Erste Schritte
API-Schlüssel abrufen
Erstellen Sie einen API-Schlüssel in der Mistral Console.
Onboarding ausführen
openclaw onboard --auth-choice mistral-api-keyOder übergeben Sie den Schlüssel direkt:
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"Standardmodell festlegen
{ env: { MISTRAL_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },}Prüfen, ob das Modell verfügbar ist
openclaw models list --provider mistralIntegrierter LLM-Katalog
Mistral Medium 3.5
ist das aktuelle kombinierte Medium-Modell im gebündelten Katalog: 128B dichte Gewichte,
Text- und Bildeingabe, 256K Kontext, Function Calling, strukturierte Ausgabe, Coding
und anpassbares Reasoning über die Chat Completions API. Verwenden Sie
mistral/mistral-medium-3-5, wenn Sie Mistrals neueres vereinheitlichtes
Agentic-/Coding-Modell statt des Standardmodells mistral/mistral-large-latest möchten.
OpenClaw liefert derzeit diesen gebündelten Mistral-Katalog aus:
| Modellreferenz | Eingabe | Kontext | Maximale Ausgabe | Hinweise |
|---|---|---|---|---|
mistral/mistral-large-latest |
Text, Bild | 262,144 | 16,384 | Standardmodell |
mistral/mistral-medium-2508 |
Text, Bild | 262,144 | 8,192 | Mistral Medium 3.1 |
mistral/mistral-medium-3-5 |
Text, Bild | 262,144 | 8,192 | Mistral Medium 3.5; anpassbares Reasoning |
mistral/mistral-small-latest |
Text, Bild | 128,000 | 16,384 | Mistral Small 4; anpassbares Reasoning über API reasoning_effort |
mistral/pixtral-large-latest |
Text, Bild | 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-fähig |
Führen Sie nach dem Onboarding einen Smoke-Test für Medium 3.5 aus, ohne den Gateway zu starten:
openclaw infer model run --local \ --model mistral/mistral-medium-3-5 \ --prompt "Reply with exactly: mistral-ok" \ --jsonSo durchsuchen Sie die gebündelte Katalogzeile, bevor Sie die Konfiguration ändern:
openclaw models list --all --provider mistral --plainAudiotranskription (Voxtral)
Verwenden Sie Voxtral für Batch-Audiotranskription über die Pipeline für Medienverständnis.
{ tools: { media: { audio: { enabled: true, models: [{ provider: "mistral", model: "voxtral-mini-latest" }], }, }, },}Streaming-STT für Voice Call
Das gebündelte mistral-Plugin registriert Voxtral Realtime als Streaming-STT-Provider
für Voice Call.
| Einstellung | Konfigurationspfad | Standardwert |
|---|---|---|
| API-Schlüssel | plugins.entries.voice-call.config.streaming.providers.mistral.apiKey |
Fällt auf MISTRAL_API_KEY zurück |
| Modell | ...mistral.model |
voxtral-mini-transcribe-realtime-2602 |
| Encoding | ...mistral.encoding |
pcm_mulaw |
| Abtastrate | ...mistral.sampleRate |
8000 |
| Zielverzögerung | ...mistral.targetStreamingDelayMs |
800 |
{ plugins: { entries: { "voice-call": { config: { streaming: { enabled: true, provider: "mistral", providers: { mistral: { apiKey: "${MISTRAL_API_KEY}", targetStreamingDelayMs: 800, }, }, }, }, }, }, },}Erweiterte Konfiguration
Anpassbares Reasoning
mistral/mistral-small-latest (Mistral Small 4) und mistral/mistral-medium-3-5 unterstützen anpassbares Reasoning in der Chat Completions API über reasoning_effort (none minimiert zusätzliches Denken in der Ausgabe; high zeigt vollständige Denkspuren vor der finalen Antwort). Mistral empfiehlt reasoning_effort="high" für agentische und Code-Anwendungsfälle mit Medium 3.5.
OpenClaw ordnet die thinking-Stufe der Sitzung der Mistral-API zu:
| OpenClaw-thinking-Stufe | Mistral reasoning_effort |
|---|---|
| off / minimal | none |
| low / medium / high / xhigh / adaptive / max | high |
Beispiel für eine modellbezogene Konfiguration für Reasoning mit Medium 3.5:
{ agents: { defaults: { model: { primary: "mistral/mistral-medium-3-5" }, models: { "mistral/mistral-medium-3-5": { params: { thinking: "high" }, }, }, }, },}Memory-Embeddings
Mistral kann Memory-Embeddings über /v1/embeddings bereitstellen (Standardmodell: mistral-embed).
{ memorySearch: { provider: "mistral" },}Auth und Basis-URL
- Mistral-Auth verwendet
MISTRAL_API_KEY(Bearer-Header). - Die Provider-Basis-URL ist standardmäßig
https://api.mistral.ai/v1und akzeptiert die standardmäßige OpenAI-kompatible Request-Struktur für Chat-Vervollständigungen. - Das Standardmodell für Onboarding ist
mistral/mistral-large-latest. - Überschreiben Sie die Basis-URL unter
models.providers.mistral.baseUrlnur, wenn Mistral ausdrücklich einen regionalen Endpunkt veröffentlicht, den Sie benötigen.