الانتقال إلى المحتوى الرئيسي

Mistral

يدعم OpenClaw Mistral لكلٍّ من توجيه نماذج النص/الصور (mistral/...) ونسخ الصوت عبر Voxtral ضمن media understanding. كما يمكن استخدام Mistral لتضمينات الذاكرة (memorySearch.provider = "mistral").
  • الموفّر: mistral
  • المصادقة: MISTRAL_API_KEY
  • API: ‏Mistral Chat Completions (https://api.mistral.ai/v1)

البدء

1

Get your API key

أنشئ مفتاح API في Mistral Console.
2

Run onboarding

openclaw onboard --auth-choice mistral-api-key
أو مرّر المفتاح مباشرةً:
openclaw onboard --mistral-api-key "$MISTRAL_API_KEY"
3

Set a default model

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

Verify the model is available

openclaw models list --provider mistral

فهرس LLM المضمّن

يشحن OpenClaw حاليًا فهرس Mistral المضمّن التالي:
مرجع النموذجالإدخالالسياقالحد الأقصى للإخراجملاحظات
mistral/mistral-large-latestنص، صورة262,14416,384النموذج الافتراضي
mistral/mistral-medium-2508نص، صورة262,1448,192Mistral Medium 3.1
mistral/mistral-small-latestنص، صورة128,00016,384Mistral Small 4؛ استدلال قابل للضبط عبر API reasoning_effort
mistral/pixtral-large-latestنص، صورة128,00032,768Pixtral
mistral/codestral-latestنص256,0004,096للبرمجة
mistral/devstral-medium-latestنص262,14432,768Devstral 2
mistral/magistral-smallنص128,00040,000مع تمكين الاستدلال

نسخ الصوت إلى نص (Voxtral)

استخدم Voxtral لنسخ الصوت إلى نص عبر مسار media understanding.
{
  tools: {
    media: {
      audio: {
        enabled: true,
        models: [{ provider: "mistral", model: "voxtral-mini-latest" }],
      },
    },
  },
}
يستخدم مسار نسخ الوسائط نقطة النهاية /v1/audio/transcriptions. والنموذج الصوتي الافتراضي لـ Mistral هو voxtral-mini-latest.

إعداد متقدم

يشير mistral/mistral-small-latest إلى Mistral Small 4 ويدعم الاستدلال القابل للضبط على Chat Completions API عبر reasoning_effort (none يقلل التفكير الإضافي في المخرجات إلى الحد الأدنى؛ وhigh يُظهر آثار التفكير الكاملة قبل الإجابة النهائية).يربط OpenClaw مستوى thinking في الجلسة بواجهة API الخاصة بـ Mistral:
مستوى thinking في OpenClawreasoning_effort في Mistral
off / minimalnone
low / medium / high / xhigh / adaptivehigh
لا تستخدم نماذج فهرس Mistral المضمّنة الأخرى هذا المعامل. استمر في استخدام نماذج magistral-* عندما تريد سلوك Mistral الأصلي القائم على الاستدلال أولًا.
يمكن لـ Mistral تقديم تضمينات الذاكرة عبر /v1/embeddings (النموذج الافتراضي: mistral-embed).
{
  memorySearch: { provider: "mistral" },
}
  • تستخدم مصادقة Mistral المتغير MISTRAL_API_KEY.
  • تكون قيمة Base URL الافتراضية للموفّر هي https://api.mistral.ai/v1.
  • النموذج الافتراضي في onboarding هو mistral/mistral-large-latest.
  • تستخدم Z.AI مصادقة Bearer مع مفتاح API الخاص بك.

ذو صلة

Model selection

اختيار الموفّرات، ومراجع النماذج، وسلوك التبديل الاحتياطي.

Media understanding

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