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کاتالوگ داخلی LLM
| مرجع مدل | ورودی | زمینه | حداکثر خروجی | توضیحات |
|---|---|---|---|---|
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 "دقیقاً با این عبارت پاسخ دهید: 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 از طریق reasoning_effort از استدلال قابل تنظیم در API تکمیلهای چت پشتیبانی میکنند (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):
{ memory: { search: { provider: "mistral" }, },}احراز هویت و نشانی پایه
- احراز هویت Mistral از
MISTRAL_API_KEY(سرآیند Bearer) استفاده میکند. - نشانی پایه ارائهدهنده بهطور پیشفرض
https://api.mistral.ai/v1است و قالب استاندارد درخواست تکمیل چت سازگار با OpenAI را میپذیرد. - مدل پیشفرض راهاندازی اولیه
mistral/mistral-large-latestاست. - تنها زمانی نشانی پایه را در
models.providers.mistral.baseUrlبازنویسی کنید که Mistral صراحتاً نقطه پایانی منطقهای مورد نیازتان را منتشر کرده باشد.
