OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Mistral

Paketle birlikte gelen mistral Plugin'i dört sözleşme kaydeder: sohbet tamamlama, 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 etkin
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

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

    Alternatif olarak anahtarı doğrudan iletin:

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

  • Varsayılan model ayarlayın

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

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

    bash
    openclaw models list --provider mistral

    • Yerleşik LLM kataloğu

    Model referansı Girdi Bağlam Azami çıktı Notlar
    mistral/mistral-large-latest metin, görsel 262,144 16,384 Varsayılan model
    mistral/mistral-medium-2508 metin, görsel 262,144 8,192 Mistral Medium 3.1
    mistral/mistral-medium-3-5 metin, görsel 262,144 8,192 Mistral Medium 3.5; ayarlanabilir akıl yürütme
    mistral/mistral-small-latest metin, görsel 262,144 16,384 En yeni Mistral Small 4; ayarlanabilir reasoning_effort
    mistral/mistral-small-2603 metin, görsel 262,144 16,384 Sabitlenmiş Mistral Small 4; ayarlanabilir reasoning_effort
    mistral/pixtral-large-latest metin, görsel 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ını görüntüleyin:

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

    Gateway'i başlatmadan bir modelin hızlı testini yapın:

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

    Ses transkripsiyonu (Voxtral)

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

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

    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
    json5
    {  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "mistral",            providers: {              mistral: {                apiKey: "${MISTRAL_API_KEY}",                targetStreamingDelayMs: 800,              },            },          },        },      },    },  },}

    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'sinde reasoning_effort aracılığıyla ayarlanabilir akıl yürütmeyi destekler (none, çıktıda ek düşünmeyi en aza indirir; high, nihai yanıttan önce tüm düşünme izlerini gösterir).

    OpenClaw, oturum düşünme düzeyini Mistral API'sine şu şekilde eşler:

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

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

    json5
    {  agents: {    defaults: {      model: { primary: "mistral/mistral-medium-3-5" },      models: {        "mistral/mistral-medium-3-5": {          params: { thinking: "high" },        },      },    },  },}
    Bellek gömmeleri

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

    json5
    {  agents: {    defaults: {      memorySearch: { 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ğeridir ve standart OpenAI uyumlu sohbet tamamlama istek biçimini kabul eder.
    • İlk kurulumun varsayılan modeli mistral/mistral-large-latest modelidir.
    • models.providers.mistral.baseUrl altındaki temel URL'yi 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.
    Was this useful?
    On this page

    On this page