Langsung ke konten utama

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 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).
PropertiNilai
ID penyediamistral
Pluginbawaan, enabledByDefault: true
Variabel env autentikasiMISTRAL_API_KEY
Flag penyiapan awal--auth-choice mistral-api-key
Flag CLI langsung--mistral-api-key <key>
APIkompatibel dengan OpenAI (openai-completions)
URL dasarhttps://api.mistral.ai/v1
Model defaultmistral/mistral-large-latest
Model embeddingmistral-embed
Batch Voxtralvoxtral-mini-latest (transkripsi audio)
Realtime Voxtralvoxtral-mini-transcribe-realtime-2602

​
Memulai

1

Dapatkan kunci API Anda

Buat kunci API di Mistral Console.
2

Jalankan penyiapan awal

openclaw onboard --auth-choice mistral-api-key
Atau teruskan kuncinya secara langsung:
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
3

Tetapkan model default

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

Verifikasi model tersedia

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 modelInputKonteksKeluaran maksCatatan
mistral/mistral-large-latestteks, gambar262,14416,384Model default
mistral/mistral-medium-2508teks, gambar262,1448,192Mistral Medium 3.1
mistral/mistral-medium-3-5teks, gambar262,1448,192Mistral Medium 3.5; penalaran yang dapat disesuaikan
mistral/mistral-small-latestteks, gambar128,00016,384Mistral Small 4; penalaran yang dapat disesuaikan melalui API reasoning_effort
mistral/pixtral-large-latestteks, gambar128,00032,768Pixtral
mistral/codestral-latestteks256,0004,096Pengodean
mistral/devstral-medium-latestteks262,14432,768Devstral 2
mistral/magistral-smallteks128,00040,000Mendukung penalaran
Setelah penyiapan awal, uji cepat Medium 3.5 tanpa memulai Gateway: 
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: 
openclaw models list --all --provider mistral --plain

​
Transkripsi audio (Voxtral)

Gunakan Voxtral untuk transkripsi audio batch melalui pipeline pemahaman media. 
{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
      },
    },
  },
}
Jalur transkripsi media menggunakan /v1/audio/transcriptions. Model audio default untuk Mistral adalah voxtral-mini-latest.

​
STT streaming Voice Call

Plugin mistral bawaan mendaftarkan Voxtral Realtime sebagai penyedia STT streaming Voice Call.
PengaturanJalur konfigurasiDefault
Kunci APIplugins.entries.voice-call.config.streaming.providers.mistral.apiKeyKembali ke MISTRAL_API_KEY
Model...mistral.modelvoxtral-mini-transcribe-realtime-2602
Encoding...mistral.encodingpcm_mulaw
Laju sampel...mistral.sampleRate8000
Penundaan target...mistral.targetStreamingDelayMs800
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}
OpenClaw menetapkan default STT realtime Mistral ke pcm_mulaw pada 8 kHz agar Voice Call dapat meneruskan frame media Twilio secara langsung. Gunakan encoding: "pcm_s16le" dan sampleRate yang cocok hanya jika stream upstream Anda sudah berupa PCM mentah.

​
Konfigurasi lanjutan

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 OpenClawreasoning_effort Mistral
off / minimalnone
low / medium / high / xhigh / adaptive / maxhigh
Jangan gabungkan mode penalaran Medium 3.5 dengan temperature: 0. API HTTP Mistral menolak reasoning_effort="high" plus temperature: 0 dengan respons 400. Biarkan temperature tidak disetel agar Mistral menggunakan defaultnya, atau ikuti pengaturan yang direkomendasikan Medium 3.5 dan gunakan temperature: 0.7 untuk penalaran tinggi. Untuk jawaban langsung deterministik, matikan/minimalkan thinking agar OpenClaw mengirim reasoning_effort: "none" sebelum Anda menurunkan temperature.
Contoh konfigurasi dalam cakupan model untuk penalaran Medium 3.5:
{
  agents: {
    defaults: {
      model: { primary: "mistral/mistral-medium-3-5" },
      models: {
        "mistral/mistral-medium-3-5": {
          params: { thinking: "high" },
        },
      },
    },
  },
}
Model katalog Mistral bawaan lainnya tidak menggunakan parameter ini. Tetap gunakan model magistral-* saat Anda menginginkan perilaku native Mistral yang mengutamakan penalaran.
Mistral dapat menyajikan embedding memori melalui /v1/embeddings (model default: mistral-embed).
{
  memorySearch: { provider: "mistral" },
}
  • 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.