Providers
Mistral
OpenClaw zawiera dołączony Plugin Mistral, który rejestruje cztery kontrakty: uzupełnienia czatu, rozumienie multimediów (wsadowa transkrypcja Voxtral), STT w czasie rzeczywistym dla Voice Call (Voxtral Realtime) oraz embeddingi pamięci (mistral-embed).
| Właściwość | Wartość |
|---|---|
| Identyfikator dostawcy | mistral |
| Plugin | dołączony, enabledByDefault: true |
| Zmienna env uwierzytelniania | MISTRAL_API_KEY |
| Flaga onboardingu | --auth-choice mistral-api-key |
| Bezpośrednia flaga CLI | --mistral-api-key <key> |
| API | zgodne z OpenAI (openai-completions) |
| Bazowy URL | https://api.mistral.ai/v1 |
| Domyślny model | mistral/mistral-large-latest |
| Model embeddingów | mistral-embed |
| Wsadowy Voxtral | voxtral-mini-latest (transkrypcja audio) |
| Voxtral w czasie rzeczywistym | voxtral-mini-transcribe-realtime-2602 |
Pierwsze kroki
Uzyskaj swój klucz API
Utwórz klucz API w konsoli Mistral.
Uruchom onboarding
openclaw onboard --auth-choice mistral-api-key
Albo przekaż klucz bezpośrednio:
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
Ustaw domyślny model
{
env: { MISTRAL_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },
}
Sprawdź, czy model jest dostępny
openclaw models list --provider mistral
Wbudowany katalog LLM
OpenClaw obecnie dostarcza ten dołączony katalog Mistral:
| Odwołanie do modelu | Wejście | Kontekst | Maks. wyjście | Uwagi |
|---|---|---|---|---|
mistral/mistral-large-latest |
tekst, obraz | 262,144 | 16,384 | Domyślny model |
mistral/mistral-medium-2508 |
tekst, obraz | 262,144 | 8,192 | Mistral Medium 3.1 |
mistral/mistral-small-latest |
tekst, obraz | 128,000 | 16,384 | Mistral Small 4; dostosowywalne rozumowanie przez API reasoning_effort |
mistral/pixtral-large-latest |
tekst, obraz | 128,000 | 32,768 | Pixtral |
mistral/codestral-latest |
tekst | 256,000 | 4,096 | Kodowanie |
mistral/devstral-medium-latest |
tekst | 262,144 | 32,768 | Devstral 2 |
mistral/magistral-small |
tekst | 128,000 | 40,000 | Z włączonym rozumowaniem |
Transkrypcja audio (Voxtral)
Użyj Voxtral do wsadowej transkrypcji audio przez potok rozumienia multimediów.
{
tools: {
media: {
audio: {
enabled: true,
models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
},
},
},
}
Strumieniowe STT Voice Call
Dołączony Plugin mistral rejestruje Voxtral Realtime jako dostawcę strumieniowego STT dla Voice Call.
| Ustawienie | Ścieżka konfiguracji | Domyślne |
|---|---|---|
| Klucz API | plugins.entries.voice-call.config.streaming.providers.mistral.apiKey |
Wraca do 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,
},
},
},
},
},
},
},
}
Konfiguracja zaawansowana
Dostosowywalne rozumowanie (mistral-small-latest)
mistral/mistral-small-latest mapuje się na Mistral Small 4 i obsługuje dostosowywalne rozumowanie w API Chat Completions przez reasoning_effort (none minimalizuje dodatkowe myślenie w wyniku; high ujawnia pełne ślady myślenia przed końcową odpowiedzią).
OpenClaw mapuje poziom thinking sesji na API Mistral:
| Poziom thinking OpenClaw | reasoning_effort Mistral |
|---|---|
| off / minimal | none |
| low / medium / high / xhigh / adaptive / max | high |
Embeddingi pamięci
Mistral może obsługiwać embeddingi pamięci przez /v1/embeddings (domyślny model: mistral-embed).
{
memorySearch: { provider: "mistral" },
}
Uwierzytelnianie i bazowy URL
- Uwierzytelnianie Mistral używa
MISTRAL_API_KEY(nagłówek Bearer). - Bazowy URL dostawcy domyślnie to
https://api.mistral.ai/v1i akceptuje standardowy, zgodny z OpenAI kształt żądania chat-completions. - Domyślny model onboardingu to
mistral/mistral-large-latest. - Nadpisuj bazowy URL w
models.providers.mistral.baseUrltylko wtedy, gdy Mistral wyraźnie opublikuje potrzebny Ci regionalny punkt końcowy.