OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

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)
عنوان 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.

  • شغّل الإعداد الأولي

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

    أو مرّر المفتاح مباشرةً:

    bash
    openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"

  • عيّن نموذجًا افتراضيًا

    json5
    {  env: { MISTRAL_API_KEY: "sk-..." },  agents: { defaults: { model: { primary: "mistral/mistral-large-latest" } } },}

  • تحقق من توفر النموذج

    bash
    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 يدعم الاستدلال

    استعرض صف الكتالوج المضمّن قبل تغيير الإعدادات:

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

    نفّذ اختبارًا أوليًا لنموذج من دون تشغيل Gateway:

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

    نسخ الصوت (Voxtral)

    استخدم Voxtral لنسخ الصوت بالدُفعات عبر مسار فهم الوسائط:

    json5
    {  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
    json5
    {  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:

    json5
    {  agents: {    defaults: {      model: { primary: "mistral/mistral-medium-3-5" },      models: {        "mistral/mistral-medium-3-5": {          params: { thinking: "high" },        },      },    },  },}
    تضمينات الذاكرة

    يمكن لـ Mistral توفير تضمينات الذاكرة عبر /v1/embeddings (النموذج الافتراضي: mistral-embed):

    json5
    {  agents: {    defaults: {      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 صراحةً نقطة نهاية إقليمية تحتاج إليها.

    ذو صلة

    اختيار النموذج

    اختيار المزوّدين ومراجع النماذج وسلوك تجاوز الفشل.
    فهم الوسائط

    إعداد نسخ الصوت واختيار المزوّد.
    Was this useful?
    On this page

    On this page