English简体中文繁體中文日本語EspañolPortuguês (BR)한국어DeutschFrançaisالعربيةItalianoTiếng ViệtNederlandsTürkçeУкраїнськаBahasa IndonesiaPolskiفارسیไทย

Providers

Mistral

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

Properti Nilai
ID penyedia mistral
Plugin bawaan, enabledByDefault: true
Variabel env auth MISTRAL_API_KEY
Flag onboarding --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 onboarding

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

    Atau berikan kunci secara langsung:

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

  • Atur model default

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

  • Verifikasi model tersedia

    openclaw models list --provider mistral

    • Katalog LLM bawaan

    OpenClaw saat ini mengirimkan katalog Mistral bawaan ini:

    Referensi model Input Konteks Output 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-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

    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" }],
      },
    },
  },
}

    STT streaming Panggilan Suara

    Plugin mistral bawaan mendaftarkan Voxtral Realtime sebagai penyedia STT streaming Panggilan Suara.

    Pengaturan Jalur konfigurasi Default
    Kunci API plugins.entries.voice-call.config.streaming.providers.mistral.apiKey Beralih ke MISTRAL_API_KEY jika tidak ada
    Model ...mistral.model voxtral-mini-transcribe-realtime-2602
    Encoding ...mistral.encoding pcm_mulaw
    Laju sampel ...mistral.sampleRate 8000
    Delay target ...mistral.targetStreamingDelayMs 800 
    {
  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-small-latest)

    mistral/mistral-small-latest dipetakan ke Mistral Small 4 dan mendukung penalaran yang dapat disesuaikan pada API Chat Completions melalui reasoning_effort (none meminimalkan pemikiran tambahan dalam output; high menampilkan jejak pemikiran penuh sebelum jawaban akhir).

    OpenClaw memetakan level thinking sesi ke API Mistral:

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

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

    {
  memorySearch: { provider: "mistral" },
}
    Auth dan URL dasar
    • Auth Mistral menggunakan MISTRAL_API_KEY (header Bearer).
    • URL dasar penyedia default ke https://api.mistral.ai/v1 dan menerima bentuk permintaan chat-completions standar yang kompatibel dengan OpenAI.
    • Model default onboarding adalah mistral/mistral-large-latest.
    • Timpa URL dasar di bawah models.providers.mistral.baseUrl hanya saat 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.