Providers

Mistral

OmeniaClaw شامل یک Plugin داخلی Mistral است که چهار قرارداد را ثبت می‌کند: تکمیل‌های چت، درک رسانه (رونویسی دسته‌ای Voxtral)، STT بلادرنگ برای Voice Call (Voxtral Realtime)، و embeddingهای حافظه (mistral-embed).

ویژگی مقدار
شناسه ارائه‌دهنده mistral
Plugin داخلی، enabledByDefault: true
متغیر محیطی احراز هویت MISTRAL_API_KEY
پرچم راه‌اندازی اولیه --auth-choice mistral-api-key
پرچم مستقیم CLI --mistral-api-key <key>
API سازگار با OpenAI (openai-completions)
URL پایه https://api.mistral.ai/v1
مدل پیش‌فرض mistral/mistral-large-latest
مدل embedding mistral-embed
دسته‌ای Voxtral voxtral-mini-latest (رونویسی صوت)
بلادرنگ Voxtral voxtral-mini-transcribe-realtime-2602

شروع به کار

  • کلید API خود را دریافت کنید

    در کنسول Mistral یک کلید API بسازید.

  • راه‌اندازی اولیه را اجرا کنید

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

    یا کلید را مستقیم ارسال کنید:

    bash
    OmeniaClaw onboard --mistral-api-key "$MISTRAL_API_KEY"
  • یک مدل پیش‌فرض تنظیم کنید

    json5
    {  env: { MISTRAL_API_KEY: "sk-..." },  agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },}
  • بررسی کنید که مدل در دسترس است

    bash
    OmeniaClaw models list --provider mistral
  • کاتالوگ داخلی LLM

    Mistral Medium 3.5 مدل Medium ترکیبی فعلی در کاتالوگ داخلی است: وزن‌های dense با 128B، ورودی متن و تصویر، زمینه 256K، فراخوانی تابع، خروجی ساختاریافته، کدنویسی، و استدلال قابل تنظیم از طریق Chat Completions API. وقتی مدل یکپارچه جدیدتر agentic/کدنویسی Mistral را به‌جای مدل پیش‌فرض mistral/mistral-large-latest می‌خواهید، از mistral/mistral-medium-3-5 استفاده کنید.

    OmeniaClaw در حال حاضر این کاتالوگ داخلی Mistral را ارائه می‌کند:

    ارجاع مدل ورودی زمینه حداکثر خروجی یادداشت‌ها
    mistral/mistral-large-latest متن، تصویر 262,144 16,384 مدل پیش‌فرض
    mistral/mistral-medium-2508 متن، تصویر 262,144 8,192 Mistral Medium 3.1
    mistral/mistral-medium-3-5 متن، تصویر 262,144 8,192 Mistral Medium 3.5؛ استدلال قابل تنظیم
    mistral/mistral-small-latest متن، تصویر 128,000 16,384 Mistral Small 4؛ استدلال قابل تنظیم از طریق API reasoning_effort
    mistral/pixtral-large-latest متن، تصویر 128,000 32,768 Pixtral
    mistral/codestral-latest متن 256,000 4,096 کدنویسی
    mistral/devstral-medium-latest متن 262,144 32,768 Devstral 2
    mistral/magistral-small متن 128,000 40,000 دارای قابلیت استدلال

    پس از راه‌اندازی اولیه، Medium 3.5 را بدون راه‌اندازی Gateway با یک smoke test بررسی کنید:

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

    برای مرور ردیف کاتالوگ داخلی پیش از تغییر پیکربندی:

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

    رونویسی صوت (Voxtral)

    برای رونویسی دسته‌ای صوت از طریق pipeline درک رسانه، از Voxtral استفاده کنید.

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

    STT جریانی Voice Call

    Plugin داخلی mistral، Voxtral Realtime را به‌عنوان ارائه‌دهنده STT جریانی برای Voice Call ثبت می‌کند.

    تنظیم مسیر پیکربندی پیش‌فرض
    کلید API plugins.entries.voice-call.config.streaming.providers.mistral.apiKey به MISTRAL_API_KEY بازمی‌گردد
    مدل ...mistral.model voxtral-mini-transcribe-realtime-2602
    کدگذاری ...mistral.encoding pcm_mulaw
    نرخ نمونه‌برداری ...mistral.sampleRate 8000
    تاخیر هدف ...mistral.targetStreamingDelayMs 800
    json5
    {  plugins: {    entries: {      "voice-call": {        config: {          streaming: {            enabled: true,            provider: "mistral",            providers: {              mistral: {                apiKey: "${MISTRAL_API_KEY}",                targetStreamingDelayMs: 800,              },            },          },        },      },    },  },}

    پیکربندی پیشرفته

    استدلال قابل تنظیم

    mistral/mistral-small-latest (Mistral Small 4) و mistral/mistral-medium-3-5 از استدلال قابل تنظیم در Chat Completions API از طریق reasoning_effort پشتیبانی می‌کنند (none تفکر اضافی در خروجی را به حداقل می‌رساند؛ high ردپاهای کامل تفکر را پیش از پاسخ نهایی نمایش می‌دهد). Mistral برای موارد استفاده agentic و کدنویسی در Medium 3.5، مقدار reasoning_effort="high" را توصیه می‌کند.

    OmeniaClaw سطح thinking نشست را به API Mistral نگاشت می‌کند:

    سطح thinking در OmeniaClaw reasoning_effort در Mistral
    off / minimal none
    low / medium / high / xhigh / adaptive / max high

    نمونه پیکربندی محدود به مدل برای استدلال Medium 3.5:

    json5
    {  agents: {    defaults: {      model: { primary: "mistral/mistral-medium-3-5" },      models: {        "mistral/mistral-medium-3-5": {          params: { thinking: "high" },        },      },    },  },}
    Embeddingهای حافظه

    Mistral می‌تواند embeddingهای حافظه را از طریق /v1/embeddings ارائه کند (مدل پیش‌فرض: mistral-embed).

    json5
    {  memorySearch: { provider: "mistral" },}
    احراز هویت و URL پایه
    • احراز هویت Mistral از MISTRAL_API_KEY استفاده می‌کند (سرآیند Bearer).
    • URL پایه ارائه‌دهنده به‌طور پیش‌فرض https://api.mistral.ai/v1 است و شکل استاندارد درخواست chat-completions سازگار با OpenAI را می‌پذیرد.
    • مدل پیش‌فرض راه‌اندازی اولیه mistral/mistral-large-latest است.
    • URL پایه را فقط زمانی در models.providers.mistral.baseUrl بازنویسی کنید که Mistral به‌صراحت یک endpoint منطقه‌ای موردنیاز شما را منتشر کرده باشد.

    مرتبط

    Was this useful?
    On this page

    On this page