Providers
Mistral
Plugin همراه mistral چهار قرارداد را ثبت میکند: تکمیلهای چت، درک رسانه (رونویسی دستهای Voxtral)، تبدیل بلادرنگ گفتار به متن برای تماس صوتی (Voxtral Realtime)، و تعبیههای حافظه (mistral-embed).
| ویژگی | مقدار |
|---|---|
| شناسه ارائهدهنده | mistral |
| Plugin | همراه، بهطور پیشفرض فعال |
| متغیر محیطی احراز هویت | MISTRAL_API_KEY |
| پرچم راهاندازی اولیه | --auth-choice mistral-api-key |
| پرچم مستقیم CLI | --mistral-api-key <key> |
| API | سازگار با OpenAI (openai-completions) |
| نشانی پایه | https://api.mistral.ai/v1 |
| مدل پیشفرض | mistral/mistral-large-latest |
| مدل تعبیهسازی | mistral-embed |
| پردازش دستهای Voxtral | voxtral-mini-latest (رونویسی صوت) |
| بلادرنگ Voxtral | voxtral-mini-transcribe-realtime-2602 |
شروع به کار
دریافت کلید API
یک کلید API در کنسول Mistral ایجاد کنید.
اجرای راهاندازی اولیه
openclaw onboard --auth-choice mistral-api-keyیا کلید را مستقیماً ارسال کنید:
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"تنظیم مدل پیشفرض
{ env: { MISTRAL_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },}بررسی در دسترس بودن مدل
openclaw models list --provider 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 |
متن، تصویر | 262,144 | 16,384 | جدیدترین Mistral Small 4؛ reasoning_effort قابل تنظیم |
mistral/mistral-small-2603 |
متن، تصویر | 262,144 | 16,384 | نسخه ثابت Mistral Small 4؛ 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 | دارای قابلیت استدلال |
پیش از تغییر پیکربندی، ردیف کاتالوگ همراه را مرور کنید:
openclaw models list --all --provider mistral --plainبدون راهاندازی Gateway، یک آزمون سریع روی مدل اجرا کنید:
openclaw infer model run --local \ --model mistral/mistral-medium-3-5 \ --prompt "Reply with exactly: mistral-ok" \ --jsonرونویسی صوت (Voxtral)
برای رونویسی دستهای صوت از طریق خط لوله درک رسانه، از Voxtral استفاده کنید:
{ tools: { media: { audio: { enabled: true, models: [{ provider: "mistral", model: "voxtral-mini-latest" }], }, }, },}تبدیل جریانی گفتار به متن برای تماس صوتی
Plugin همراه mistral، Voxtral Realtime را بهعنوان ارائهدهنده تبدیل جریانی گفتار به متن برای تماس صوتی ثبت میکند.
| تنظیم | مسیر پیکربندی | پیشفرض |
|---|---|---|
| کلید 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 |
{ plugins: { entries: { "voice-call": { config: { streaming: { enabled: true, provider: "mistral", providers: { mistral: { apiKey: "${MISTRAL_API_KEY}", targetStreamingDelayMs: 800, }, }, }, }, }, }, },}پیکربندی پیشرفته
استدلال قابل تنظیم
مدلهای mistral/mistral-small-latest، mistral/mistral-small-2603 و mistral/mistral-medium-3-5 از استدلال قابل تنظیم در API تکمیلهای چت از طریق reasoning_effort پشتیبانی میکنند (none تفکر اضافه در خروجی را به حداقل میرساند؛ high رد کامل فرایند تفکر را پیش از پاسخ نهایی نمایش میدهد).
OpenClaw سطح تفکر نشست را به API متعلق به Mistral نگاشت میکند:
| سطح تفکر OpenClaw | reasoning_effort در Mistral |
|---|---|
| خاموش / حداقلی | none |
| کم / متوسط / زیاد / بسیار زیاد / تطبیقی / حداکثر | high |
نمونه پیکربندی مختص مدل برای استدلال Medium 3.5:
{ agents: { defaults: { model: { primary: "mistral/mistral-medium-3-5" }, models: { "mistral/mistral-medium-3-5": { params: { thinking: "high" }, }, }, }, },}تعبیههای حافظه
Mistral میتواند تعبیههای حافظه را از طریق /v1/embeddings ارائه کند (مدل پیشفرض: mistral-embed):
{ agents: { defaults: { memorySearch: { provider: "mistral" }, }, },}احراز هویت و نشانی پایه
- احراز هویت Mistral از
MISTRAL_API_KEYاستفاده میکند (سرآیند Bearer). - نشانی پایه ارائهدهنده بهطور پیشفرض
https://api.mistral.ai/v1است و قالب استاندارد درخواست تکمیل چت سازگار با OpenAI را میپذیرد. - مدل پیشفرض راهاندازی اولیه
mistral/mistral-large-latestاست. - نشانی پایه را در
models.providers.mistral.baseUrlفقط زمانی بازنویسی کنید که Mistral صراحتاً نقطه پایانی منطقهای مورد نیاز شما را منتشر کرده باشد.
