Mistral

Paketle birlikte gelen mistral Plugin’i dört sözleşme kaydeder: sohbet tamamlamaları, medya anlama (Voxtral toplu transkripsiyon), Voice Call için gerçek zamanlı STT (Voxtral Realtime) ve bellek gömmeleri (mistral-embed).

Özellik	Değer
Sağlayıcı kimliği	`mistral`
Plugin	paketle birlikte gelir, varsayılan olarak etkindir
Kimlik doğrulama ortam değişkeni	`MISTRAL_API_KEY`
İlk kurulum bayrağı	`--auth-choice mistral-api-key`
Doğrudan CLI bayrağı	`--mistral-api-key <key>`
API	OpenAI uyumlu (`openai-completions`)
Temel URL	`https://api.mistral.ai/v1`
Varsayılan model	`mistral/mistral-large-latest`
Gömme modeli	`mistral-embed`
Voxtral toplu	`voxtral-mini-latest` (ses transkripsiyonu)
Voxtral gerçek zamanlı	`voxtral-mini-transcribe-realtime-2602`

Başlarken

API anahtarınızı alın

Mistral Console içinde bir API anahtarı oluşturun.

İlk kurulumu çalıştırın

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

Alternatif olarak anahtarı doğrudan iletin:

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

Varsayılan bir model ayarlayın

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

Modelin kullanılabilir olduğunu doğrulayın

openclaw models list --provider mistral

Yerleşik LLM kataloğu

Model referansı	Girdi	Bağlam	Maksimum çıktı	Notlar
`mistral/mistral-large-latest`	metin, görüntü	262,144	16,384	Varsayılan model
`mistral/mistral-medium-2508`	metin, görüntü	262,144	8,192	Mistral Medium 3.1
`mistral/mistral-medium-3-5`	metin, görüntü	262,144	8,192	Mistral Medium 3.5; ayarlanabilir akıl yürütme
`mistral/mistral-small-latest`	metin, görüntü	262,144	16,384	En son Mistral Small 4; ayarlanabilir `reasoning_effort`
`mistral/mistral-small-2603`	metin, görüntü	262,144	16,384	Sabitlenmiş Mistral Small 4; ayarlanabilir `reasoning_effort`
`mistral/pixtral-large-latest`	metin, görüntü	128,000	32,768	Pixtral
`mistral/codestral-latest`	metin	256,000	4,096	Kodlama
`mistral/devstral-medium-latest`	metin	262,144	32,768	Devstral 2
`mistral/magistral-small`	metin	128,000	40,000	Akıl yürütme etkin

Yapılandırmayı değiştirmeden önce paketle birlikte gelen katalog satırına göz atın:

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

Gateway’i başlatmadan bir model için temel işlev testi gerçekleştirin:

openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Tam olarak şu yanıtı ver: mistral-ok" \
  --json

Ses transkripsiyonu (Voxtral)

Medya anlama işlem hattı üzerinden toplu ses transkripsiyonu için Voxtral’ı kullanın:

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

Medya transkripsiyonu yolu /v1/audio/transcriptions kullanır. Mistral için varsayılan ses modeli voxtral-mini-latest şeklindedir.

Voice Call akış STT’si

Paketle birlikte gelen mistral Plugin’i, Voxtral Realtime’ı bir Voice Call akış STT sağlayıcısı olarak kaydeder.

Ayar	Yapılandırma yolu	Varsayılan
API anahtarı	`plugins.entries.voice-call.config.streaming.providers.mistral.apiKey`	`MISTRAL_API_KEY` değerine geri döner
Model	`...mistral.model`	`voxtral-mini-transcribe-realtime-2602`
Kodlama	`...mistral.encoding`	`pcm_mulaw`
Örnekleme hızı	`...mistral.sampleRate`	`8000`
Hedef gecikme	`...mistral.targetStreamingDelayMs`	`800`

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

OpenClaw, Voice Call’un Twilio medya karelerini doğrudan iletebilmesi için Mistral gerçek zamanlı STT’yi varsayılan olarak 8 kHz’de pcm_mulaw değerine ayarlar. Yalnızca yukarı akışınız zaten ham PCM ise encoding: "pcm_s16le" ve eşleşen bir sampleRate kullanın.

Gelişmiş yapılandırma

Ayarlanabilir akıl yürütme

mistral/mistral-small-latest, mistral/mistral-small-2603 ve mistral/mistral-medium-3-5, Chat Completions API üzerinde reasoning_effort aracılığıyla ayarlanabilir akıl yürütmeyi destekler (none, çıktıdaki ek düşünmeyi en aza indirir; high, nihai yanıttan önce tüm düşünme izlerini gösterir).OpenClaw, oturumun düşünme düzeyini Mistral API’sine şu şekilde eşler:

OpenClaw düşünme düzeyi	Mistral `reasoning_effort`
kapalı / en az	`none`
düşük / orta / yüksek / çok yüksek / uyarlanabilir / maksimum	`high`

Medium 3.5 akıl yürütme modunu temperature: 0 ile birleştirmekten kaçının; Mistral HTTP API’nin reasoning_effort="high" ile temperature: 0 birleşimini 400 yanıtıyla reddettiği bildirilmiştir. Sıcaklığı ayarlamadan bırakın veya OpenClaw’ın düşük bir sıcaklık ayarlamadan önce reasoning_effort: "none" göndermesi için düşünmeyi kapatın/en aza indirin.

Medium 3.5 akıl yürütmesi için model kapsamlı örnek yapılandırma:

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

Paketle birlikte gelen diğer Mistral katalog modelleri bu parametreyi kullanmaz. Mistral’ın yerel, akıl yürütme öncelikli davranışını istediğinizde magistral-* modellerini kullanmaya devam edin.

Bellek gömmeleri

Mistral, /v1/embeddings aracılığıyla bellek gömmeleri sunabilir (varsayılan model: mistral-embed):

{
  memory: {
    search: { provider: "mistral" },
  },
}

Kimlik doğrulama ve temel URL

Mistral kimlik doğrulaması MISTRAL_API_KEY kullanır (Bearer üstbilgisi).
Sağlayıcının temel URL’si varsayılan olarak https://api.mistral.ai/v1 değerini kullanır ve standart OpenAI uyumlu sohbet tamamlamaları istek biçimini kabul eder.
İlk kurulumun varsayılan modeli mistral/mistral-large-latest şeklindedir.
Temel URL’yi models.providers.mistral.baseUrl altında yalnızca Mistral ihtiyaç duyduğunuz bölgesel bir uç noktayı açıkça yayımladığında geçersiz kılın.

İlgili

Model seçimi

Sağlayıcıları, model referanslarını ve yük devretme davranışını seçme.

Medya anlama

Ses transkripsiyonu kurulumu ve sağlayıcı seçimi.

Overview

Concepts and configuration

Providers

Başlarken

Yerleşik LLM kataloğu

Ses transkripsiyonu (Voxtral)

Voice Call akış STT’si

Gelişmiş yapılandırma

İlgili

Model seçimi

Medya anlama

​Başlarken

​Yerleşik LLM kataloğu

​Ses transkripsiyonu (Voxtral)

​Voice Call akış STT’si

​Gelişmiş yapılandırma

​İlgili

Model seçimi

Medya anlama

Başlarken

Yerleşik LLM kataloğu

Ses transkripsiyonu (Voxtral)

Voice Call akış STT’si

Gelişmiş yapılandırma

İlgili