Providers
Mistral
يتضمن OpenClaw Plugin Mistral مضمّنة تسجّل أربعة عقود: إكمالات المحادثة، وفهم الوسائط (نسخ Voxtral الدفعي)، وSTT الفوري لمكالمة صوتية (Voxtral Realtime)، وتضمينات الذاكرة (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 |
| نموذج التضمين | 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 ويدعم التفكير القابل للضبط على API إكمالات المحادثة عبر reasoning_effort (none يقلل التفكير الإضافي في الإخراج إلى الحد الأدنى؛ ويعرض high آثار التفكير الكاملة قبل الإجابة النهائية).
يربط OpenClaw مستوى التفكير في الجلسة بـ API الخاص بـ Mistral:
| مستوى التفكير في OpenClaw | reasoning_effort في Mistral |
|---|---|
| متوقف / أدنى حد | none |
| منخفض / متوسط / مرتفع / xhigh / تكيفي / أقصى | high |
تضمينات الذاكرة
يمكن لـ Mistral تقديم تضمينات الذاكرة عبر /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 صراحةً نقطة نهاية إقليمية تحتاج إليها.