الانتقال إلى المحتوى الرئيسي
يستخدم مزوّد MiniMax في OpenClaw MiniMax M3 افتراضيًا. يوفّر MiniMax أيضًا:
  • توليد كلام مضمّنًا عبر T2A v2
  • فهم صور مضمّنًا عبر MiniMax-VL-01
  • توليد موسيقى مضمّنًا عبر music-2.6
  • web_search مضمّنًا عبر واجهة API للبحث في MiniMax Token Plan
تقسيم المزوّد:
معرّف المزوّدالمصادقةالقدرات
minimaxمفتاح APIنص، توليد صور، توليد موسيقى، توليد فيديو، فهم صور، كلام، بحث الويب
minimax-portalOAuthنص، توليد صور، توليد موسيقى، توليد فيديو، فهم صور، كلام

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

النموذجالنوعالوصف
MiniMax-M3محادثة (استدلال)نموذج الاستدلال المستضاف الافتراضي
MiniMax-M2.7محادثة (استدلال)نموذج الاستدلال المستضاف السابق
MiniMax-M2.7-highspeedمحادثة (استدلال)طبقة استدلال M2.7 أسرع
MiniMax-VL-01رؤيةنموذج فهم الصور
image-01توليد صورإنشاء نص إلى صورة وتحرير صورة إلى صورة
music-2.6توليد موسيقىنموذج الموسيقى الافتراضي
music-2.5توليد موسيقىطبقة توليد الموسيقى السابقة
music-2.0توليد موسيقىطبقة توليد الموسيقى القديمة
MiniMax-Hailuo-2.3توليد فيديوتدفقات نص إلى فيديو ومراجع الصور

البدء

اختر طريقة المصادقة المفضلة لديك واتبع خطوات الإعداد.
الأفضل لـ: إعداد سريع باستخدام MiniMax Coding Plan عبر OAuth، دون الحاجة إلى مفتاح API.
1

Run onboarding

openclaw onboard --auth-choice minimax-global-oauth
يصادق هذا مقابل api.minimax.io.
2

Verify the model is available

openclaw models list --provider minimax-portal
تستخدم إعدادات OAuth معرّف المزوّد minimax-portal. تتبع مراجع النماذج الصيغة minimax-portal/MiniMax-M3.
رابط إحالة إلى MiniMax Coding Plan (خصم 10%): MiniMax Coding Plan

الضبط عبر openclaw configure

استخدم معالج الضبط التفاعلي لإعداد MiniMax دون تحرير JSON:
1

Launch the wizard

openclaw configure
2

Select Model/auth

اختر النموذج/المصادقة من القائمة.
3

Choose a MiniMax auth option

اختر أحد خيارات MiniMax المتاحة:
خيار المصادقةالوصف
minimax-global-oauthOAuth دولي (Coding Plan)
minimax-cn-oauthOAuth الصين (Coding Plan)
minimax-global-apiمفتاح API دولي
minimax-cn-apiمفتاح API الصين
4

Pick your default model

اختر نموذجك الافتراضي عند مطالبتك بذلك.

القدرات

توليد الصور

يسجّل Plugin MiniMax نموذج image-01 لأداة image_generate. وهو يدعم:
  • توليد نص إلى صورة مع التحكم في نسبة العرض إلى الارتفاع
  • تحرير صورة إلى صورة (مرجع الموضوع) مع التحكم في نسبة العرض إلى الارتفاع
  • ما يصل إلى 9 صور مخرجة لكل طلب
  • ما يصل إلى صورة مرجعية واحدة لكل طلب تحرير
  • نسب العرض إلى الارتفاع المدعومة: 1:1، 16:9، 4:3، 3:2، 2:3، 3:4، 9:16، 21:9
