Mistral

Dołączony Plugin mistral rejestruje cztery kontrakty: uzupełnianie czatu, rozpoznawanie multimediów (transkrypcja wsadowa Voxtral), STT w czasie rzeczywistym dla połączeń głosowych (Voxtral Realtime) oraz osadzanie pamięci (mistral-embed).

Właściwość	Wartość
Identyfikator dostawcy	`mistral`
Plugin	dołączony, domyślnie włączony
Zmienna środowiskowa uwierzytelniania	`MISTRAL_API_KEY`
Flaga wdrażania	`--auth-choice mistral-api-key`
Bezpośrednia flaga CLI	`--mistral-api-key <key>`
API	zgodne z OpenAI (`openai-completions`)
Bazowy adres URL	`https://api.mistral.ai/v1`
Model domyślny	`mistral/mistral-large-latest`
Model osadzania	`mistral-embed`
Voxtral wsadowy	`voxtral-mini-latest` (transkrypcja dźwięku)
Voxtral w czasie rzeczywistym	`voxtral-mini-transcribe-realtime-2602`

Pierwsze kroki

Get your API key

Utwórz klucz API w konsoli Mistral.

Run onboarding

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

Możesz też przekazać klucz bezpośrednio:

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

openclaw models list --provider mistral

Wbudowany katalog modeli LLM

Odwołanie do modelu	Dane wejściowe	Kontekst	Maks. wynik	Uwagi
`mistral/mistral-large-latest`	tekst, obraz	262,144	16,384	Model domyślny
`mistral/mistral-medium-2508`	tekst, obraz	262,144	8,192	Mistral Medium 3.1
`mistral/mistral-medium-3-5`	tekst, obraz	262,144	8,192	Mistral Medium 3.5; regulowane rozumowanie
`mistral/mistral-small-latest`	tekst, obraz	262,144	16,384	najnowszy Mistral Small 4; regulowane `reasoning_effort`
`mistral/mistral-small-2603`	tekst, obraz	262,144	16,384	przypięty Mistral Small 4; regulowane `reasoning_effort`
`mistral/pixtral-large-latest`	tekst, obraz	128,000	32,768	Pixtral
`mistral/codestral-latest`	tekst	256,000	4,096	Programowanie
`mistral/devstral-medium-latest`	tekst	262,144	32,768	Devstral 2
`mistral/magistral-small`	tekst	128,000	40,000	Z obsługą rozumowania

Przed zmianą konfiguracji przejrzyj odpowiedni wiersz dołączonego katalogu:

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

Wykonaj test dymny modelu bez uruchamiania Gateway:

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

Transkrypcja dźwięku (Voxtral)

Użyj Voxtral do wsadowej transkrypcji dźwięku za pośrednictwem potoku rozpoznawania multimediów:

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

Ścieżka transkrypcji multimediów używa /v1/audio/transcriptions. Domyślnym modelem dźwięku Mistral jest voxtral-mini-latest.

Strumieniowe STT dla połączeń głosowych

Dołączony Plugin mistral rejestruje Voxtral Realtime jako dostawcę strumieniowego STT dla połączeń głosowych.

Ustawienie	Ścieżka konfiguracji	Wartość domyślna
Klucz API	`plugins.entries.voice-call.config.streaming.providers.mistral.apiKey`	Używa zastępczo `MISTRAL_API_KEY`
Model	`...mistral.model`	`voxtral-mini-transcribe-realtime-2602`
Kodowanie	`...mistral.encoding`	`pcm_mulaw`
Częstotliwość próbkowania	`...mistral.sampleRate`	`8000`
Docelowe opóźnienie	`...mistral.targetStreamingDelayMs`	`800`

{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}

OpenClaw domyślnie ustawia kodowanie STT Mistral w czasie rzeczywistym na pcm_mulaw przy 8 kHz, aby połączenia głosowe mogły bezpośrednio przekazywać ramki multimedialne Twilio. Użyj encoding: "pcm_s16le" i odpowiedniej wartości sampleRate tylko wtedy, gdy strumień źródłowy jest już surowym strumieniem PCM.

Konfiguracja zaawansowana

Adjustable reasoning

Modele mistral/mistral-small-latest, mistral/mistral-small-2603 i mistral/mistral-medium-3-5 obsługują regulowane rozumowanie w API Chat Completions za pomocą parametru reasoning_effort (none ogranicza dodatkowe rozumowanie w wyniku; high ujawnia pełny przebieg rozumowania przed odpowiedzią końcową).OpenClaw odwzorowuje poziom rozumowania sesji na API Mistral:

Poziom rozumowania OpenClaw	`reasoning_effort` Mistral
off / minimal	`none`
low / medium / high / xhigh / adaptive / max	`high`

Unikaj łączenia trybu rozumowania Medium 3.5 z temperature: 0; według zgłoszeń API HTTP Mistral odrzuca połączenie reasoning_effort="high" i temperature: 0 odpowiedzią 400. Nie ustawiaj temperatury albo wyłącz rozumowanie bądź ustaw je na poziom minimalny, aby OpenClaw wysyłał reasoning_effort: "none" przed ustawieniem niskiej temperatury.

Przykładowa konfiguracja rozumowania dla modelu Medium 3.5:

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

Pozostałe modele z dołączonego katalogu Mistral nie używają tego parametru. Jeśli zależy Ci na natywnym zachowaniu Mistral stawiającym rozumowanie na pierwszym miejscu, nadal używaj modeli magistral-*.

Memory embeddings

Mistral może udostępniać osadzanie pamięci za pośrednictwem /v1/embeddings (model domyślny: mistral-embed):

{
  agents: {
    defaults: {
      memorySearch: { provider: "mistral" },
    },
  },
}

Auth and base URL

Uwierzytelnianie Mistral używa MISTRAL_API_KEY (nagłówek Bearer).
Bazowy adres URL dostawcy ma domyślną wartość https://api.mistral.ai/v1 i przyjmuje standardowy format żądania uzupełniania czatu zgodny z OpenAI.
Domyślnym modelem podczas wdrażania jest mistral/mistral-large-latest.
Zastępuj bazowy adres URL w models.providers.mistral.baseUrl tylko wtedy, gdy Mistral wyraźnie opublikuje potrzebny Ci regionalny punkt końcowy.

Overview

Concepts and configuration

Providers

Pierwsze kroki

Wbudowany katalog modeli LLM

Transkrypcja dźwięku (Voxtral)

Strumieniowe STT dla połączeń głosowych

Konfiguracja zaawansowana

Powiązane materiały

Model selection

Media understanding

​Pierwsze kroki

​Wbudowany katalog modeli LLM

​Transkrypcja dźwięku (Voxtral)

​Strumieniowe STT dla połączeń głosowych

​Konfiguracja zaawansowana

​Powiązane materiały

Model selection

Media understanding

Pierwsze kroki

Wbudowany katalog modeli LLM

Transkrypcja dźwięku (Voxtral)

Strumieniowe STT dla połączeń głosowych

Konfiguracja zaawansowana

Powiązane materiały