OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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

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

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

    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

    • 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:

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

    Wykonaj test dymny modelu bez uruchamiania Gateway:

    bash
    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:

    json5
    {  tools: {    media: {      audio: {        enabled: true,        models: [{ provider: "mistral", model: "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
    json5
    {  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "mistral",            providers: {              mistral: {                apiKey: "${MISTRAL_API_KEY}",                targetStreamingDelayMs: 800,              },            },          },        },      },    },  },}

    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

    Przykładowa konfiguracja rozumowania dla modelu Medium 3.5:

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

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

    json5
    {  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.

    Powiązane materiały

    Model selection

    Wybieranie dostawców, odwołań do modeli i zachowania awaryjnego.
    Media understanding

    Konfiguracja transkrypcji dźwięku i wybór dostawcy.
    Was this useful?
    On this page

    On this page