لاستخدام MiniMax لتوليد الصور، اضبطه بوصفه مزوّد توليد الصور:
{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}
يستخدم Plugin نفس MINIMAX_API_KEY أو مصادقة OAuth مثل نماذج النص. لا حاجة إلى ضبط إضافي إذا كان MiniMax معدًا بالفعل. يسجّل كل من minimax وminimax-portal أداة image_generate بالنموذج نفسه image-01. تستخدم إعدادات مفتاح API المتغير MINIMAX_API_KEY؛ ويمكن لإعدادات OAuth استخدام مسار مصادقة minimax-portal المضمّن بدلًا من ذلك. يستخدم توليد الصور دائمًا نقطة نهاية الصور المخصصة في MiniMax (/v1/image_generation) ويتجاهل models.providers.minimax.baseUrl، لأن ذلك الحقل يضبط عنوان URL الأساسي للدردشة/المتوافق مع Anthropic. اضبط MINIMAX_API_HOST=https://api.minimaxi.com لتوجيه توليد الصور عبر نقطة نهاية الصين؛ نقطة النهاية العالمية الافتراضية هي https://api.minimax.io. عندما يكتب الإعداد الأولي أو إعداد مفتاح API إدخالات models.providers.minimax صريحة، يجسّد OpenClaw النماذج MiniMax-M3 وMiniMax-M2.7 و MiniMax-M2.7-highspeed كنماذج دردشة. يعلن M3 عن إدخال النص والصور؛ ويظل فهم الصور مكشوفًا بشكل منفصل عبر مزوّد الوسائط MiniMax-VL-01 المملوك لـ Plugin.
راجع توليد الصور للاطلاع على معلمات الأداة المشتركة، واختيار المزوّد، وسلوك تجاوز الفشل.

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

يسجّل Plugin minimax المضمّن MiniMax T2A v2 بوصفه مزوّد كلام لـ messages.tts.
  • نموذج TTS الافتراضي: speech-2.8-hd
  • الصوت الافتراضي: English_expressive_narrator
  • تشمل معرّفات النماذج المضمّنة المدعومة speech-2.8-hd وspeech-2.8-turbo، وspeech-2.6-hd وspeech-2.6-turbo وspeech-02-hd، وspeech-02-turbo وspeech-01-hd وspeech-01-turbo.
  • حلّ المصادقة هو messages.tts.providers.minimax.apiKey، ثم ملفات تعريف مصادقة OAuth/الرمز لـ minimax-portal، ثم مفاتيح بيئة Token Plan (MINIMAX_OAUTH_TOKEN، MINIMAX_CODE_PLAN_KEY، MINIMAX_CODING_API_KEY)، ثم MINIMAX_API_KEY.
  • إذا لم يُضبط مضيف TTS، يعيد OpenClaw استخدام مضيف OAuth المضبوط لـ minimax-portal ويزيل لواحق المسار المتوافقة مع Anthropic مثل /anthropic.
  • تظل مرفقات الصوت العادية بصيغة MP3.
  • تُحوّل أهداف الملاحظات الصوتية مثل Feishu وTelegram من MiniMax MP3 إلى Opus بتردد 48kHz باستخدام ffmpeg، لأن API ملفات Feishu/Lark لا تقبل إلا file_type: "opus" للرسائل الصوتية الأصلية.
  • يقبل MiniMax T2A قيم speed وvol الكسرية، لكن يُرسل pitch كعدد صحيح؛ يقتطع OpenClaw قيم pitch الكسرية قبل طلب API.
الإعدادمتغير البيئةالافتراضيالوصف
messages.tts.providers.minimax.baseUrlMINIMAX_API_HOSThttps://api.minimax.ioمضيف API لـ MiniMax T2A.
messages.tts.providers.minimax.modelMINIMAX_TTS_MODELspeech-2.8-hdمعرّف نموذج TTS.
messages.tts.providers.minimax.speakerVoiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narratorمعرّف الصوت المستخدم لمخرجات الكلام.
messages.tts.providers.minimax.speed1.0سرعة التشغيل، 0.5..2.0.
messages.tts.providers.minimax.vol1.0مستوى الصوت، (0, 10].
messages.tts.providers.minimax.pitch0إزاحة الحدة بعدد صحيح، -12..12.

توليد الموسيقى

يسجّل Plugin MiniMax المضمّن توليد الموسيقى عبر الأداة المشتركة music_generate لكل من minimax وminimax-portal.
  • نموذج الموسيقى الافتراضي: minimax/music-2.6
  • نموذج موسيقى OAuth: minimax-portal/music-2.6
  • يدعم أيضاً minimax/music-2.5 وminimax/music-2.0
  • عناصر التحكم في الموجه: lyrics، instrumental
  • تنسيق الإخراج: mp3
  • عمليات التشغيل المدعومة بالجلسة تنفصل عبر تدفق المهام/الحالة المشترك، بما في ذلك action: "status"
لاستخدام MiniMax كمزوّد الموسيقى الافتراضي:
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.6",
      },
    },
  },
}
راجع توليد الموسيقى لمعلمات الأداة المشتركة، واختيار المزوّد، وسلوك تجاوز الفشل.

توليد الفيديو

يسجّل Plugin MiniMax المضمّن توليد الفيديو عبر أداة video_generate المشتركة لكلٍّ من minimax وminimax-portal.
  • نموذج الفيديو الافتراضي: minimax/MiniMax-Hailuo-2.3
  • نموذج فيديو OAuth: minimax-portal/MiniMax-Hailuo-2.3
  • الأوضاع: تدفقات تحويل النص إلى فيديو وتدفقات مرجع الصورة الواحدة
  • يدعم aspectRatio وresolution
