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

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

OpenClaw يتضمّن Plugin Mistral مضمّنًا يسجّل أربعة عقود: إكمالات المحادثة، وفهم الوسائط (نسخ Voxtral الدفعي)، وSTT الفوري لـ Voice Call (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

​
البدء

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 المضمّن

Mistral Medium 3.5 هو نموذج Medium المدمج الحالي في الفهرس المضمّن: أوزان كثيفة بحجم 128B، وإدخال نصوص وصور، وسياق 256K، واستدعاء الدوال، وإخراج منظّم، وبرمجة، واستدلال قابل للضبط عبر Chat Completions API. استخدم mistral/mistral-medium-3-5 عندما تريد نموذج Mistral الأحدث الموحّد للاستخدامات الوكيلية/البرمجية بدلًا من النموذج الافتراضي mistral/mistral-large-latest. يشحن OpenClaw حاليًا فهرس Mistral المضمّن هذا:
مرجع النموذجالإدخالالسياقأقصى إخراجملاحظات
mistral/mistral-large-latestنص، صورة262,14416,384النموذج الافتراضي
mistral/mistral-medium-2508نص، صورة262,1448,192Mistral Medium 3.1
mistral/mistral-medium-3-5نص، صورة262,1448,192Mistral Medium 3.5؛ استدلال قابل للضبط
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مفعّل للاستدلال
بعد التهيئة، نفّذ اختبار دخان لـ Medium 3.5 من دون تشغيل Gateway: 
openclaw infer model run --local \
  --model mistral/mistral-medium-3-5 \
  --prompt "Reply with exactly: mistral-ok" \
  --json
لتصفّح صف الفهرس المضمّن قبل تغيير الإعدادات: 
openclaw models list --all --provider mistral --plain

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

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

​
STT المتدفق لـ Voice Call

يسجّل Plugin mistral المضمّن Voxtral Realtime كمزوّد STT متدفق لـ Voice Call.
الإعدادمسار الإعدادالافتراضي
مفتاح APIplugins.entries.voice-call.config.streaming.providers.mistral.apiKeyيرجع إلى MISTRAL_API_KEY
النموذج...mistral.modelvoxtral-mini-transcribe-realtime-2602
الترميز...mistral.encodingpcm_mulaw
معدل العينة...mistral.sampleRate8000
التأخير المستهدف...mistral.targetStreamingDelayMs800
{
  plugins: {
    entries: {
      "voice-call": {
        config: {
          streaming: {
            enabled: true,
            provider: "mistral",
            providers: {
              mistral: {
                apiKey: "${MISTRAL_API_KEY}",
                targetStreamingDelayMs: 800,
              },
            },
          },
        },
      },
    },
  },
}
يضبط OpenClaw افتراضيًا STT الفوري في Mistral على pcm_mulaw عند 8 kHz حتى تتمكن Voice Call من تمرير إطارات وسائط Twilio مباشرة. استخدم encoding: "pcm_s16le" و sampleRate مطابقًا فقط إذا كان التدفق المصدر لديك PCM خامًا بالفعل.

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

يدعم mistral/mistral-small-latest (Mistral Small 4) وmistral/mistral-medium-3-5 الاستدلال القابل للضبط على Chat Completions API عبر reasoning_effort (none يقلّل التفكير الإضافي في الإخراج؛ وhigh يعرض آثار التفكير الكاملة قبل الإجابة النهائية). توصي Mistral باستخدام reasoning_effort="high" لحالات استخدام Medium 3.5 الوكيلية والبرمجية.يربط OpenClaw مستوى thinking في الجلسة بـ API الخاص بـ Mistral:
مستوى التفكير في OpenClawreasoning_effort في Mistral
off / minimalnone
low / medium / high / xhigh / adaptive / maxhigh
لا تجمع وضع الاستدلال في Medium 3.5 مع temperature: 0. ترفض Mistral HTTP API الجمع بين reasoning_effort="high" وtemperature: 0 باستجابة 400. اترك temperature غير مضبوط حتى تستخدم Mistral قيمتها الافتراضية، أو اتبع الإعدادات الموصى بها لـ Medium 3.5 واستخدم temperature: 0.7 للاستدلال العالي. للحصول على إجابات مباشرة حتمية، أوقف التفكير أو اجعله minimal حتى يرسل OpenClaw reasoning_effort: "none" قبل أن تخفّض temperature.
مثال على إعداد محدود بالنموذج لاستدلال 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).
{
  memorySearch: { provider: "mistral" },
}
  • تستخدم مصادقة Mistral MISTRAL_API_KEY (ترويسة Bearer).
  • يكون عنوان URL الأساسي للمزوّد افتراضيًا https://api.mistral.ai/v1 ويقبل شكل طلب chat-completions القياسي المتوافق مع OpenAI.
  • نموذج التهيئة الافتراضي هو mistral/mistral-large-latest.
  • تجاوز عنوان URL الأساسي ضمن models.providers.mistral.baseUrl فقط عندما تنشر Mistral صراحة نقطة نهاية إقليمية تحتاج إليها.

​
ذو صلة

Model selection

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

Media understanding

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