Providers
Mistral
OpenClaw شامل یک Plugin بستهبندیشدهی Mistral است که چهار قرارداد را ثبت میکند: تکمیلهای چت، درک رسانه (رونویسی دستهای Voxtral)، STT بیدرنگ برای تماس صوتی (Voxtral Realtime)، و embeddingهای حافظه (mistral-embed).
| ویژگی | مقدار |
|---|---|
| شناسهی ارائهدهنده | mistral |
| Plugin | بستهبندیشده، enabledByDefault: true |
| متغیر env احراز هویت | 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 خود را دریافت کنید
یک کلید 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 داخلی
OpenClaw در حال حاضر این کاتالوگ بستهبندیشدهی Mistral را ارائه میکند:
| ارجاع مدل | ورودی | زمینه | بیشینه خروجی | نکات |
|---|---|---|---|---|
mistral/mistral-large-latest |
متن، تصویر | 262,144 | 16,384 | مدل پیشفرض |
mistral/mistral-medium-2508 |
متن، تصویر | 262,144 | 8,192 | Mistral Medium 3.1 |
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 | با قابلیت استدلال |
رونویسی صوتی (Voxtral)
برای رونویسی دستهای صوتی از طریق خط لولهی درک رسانه، از Voxtral استفاده کنید.
{
tools: {
media: {
audio: {
enabled: true,
models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
},
},
},
}
STT جریانی تماس صوتی
Plugin بستهبندیشدهی mistral، Voxtral Realtime را بهعنوان ارائهدهندهی STT
جریانی تماس صوتی ثبت میکند.
| تنظیمات | مسیر پیکربندی | پیشفرض |
|---|---|---|
| کلید 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-small-latest)
mistral/mistral-small-latest به Mistral Small 4 نگاشت میشود و از استدلال قابل تنظیم روی Chat Completions API از طریق reasoning_effort پشتیبانی میکند (none تفکر اضافی در خروجی را به حداقل میرساند؛ high ردگیریهای کامل تفکر را پیش از پاسخ نهایی آشکار میکند).
OpenClaw سطح thinking نشست را به API Mistral نگاشت میکند:
| سطح thinking در OpenClaw | reasoning_effort در Mistral |
|---|---|
| off / minimal | none |
| low / medium / high / xhigh / adaptive / max | high |
Embeddingهای حافظه
Mistral میتواند embeddingهای حافظه را از طریق /v1/embeddings ارائه کند (مدل پیشفرض: mistral-embed).
{
memorySearch: { provider: "mistral" },
}
احراز هویت و URL پایه
- احراز هویت Mistral از
MISTRAL_API_KEYاستفاده میکند (هدر Bearer). - URL پایهی ارائهدهنده بهصورت پیشفرض
https://api.mistral.ai/v1است و شکل درخواست استاندارد تکمیل چتِ سازگار با OpenAI را میپذیرد. - مدل پیشفرض راهاندازی اولیه
mistral/mistral-large-latestاست. - URL پایه را زیر
models.providers.mistral.baseUrlفقط زمانی بازنویسی کنید که Mistral بهصورت صریح یک endpoint منطقهای مورد نیاز شما را منتشر کرده باشد.