لاستخدام MiniMax كمزوّد الفيديو الافتراضي:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
راجع توليد الفيديو لمعلمات الأداة المشتركة، واختيار المزوّد، وسلوك تجاوز الفشل.

فهم الصور

يسجّل Plugin MiniMax فهم الصور بشكل منفصل عن كتالوج النص:
معرّف المزوّدنموذج الصور الافتراضي
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
لهذا السبب يمكن للتوجيه التلقائي للوسائط استخدام فهم الصور من MiniMax حتى عندما يتضمن كتالوج مزوّد النصوص المضمّن أيضاً مراجع دردشة M3 القادرة على معالجة الصور.

بحث الويب

يسجّل Plugin MiniMax أيضاً web_search عبر واجهة API للبحث الخاصة بخطة رموز MiniMax.
  • معرّف المزوّد: minimax
  • النتائج المهيكلة: العناوين، عناوين URL، المقتطفات، الاستعلامات ذات الصلة
  • متغير البيئة المفضّل: MINIMAX_CODE_PLAN_KEY
  • أسماء البيئة البديلة المقبولة: MINIMAX_CODING_API_KEY، MINIMAX_OAUTH_TOKEN
  • بديل التوافق: MINIMAX_API_KEY عندما يشير بالفعل إلى بيانات اعتماد خطة الرموز
  • إعادة استخدام المنطقة: plugins.entries.minimax.config.webSearch.region، ثم MINIMAX_API_HOST، ثم عناوين URL الأساسية لمزوّد MiniMax
  • يبقى البحث على معرّف المزوّد minimax؛ يمكن لإعداد OAuth الصيني/العالمي توجيه المنطقة بشكل غير مباشر عبر models.providers.minimax-portal.baseUrl ويمكنه توفير مصادقة الحامل عبر MINIMAX_OAUTH_TOKEN
يوجد الإعداد ضمن plugins.entries.minimax.config.webSearch.*.
راجع بحث MiniMax للاطلاع على إعداد بحث الويب الكامل واستخدامه.

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

الخيارالوصف
models.providers.minimax.baseUrlيُفضّل https://api.minimax.io/anthropic (متوافق مع Anthropic)؛ https://api.minimax.io/v1 اختياري للحمولات المتوافقة مع OpenAI
models.providers.minimax.apiيُفضّل anthropic-messages؛ openai-completions اختياري للحمولات المتوافقة مع OpenAI
models.providers.minimax.apiKeyمفتاح API من MiniMax (MINIMAX_API_KEY)
models.providers.minimax.modelsعرّف id، وname، وreasoning، وcontextWindow، وmaxTokens، وcost
agents.defaults.modelsأنشئ أسماء مستعارة للنماذج التي تريدها في قائمة السماح
models.modeأبقِ merge إذا كنت تريد إضافة MiniMax إلى جانب المضمّنات
عند api: "anthropic-messages"، يحقن OpenClaw ‏thinking: { type: "disabled" } لنماذج MiniMax M2.x ما لم يكن التفكير مضبوطاً صراحةً مسبقاً في المعلمات/الإعداد.يمنع هذا نقطة نهاية البث في M2.x من إصدار reasoning_content ضمن أجزاء دلتا بأسلوب OpenAI، ما قد يسرّب التفكير الداخلي إلى الإخراج المرئي.يُستثنى MiniMax-M3 (وM3.x): يصدر M3 كتل تفكير Anthropic صحيحة ويعيد مصفوفة content فارغة مع stop_reason: "end_turn" عندما يكون التفكير معطلاً، لذلك يُبقي الغلاف M3 على مسار التفكير المحذوف/التكيفي الخاص بالمزوّد.
يعيد /fast on أو params.fastMode: true كتابة MiniMax-M2.7 إلى MiniMax-M2.7-highspeed على مسار البث المتوافق مع Anthropic.
الأفضل لـ: إبقاء أقوى نموذج لديك من أحدث جيل كنموذج أساسي، مع تجاوز الفشل إلى MiniMax M2.7. يستخدم المثال أدناه Opus كنموذج أساسي ملموس؛ استبدله بنموذجك الأساسي المفضّل من أحدث جيل.
{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": { alias: "primary" },
        "minimax/MiniMax-M2.7": { alias: "minimax" },
      },
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["minimax/MiniMax-M2.7"],
      },
    },
  },
}
  • واجهة API لاستخدام خطة البرمجة: https://api.minimaxi.com/v1/token_plan/remains أو https://api.minimax.io/v1/token_plan/remains (تتطلب مفتاح خطة برمجة).
  • يستمد استطلاع الاستخدام المضيف من models.providers.minimax-portal.baseUrl أو models.providers.minimax.baseUrl عند ضبطهما، لذلك تستطلع الإعدادات العالمية التي تستخدم https://api.minimax.io/anthropic المضيف api.minimax.io. تبقي عناوين URL الأساسية المفقودة أو غير الصحيحة على البديل الصيني للتوافق.
  • يطبّع OpenClaw استخدام خطة البرمجة في MiniMax إلى عرض % left نفسه المستخدم من المزوّدين الآخرين. حقلا MiniMax الخامان usage_percent / usagePercent هما الحصة المتبقية، وليسا الحصة المستهلكة، لذلك يعكسهما OpenClaw. تتقدم الحقول المعتمدة على العدد عند وجودها.
  • عندما تعيد واجهة API ‏model_remains، يفضّل OpenClaw إدخال نموذج الدردشة، ويستمد تسمية النافذة من start_time / end_time عند الحاجة، ويتضمن اسم النموذج المحدد في تسمية الخطة لتسهيل تمييز نوافذ خطة البرمجة.
  • تتعامل لقطات الاستخدام مع minimax وminimax-cn وminimax-portal كسطح حصة MiniMax نفسه، وتفضّل MiniMax OAuth المخزّن قبل الرجوع إلى متغيرات بيئة مفتاح خطة البرمجة.

