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.

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

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" }],
      },
    },
  },
}

يستخدم مسار نسخ الوسائط /v1/audio/transcriptions. نموذج الصوت الافتراضي لـ Mistral هو 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,
              },
            },
          },
        },
      },
    },
  },
}

يضبط OpenClaw افتراضيًا التحويل الفوري للكلام إلى نص من Mistral على pcm_mulaw بمعدل 8 كيلوهرتز، كي تتمكن مكالمات الصوت من تمرير إطارات وسائط Twilio مباشرةً. استخدم encoding: "pcm_s16le" وقيمة sampleRate مطابقة فقط إذا كان التدفق الوارد لديك بتنسيق PCM خام بالفعل.

الإعداد المتقدم

الاستدلال القابل للضبط

تدعم النماذج 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 وtemperature: 0؛ فقد أُبلغ أن واجهة HTTP API الخاصة بـ Mistral ترفض الجمع بين reasoning_effort="high" وtemperature: 0 باستجابة 400. اترك درجة الحرارة دون تعيين، أو عطّل التفكير أو اضبطه على أدنى حد كي يرسل OpenClaw القيمة reasoning_effort: "none" قبل تعيين درجة حرارة منخفضة.

مثال على إعداد خاص بالنموذج لاستدلال Medium 3.5:

{
  agents: {
    defaults: {
      model: { primary: "mistral/mistral-medium-3-5" },
      models: {
        "mistral/mistral-medium-3-5": {
          params: { thinking: "high" },
        },
      },
    },
  },
}

لا تستخدم نماذج كتالوج Mistral المضمّنة الأخرى هذا المَعْلَم. واصل استخدام نماذج magistral-* عندما تريد سلوك Mistral الأصلي الذي يعطي الأولوية للاستدلال.

تضمينات الذاكرة

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

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

ذو صلة

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

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

فهم الوسائط

إعداد نسخ الصوت واختيار المزوّد.

Overview

Concepts and configuration

Providers

البدء

كتالوج نماذج اللغة الكبيرة المضمّن

نسخ الصوت (Voxtral)

التحويل المتدفق للكلام إلى نص لمكالمات الصوت

الإعداد المتقدم

ذو صلة

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

فهم الوسائط

​البدء

​كتالوج نماذج اللغة الكبيرة المضمّن

​نسخ الصوت (Voxtral)

​التحويل المتدفق للكلام إلى نص لمكالمات الصوت

​الإعداد المتقدم

​ذو صلة

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

فهم الوسائط

البدء

كتالوج نماذج اللغة الكبيرة المضمّن

نسخ الصوت (Voxtral)

التحويل المتدفق للكلام إلى نص لمكالمات الصوت

الإعداد المتقدم

ذو صلة