Providers

Mistral

OpenClaw menyertakan Plugin Mistral bawaan yang mendaftarkan empat kontrak: penyelesaian chat, pemahaman media (transkripsi batch Voxtral), STT realtime untuk Voice Call (Voxtral Realtime), dan embedding memori (mistral-embed).

Properti	Nilai
ID penyedia	`mistral`
Plugin	bawaan, `enabledByDefault: true`
Variabel env autentikasi	`MISTRAL_API_KEY`
Flag penyiapan awal	`--auth-choice mistral-api-key`
Flag CLI langsung	`--mistral-api-key <key>`
API	kompatibel dengan OpenAI (`openai-completions`)
URL dasar	`https://api.mistral.ai/v1`
Model default	`mistral/mistral-large-latest`
Model embedding	`mistral-embed`
Batch Voxtral	`voxtral-mini-latest` (transkripsi audio)
Realtime Voxtral	`voxtral-mini-transcribe-realtime-2602`

Memulai

Dapatkan kunci API Anda

Buat kunci API di Mistral Console.

Jalankan penyiapan awal

bash

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

Atau teruskan kuncinya secara langsung:

bash

openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"

Tetapkan model default

json5

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

Verifikasi model tersedia

bash

openclaw models list --provider mistral

Katalog LLM bawaan

Mistral Medium 3.5 adalah model Medium campuran saat ini dalam katalog bawaan: bobot padat 128B, input teks dan gambar, konteks 256K, pemanggilan fungsi, keluaran terstruktur, pengodean, dan penalaran yang dapat disesuaikan melalui API Chat Completions. Gunakan mistral/mistral-medium-3-5 saat Anda menginginkan model agentik/pengodean terpadu Mistral yang lebih baru, bukan default mistral/mistral-large-latest.

OpenClaw saat ini mengirimkan katalog Mistral bawaan ini:

Referensi model	Input	Konteks	Keluaran maks	Catatan
`mistral/mistral-large-latest`	teks, gambar	262,144	16,384	Model default
`mistral/mistral-medium-2508`	teks, gambar	262,144	8,192	Mistral Medium 3.1
`mistral/mistral-medium-3-5`	teks, gambar	262,144	8,192	Mistral Medium 3.5; penalaran yang dapat disesuaikan
`mistral/mistral-small-latest`	teks, gambar	128,000	16,384	Mistral Small 4; penalaran yang dapat disesuaikan melalui API `reasoning_effort`
`mistral/pixtral-large-latest`	teks, gambar	128,000	32,768	Pixtral
`mistral/codestral-latest`	teks	256,000	4,096	Pengodean
`mistral/devstral-medium-latest`	teks	262,144	32,768	Devstral 2
`mistral/magistral-small`	teks	128,000	40,000	Mendukung penalaran

Setelah penyiapan awal, uji cepat Medium 3.5 tanpa memulai Gateway:

bash

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

Untuk menelusuri baris katalog bawaan sebelum mengubah konfigurasi:

bash

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

Transkripsi audio (Voxtral)

Gunakan Voxtral untuk transkripsi audio batch melalui pipeline pemahaman media.

json5

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

STT streaming Voice Call

Plugin mistral bawaan mendaftarkan Voxtral Realtime sebagai penyedia STT streaming Voice Call.

Pengaturan	Jalur konfigurasi	Default
Kunci API	`plugins.entries.voice-call.config.streaming.providers.mistral.apiKey`	Kembali ke `MISTRAL_API_KEY`
Model	`...mistral.model`	`voxtral-mini-transcribe-realtime-2602`
Encoding	`...mistral.encoding`	`pcm_mulaw`
Laju sampel	`...mistral.sampleRate`	`8000`
Penundaan target	`...mistral.targetStreamingDelayMs`	`800`

json5

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

Konfigurasi lanjutan

Penalaran yang dapat disesuaikan

mistral/mistral-small-latest (Mistral Small 4) dan mistral/mistral-medium-3-5 mendukung penalaran yang dapat disesuaikan pada API Chat Completions melalui reasoning_effort (none meminimalkan pemikiran tambahan dalam keluaran; high menampilkan jejak pemikiran penuh sebelum jawaban akhir). Mistral merekomendasikan reasoning_effort="high" untuk kasus penggunaan agentik dan kode Medium 3.5.

OpenClaw memetakan level thinking sesi ke API Mistral:

Level thinking OpenClaw	`reasoning_effort` Mistral
off / minimal	`none`
low / medium / high / xhigh / adaptive / max	`high`

Contoh konfigurasi dalam cakupan model untuk penalaran Medium 3.5:

json5

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

Embedding memori

Mistral dapat menyajikan embedding memori melalui /v1/embeddings (model default: mistral-embed).

json5

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

Autentikasi dan URL dasar

Autentikasi Mistral menggunakan MISTRAL_API_KEY (header Bearer).
URL dasar penyedia ditetapkan default ke https://api.mistral.ai/v1 dan menerima bentuk permintaan chat-completions standar yang kompatibel dengan OpenAI.
Model default penyiapan awal adalah mistral/mistral-large-latest.
Timpa URL dasar di bawah models.providers.mistral.baseUrl hanya ketika Mistral secara eksplisit menerbitkan endpoint regional yang Anda perlukan.

Terkait

Pemilihan model

Memilih penyedia, referensi model, dan perilaku failover.

Pemahaman media

Penyiapan transkripsi audio dan pemilihan penyedia.

Was this useful?