ملاحظات

  • تتبع مراجع النماذج مسار المصادقة:
    • إعداد مفتاح API: minimax/<model>
    • إعداد OAuth: minimax-portal/<model>
  • نموذج الدردشة الافتراضي: MiniMax-M3
  • نماذج الدردشة البديلة: MiniMax-M2.7، MiniMax-M2.7-highspeed
  • تكتب عملية الإعداد الأولي وإعداد مفتاح API المباشر تعريفات النماذج لـ M3 وكلا متغيري M2.7
  • يستخدم فهم الصور مزوّد الوسائط MiniMax-VL-01 المملوك للـ Plugin
  • حدّث قيم الأسعار في models.json إذا كنت تحتاج إلى تتبع تكلفة دقيق
  • استخدم openclaw models list لتأكيد معرّف المزوّد الحالي، ثم بدّل باستخدام openclaw models set minimax/MiniMax-M3 أو openclaw models set minimax-portal/MiniMax-M3
رابط الإحالة لخطة برمجة MiniMax (خصم 10%): خطة برمجة MiniMax
راجع مزوّدو النماذج لقواعد المزوّد.

استكشاف الأخطاء وإصلاحها

يعني هذا عادةً أن مزوّد MiniMax غير مضبوط (لا يوجد إدخال مزوّد مطابق ولا ملف مصادقة/مفتاح بيئة MiniMax مطابق). يوجد إصلاح لهذا الاكتشاف في 2026.1.12. أصلح ذلك عبر:
  • الترقية إلى 2026.1.12 (أو التشغيل من المصدر main)، ثم إعادة تشغيل Gateway.
  • تشغيل openclaw configure واختيار خيار مصادقة MiniMax، أو
  • إضافة كتلة models.providers.minimax أو models.providers.minimax-portal المطابقة يدوياً، أو
  • ضبط MINIMAX_API_KEY أو MINIMAX_OAUTH_TOKEN أو ملف مصادقة MiniMax حتى يمكن حقن المزوّد المطابق.
تأكد من أن معرّف النموذج حساس لحالة الأحرف:
  • مسار مفتاح API: minimax/MiniMax-M3، أو minimax/MiniMax-M2.7، أو minimax/MiniMax-M2.7-highspeed
  • مسار OAuth: minimax-portal/MiniMax-M3، أو minimax-portal/MiniMax-M2.7، أو minimax-portal/MiniMax-M2.7-highspeed
ثم أعد التحقق باستخدام:
openclaw models list

ذات صلة

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

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

توليد الصور

معلمات أداة الصور المشتركة واختيار المزوّد.

توليد الموسيقى

معلمات أداة الموسيقى المشتركة واختيار المزوّد.

توليد الفيديو

معلمات أداة الفيديو المشتركة واختيار المزوّد.

بحث MiniMax

إعداد بحث الويب عبر خطة رموز MiniMax.

استكشاف الأخطاء وإصلاحها

استكشاف الأخطاء وإصلاحها العام والأسئلة الشائعة.