Mistral

OpenClaw, dört sözleşme kaydeden paketle gelen bir Mistral Plugin’i içerir: sohbet tamamlama, medya anlama (Voxtral toplu transkripsiyon), Voice Call için gerçek zamanlı STT (Voxtral Realtime) ve bellek embedding’leri (mistral-embed).

Özellik	Değer
Sağlayıcı kimliği	`mistral`
Plugin	paketle gelen, `enabledByDefault: true`
Kimlik doğrulama env var’ı	`MISTRAL_API_KEY`
Onboarding 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`
Embedding 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.

Onboarding'i çalıştırın

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

Veya anahtarı doğrudan geçirin:

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

Varsayılan 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

Mistral Medium 3.5 paketle gelen katalogdaki güncel harmanlanmış Medium modelidir: 128B yoğun ağırlık, metin ve görüntü girişi, 256K bağlam, işlev çağırma, yapılandırılmış çıktı, kodlama ve Chat Completions API üzerinden ayarlanabilir akıl yürütme. Varsayılan mistral/mistral-large-latest yerine Mistral’ın daha yeni birleşik ajan/kodlama modelini istediğinizde mistral/mistral-medium-3-5 kullanın. OpenClaw şu anda bu paketle gelen Mistral kataloğunu sağlar:

Model ref	Giriş	Bağlam	Maks. çı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ü	128,000	16,384	Mistral Small 4; API `reasoning_effort` üzerinden ayarlanabilir akıl yürütme
`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

Onboarding’den sonra, Gateway’i başlatmadan Medium 3.5’i smoke test edin:

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

Yapılandırmayı değiştirmeden önce paketle gelen katalog satırına göz atmak için:

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

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’tir.

Voice Call akış STT’si

Paketle 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’ın Twilio medya karelerini doğrudan iletebilmesi için Mistral gerçek zamanlı STT’yi 8 kHz’de pcm_mulaw olarak varsayılan yapar. encoding: "pcm_s16le" ve eşleşen bir sampleRate değerini yalnızca yukarı akışınız zaten ham PCM ise kullanın.

Gelişmiş yapılandırma

Ayarlanabilir akıl yürütme

mistral/mistral-small-latest (Mistral Small 4) ve mistral/mistral-medium-3-5, Chat Completions API üzerinde reasoning_effort aracılığıyla ayarlanabilir akıl yürütmeyi destekler (none, çıktıda ekstra düşünmeyi en aza indirir; high, son yanıttan önce tam düşünme izlerini gösterir). Mistral, Medium 3.5 ajan ve kod kullanım durumları için reasoning_effort="high" önerir.OpenClaw, oturum thinking düzeyini Mistral’ın API’sine eşler:

OpenClaw thinking düzeyi	Mistral `reasoning_effort`
off / minimal	`none`
low / medium / high / xhigh / adaptive / max	`high`

Medium 3.5 akıl yürütme modunu temperature: 0 ile birleştirmeyin. Mistral HTTP API, reasoning_effort="high" ile temperature: 0 birleşimini 400 yanıtıyla reddeder. Mistral’ın varsayılanını kullanması için sıcaklığı ayarlanmamış bırakın veya Medium 3.5 önerilen ayarlarını izleyip yüksek akıl yürütme için temperature: 0.7 kullanın. Belirleyici doğrudan yanıtlar için, sıcaklığı düşürmeden önce thinking’i kapatın/minimal yapın; böylece OpenClaw reasoning_effort: "none" gönderir.

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

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

Paketle 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 embedding'leri

Mistral, /v1/embeddings üzerinden bellek embedding’leri sunabilir (varsayılan model: mistral-embed).

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

Kimlik doğrulama ve temel URL

Mistral kimlik doğrulaması MISTRAL_API_KEY kullanır (Bearer başlığı).
Sağlayıcı temel URL’si varsayılan olarak https://api.mistral.ai/v1 değerine ayarlanır ve standart OpenAI uyumlu chat-completions istek şeklini kabul eder.
Onboarding varsayılan modeli mistral/mistral-large-latest’tir.
Temel URL’yi models.providers.mistral.baseUrl altında yalnızca Mistral ihtiyacınız olan bölgesel bir uç noktayı açıkça yayımladığında geçersiz kılın.

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

Overview

Concepts and configuration

Providers

Documentation Index

​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