Mistral

Das gebündelte Plugin mistral registriert vier Verträge: Chat Completions, 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, standardmäßig aktiviert
Auth-Umgebungsvariable	`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` (Audio-Transkription)
Voxtral-Echtzeit	`voxtral-mini-transcribe-realtime-2602`

Erste Schritte

API-Schlüssel abrufen

Erstellen Sie in der Mistral Console einen API-Schlüssel.

Onboarding ausführen

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

Oder ü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" } } },
}

Verfügbarkeit des Modells überprüfen

openclaw models list --provider mistral

Integrierter LLM-Katalog

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	262,144	16,384	Neueste Version von Mistral Small 4; anpassbares `reasoning_effort`
`mistral/mistral-small-2603`	Text, Bild	262,144	16,384	Fixierte Version von Mistral Small 4; anpassbares `reasoning_effort`
`mistral/pixtral-large-latest`	Text, Bild	128,000	32,768	Pixtral
`mistral/codestral-latest`	Text	256,000	4,096	Programmierung
`mistral/devstral-medium-latest`	Text	262,144	32,768	Devstral 2
`mistral/magistral-small`	Text	128,000	40,000	Reasoning aktiviert

Prüfen Sie den Eintrag im gebündelten Katalog, bevor Sie die Konfiguration ändern:

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

Führen Sie einen Smoke-Test für ein Modell aus, ohne den Gateway zu starten:

openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Antworten Sie exakt mit: mistral-ok" \
  --json

Audio-Transkription (Voxtral)

Verwenden Sie Voxtral für die Batch-Audio-Transkription über die Pipeline für Medienverständnis:

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

Der Pfad für die Medien-Transkription verwendet /v1/audio/transcriptions. Das Standard-Audiomodell für Mistral ist voxtral-mini-latest.

Voice-Call-Streaming-STT

Das gebündelte Plugin mistral 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`
Codierung	`...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,
              },
            },
          },
        },
      },
    },
  },
}

OpenClaw verwendet für Mistral-Echtzeit-STT standardmäßig pcm_mulaw bei 8 kHz, damit Voice Call Twilio-Medienframes direkt weiterleiten kann. Verwenden Sie encoding: "pcm_s16le" und eine passende Einstellung für sampleRate nur, wenn Ihr Upstream-Stream bereits aus unkomprimiertem PCM besteht.

Erweiterte Konfiguration

Anpassbares Reasoning

mistral/mistral-small-latest, mistral/mistral-small-2603 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 gibt vor der endgültigen Antwort vollständige Denkspuren aus).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`

Vermeiden Sie es, den Reasoning-Modus von Medium 3.5 mit temperature: 0 zu kombinieren. Berichten zufolge lehnt die Mistral-HTTP-API reasoning_effort="high" zusammen mit temperature: 0 mit einer 400-Antwort ab. Lassen Sie die Temperatur nicht festgelegt, oder deaktivieren bzw. minimieren Sie Thinking, damit OpenClaw reasoning_effort: "none" sendet, bevor Sie eine niedrige Temperatur festlegen.

Beispiel einer modellspezifischen Konfiguration für das Reasoning von Medium 3.5:

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

Andere gebündelte Modelle im Mistral-Katalog verwenden diesen Parameter nicht. Verwenden Sie weiterhin magistral-*-Modelle, wenn Sie das native Reasoning-First-Verhalten von Mistral wünschen.

Memory Embeddings

Mistral kann Memory Embeddings über /v1/embeddings bereitstellen (Standardmodell: mistral-embed):

{
  memory: {
    search: { provider: "mistral" },
  },
}

Authentifizierung und Basis-URL

Die Mistral-Authentifizierung verwendet MISTRAL_API_KEY (Bearer-Header).
Die Basis-URL des Providers ist standardmäßig https://api.mistral.ai/v1 und akzeptiert das standardmäßige OpenAI-kompatible Anfrageformat für Chat Completions.
Das Standardmodell für das Onboarding ist mistral/mistral-large-latest.
Überschreiben Sie die Basis-URL unter models.providers.mistral.baseUrl nur, wenn Mistral ausdrücklich einen von Ihnen benötigten regionalen Endpunkt veröffentlicht.

Modellauswahl

Auswahl von Providern, Modellreferenzen und Failover-Verhalten.

Medienverständnis

Einrichtung der Audio-Transkription und Auswahl des Providers.

Overview

Concepts and configuration

Providers

Erste Schritte

Integrierter LLM-Katalog

Audio-Transkription (Voxtral)

Voice-Call-Streaming-STT

Erweiterte Konfiguration

Verwandte Themen

Modellauswahl

Medienverständnis

​Erste Schritte

​Integrierter LLM-Katalog

​Audio-Transkription (Voxtral)

​Voice-Call-Streaming-STT

​Erweiterte Konfiguration

​Verwandte Themen

Modellauswahl

Medienverständnis

Erste Schritte

Integrierter LLM-Katalog

Audio-Transkription (Voxtral)

Voice-Call-Streaming-STT

Erweiterte Konfiguration

Verwandte Themen