Zum Hauptinhalt springen

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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).
EigenschaftWert
Provider-IDmistral
Plugingebündelt, enabledByDefault: true
Auth-Env-VarMISTRAL_API_KEY
Onboarding-Flag--auth-choice mistral-api-key
Direktes CLI-Flag--mistral-api-key <key>
APIOpenAI-kompatibel (openai-completions)
Basis-URLhttps://api.mistral.ai/v1
Standardmodellmistral/mistral-large-latest
Embedding-Modellmistral-embed
Voxtral-Batchvoxtral-mini-latest (Audiotranskription)
Voxtral-Echtzeitvoxtral-mini-transcribe-realtime-2602

​
Erste Schritte

1

API-Schlüssel abrufen

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

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"
3

Standardmodell festlegen

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

Prüfen, ob das Modell verfügbar ist

openclaw models list --provider mistral

​
Integrierter 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:
ModellreferenzEingabeKontextMaximale AusgabeHinweise
mistral/mistral-large-latestText, Bild262,14416,384Standardmodell
mistral/mistral-medium-2508Text, Bild262,1448,192Mistral Medium 3.1
mistral/mistral-medium-3-5Text, Bild262,1448,192Mistral Medium 3.5; anpassbares Reasoning
mistral/mistral-small-latestText, Bild128,00016,384Mistral Small 4; anpassbares Reasoning über API reasoning_effort
mistral/pixtral-large-latestText, Bild128,00032,768Pixtral
mistral/codestral-latestText256,0004,096Coding
mistral/devstral-medium-latestText262,14432,768Devstral 2
mistral/magistral-smallText128,00040,000Reasoning-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" \
  --json
So durchsuchen Sie die gebündelte Katalogzeile, bevor Sie die Konfiguration ändern: 
openclaw models list --all --provider mistral --plain

​
Audiotranskription (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" }],
      },
    },
  },
}
Der Medien-Transkriptionspfad verwendet /v1/audio/transcriptions. Das Standard-Audiomodell für Mistral ist 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.
EinstellungKonfigurationspfadStandardwert
API-Schlüsselplugins.entries.voice-call.config.streaming.providers.mistral.apiKeyFällt auf MISTRAL_API_KEY zurück
Modell...mistral.modelvoxtral-mini-transcribe-realtime-2602
Encoding...mistral.encodingpcm_mulaw
Abtastrate...mistral.sampleRate8000
Zielverzögerung...mistral.targetStreamingDelayMs800
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}
OpenClaw setzt Mistral-Echtzeit-STT standardmäßig auf pcm_mulaw bei 8 kHz, damit Voice Call Twilio-Medienframes direkt weiterleiten kann. Verwenden Sie encoding: "pcm_s16le" und eine passende sampleRate nur, wenn Ihr Upstream-Stream bereits rohes PCM ist.

​
Erweiterte Konfiguration

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-StufeMistral reasoning_effort
off / minimalnone
low / medium / high / xhigh / adaptive / maxhigh
Kombinieren Sie den Reasoning-Modus von Medium 3.5 nicht mit temperature: 0. Die Mistral- HTTP-API weist reasoning_effort="high" plus temperature: 0 mit einer 400- Antwort zurück. Lassen Sie temperature unset, damit Mistral seinen Standardwert verwendet, oder folgen Sie den empfohlenen Einstellungen für Medium 3.5 und verwenden Sie temperature: 0.7 für hohes Reasoning. Für deterministische direkte Antworten deaktivieren Sie thinking oder setzen es auf minimal, damit OpenClaw reasoning_effort: "none" sendet, bevor Sie temperature senken.
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" },
        },
      },
    },
  },
}
Andere gebündelte Mistral-Katalogmodelle verwenden diesen Parameter nicht. Verwenden Sie weiterhin magistral-*-Modelle, wenn Sie Mistrals natives Reasoning-first-Verhalten möchten.
Mistral kann Memory-Embeddings über /v1/embeddings bereitstellen (Standardmodell: mistral-embed).
{
  memorySearch: { provider: "mistral" },
}
  • Mistral-Auth verwendet MISTRAL_API_KEY (Bearer-Header).
  • Die Provider-Basis-URL ist standardmäßig https://api.mistral.ai/v1 und 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.baseUrl nur, wenn Mistral ausdrücklich einen regionalen Endpunkt veröffentlicht, den Sie benötigen.

​
Verwandte Themen

Modellauswahl

Provider, Modellreferenzen und Failover-Verhalten auswählen.

Medienverständnis

Einrichtung der Audiotranskription und Provider-Auswahl.