يستخدم مزوّد MiniMax في OpenClaw MiniMax M2.7 افتراضيًا. يوفّر MiniMax أيضًا: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.
- توليد كلام مضمّن عبر T2A v2
- فهم صور مضمّن عبر
MiniMax-VL-01 - توليد موسيقى مضمّن عبر
music-2.6 web_searchمضمّن عبر واجهة API للبحث في خطة رموز MiniMax
| معرّف المزوّد | المصادقة | القدرات |
|---|---|---|
minimax | مفتاح API | نص، توليد صور، توليد موسيقى، توليد فيديو، فهم الصور، الكلام، بحث الويب |
minimax-portal | OAuth | نص، توليد صور، توليد موسيقى، توليد فيديو، فهم الصور، الكلام |
الفهرس المضمّن
| النموذج | النوع | الوصف |
|---|---|---|
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 | توليد فيديو | مسارات تحويل النص إلى فيديو ومرجع الصورة |
البدء
اختر طريقة المصادقة المفضلة لديك واتبع خطوات الإعداد.- OAuth (Coding Plan)
- API key
الضبط عبر openclaw configure
استخدم معالج الإعدادات التفاعلي لضبط MiniMax من دون تحرير JSON:
اختيار خيار مصادقة MiniMax
اختر أحد خيارات MiniMax المتاحة:
| خيار المصادقة | الوصف |
|---|---|
minimax-global-oauth | OAuth دولي (خطة الترميز) |
minimax-cn-oauth | OAuth الصين (خطة الترميز) |
minimax-global-api | مفتاح API دولي |
minimax-cn-api | مفتاح API الصين |
القدرات
توليد الصور
يسجل Plugin MiniMax النموذجimage-01 للأداة image_generate. وهو يدعم:
- توليد الصور من النص مع التحكم في نسبة العرض إلى الارتفاع
- تحرير الصور باستخدام صورة (مرجع الموضوع) مع التحكم في نسبة العرض إلى الارتفاع
- ما يصل إلى 9 صور ناتجة لكل طلب
- ما يصل إلى صورة مرجعية واحدة لكل طلب تحرير
- نسب العرض إلى الارتفاع المدعومة:
1:1،16:9،4:3،3:2،2:3،3:4،9:16،21:9
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 لتوجيه توليد الصور
عبر نقطة نهاية CN؛ نقطة النهاية العالمية الافتراضية هي
https://api.minimax.io.
عندما تكتب عملية التهيئة الأولية أو إعداد مفتاح API إدخالات models.providers.minimax
صريحة، يجسد OpenClaw النموذجين MiniMax-M2.7 و
MiniMax-M2.7-highspeed كنماذج دردشة نصية فقط. أما فهم الصور
فيعرض بشكل منفصل عبر مزود الوسائط MiniMax-VL-01 المملوك للـ Plugin.
راجع توليد الصور للاطلاع على معلمات الأداة المشتركة، واختيار المزود، وسلوك تجاوز الفشل.
تحويل النص إلى كلام
يسجل Pluginminimax المضمن 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، ثم مفاتيح بيئة خطة الرموز (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.baseUrl | MINIMAX_API_HOST | https://api.minimax.io | مضيف API الخاص بـ MiniMax T2A. |
messages.tts.providers.minimax.model | MINIMAX_TTS_MODEL | speech-2.8-hd | معرف نموذج TTS. |
messages.tts.providers.minimax.voiceId | MINIMAX_TTS_VOICE_ID | English_expressive_narrator | معرف الصوت المستخدم لإخراج الكلام. |
messages.tts.providers.minimax.speed | 1.0 | سرعة التشغيل، 0.5..2.0. | |
messages.tts.providers.minimax.vol | 1.0 | مستوى الصوت، (0, 10]. | |
messages.tts.providers.minimax.pitch | 0 | إزاحة حدة الصوت بعدد صحيح، -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،durationSeconds - صيغة الإخراج:
mp3 - تنفصل عمليات التشغيل المدعومة بالجلسة عبر تدفق المهام/الحالة المشترك، بما في ذلك
action: "status"
راجع توليد الموسيقى للاطلاع على معلمات الأداة المشتركة، واختيار المزود، وسلوك تجاوز الفشل.
توليد الفيديو
يسجل Plugin MiniMax المضمن توليد الفيديو عبر الأداة المشتركةvideo_generate لكل من minimax وminimax-portal.
- نموذج الفيديو الافتراضي:
minimax/MiniMax-Hailuo-2.3 - نموذج الفيديو OAuth:
minimax-portal/MiniMax-Hailuo-2.3 - الأوضاع: تدفقات تحويل النص إلى فيديو وتدفقات مرجع الصورة الواحدة
- يدعم
aspectRatioوresolution
راجع توليد الفيديو لمعرفة معاملات الأداة المشتركة، واختيار المزوّد، وسلوك تجاوز الفشل.
فهم الصور
يسجّل MiniMax Plugin فهم الصور بشكل منفصل عن كتالوج النص:| معرّف المزوّد | نموذج الصور الافتراضي |
|---|---|
minimax | MiniMax-VL-01 |
minimax-portal | MiniMax-VL-01 |
بحث الويب
يسجّل MiniMax Plugin أيضًاweb_search عبر واجهة برمجة تطبيقات البحث MiniMax Token Plan.
- معرّف المزوّد:
minimax - النتائج المنظمة: العناوين، وعناوين URL، والمقتطفات، والاستعلامات ذات الصلة
- متغير البيئة المفضّل:
MINIMAX_CODE_PLAN_KEY - أسماء بيئة بديلة مقبولة:
MINIMAX_CODING_API_KEY،MINIMAX_OAUTH_TOKEN - احتياطي التوافق:
MINIMAX_API_KEYعندما يشير بالفعل إلى اعتماد token-plan - إعادة استخدام المنطقة:
plugins.entries.minimax.config.webSearch.region، ثمMINIMAX_API_HOST، ثم عناوين URL الأساسية لمزوّد MiniMax - يبقى البحث على معرّف المزوّد
minimax؛ ويمكن لإعداد OAuth في CN/العالمي توجيه المنطقة بشكل غير مباشر عبرmodels.providers.minimax-portal.baseUrlويمكنه توفير مصادقة bearer عبر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 | مفتاح واجهة برمجة تطبيقات 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 من إصدار reasoning_content في مقاطع delta بأسلوب OpenAI، ما قد يسرّب الاستدلال الداخلي إلى المخرجات المرئية.الوضع السريع
الوضع السريع
يعيد
/fast on أو params.fastMode: true كتابة MiniMax-M2.7 إلى MiniMax-M2.7-highspeed في مسار البث المتوافق مع Anthropic.مثال احتياطي
مثال احتياطي
الأفضل لـ: إبقاء أقوى نموذج من الجيل الأحدث لديك كنموذج أساسي، مع تجاوز الفشل إلى MiniMax M2.7. يستخدم المثال أدناه Opus كنموذج أساسي محدد؛ استبدله بالنموذج الأساسي المفضّل لديك من أحدث جيل.
تفاصيل استخدام Coding Plan
تفاصيل استخدام Coding Plan
- واجهة برمجة تطبيقات استخدام Coding Plan:
https://api.minimaxi.com/v1/token_plan/remainsأوhttps://api.minimax.io/v1/token_plan/remains(تتطلب مفتاح coding plan). - يستنتج استطلاع الاستخدام المضيف من
models.providers.minimax-portal.baseUrlأوmodels.providers.minimax.baseUrlعند تهيئته، لذلك تستطلع الإعدادات العالمية التي تستخدمhttps://api.minimax.io/anthropicالمضيفapi.minimax.io. تُبقي عناوين URL الأساسية المفقودة أو المشوّهة الاحتياطي CN من أجل التوافق. - يطبّع OpenClaw استخدام MiniMax coding-plan إلى عرض
% leftنفسه المستخدم لدى المزوّدين الآخرين. حقول MiniMax الخامusage_percent/usagePercentتمثل الحصة المتبقية، وليس الحصة المستهلكة، لذلك يعكسها OpenClaw. تتقدّم الحقول القائمة على العد عند وجودها. - عندما تعيد واجهة برمجة التطبيقات
model_remains، يفضّل OpenClaw إدخال نموذج الدردشة، ويستنتج تسمية النافذة منstart_time/end_timeعند الحاجة، ويتضمن اسم النموذج المحدد في تسمية الخطة لتسهيل تمييز نوافذ coding-plan. - تتعامل لقطات الاستخدام مع
minimax، وminimax-cn، وminimax-portalكسطح حصة MiniMax نفسه، وتفضّل MiniMax OAuth المخزّن قبل الرجوع إلى متغيرات بيئة مفتاح Coding Plan.
ملاحظات
- تتبع مراجع النماذج مسار المصادقة:
- إعداد مفتاح واجهة برمجة التطبيقات:
minimax/<model> - إعداد OAuth:
minimax-portal/<model>
- إعداد مفتاح واجهة برمجة التطبيقات:
- نموذج الدردشة الافتراضي:
MiniMax-M2.7 - نموذج الدردشة البديل:
MiniMax-M2.7-highspeed - يكتب الإعداد التمهيدي وإعداد مفتاح واجهة برمجة التطبيقات المباشر تعريفات نماذج نصية فقط لكلتا نسختي M2.7
- يستخدم فهم الصور مزوّد وسائط
MiniMax-VL-01المملوك للـ Plugin - حدّث قيم التسعير في
models.jsonإذا كنت تحتاج إلى تتبع دقيق للتكلفة - استخدم
openclaw models listلتأكيد معرّف المزوّد الحالي، ثم بدّل باستخدامopenclaw models set minimax/MiniMax-M2.7أوopenclaw models set minimax-portal/MiniMax-M2.7
راجع مزوّدو النماذج لمعرفة قواعد المزوّدين.
استكشاف الأخطاء وإصلاحها
"نموذج غير معروف: minimax/MiniMax-M2.7"
"نموذج غير معروف: minimax/MiniMax-M2.7"
يعني هذا عادةً أن مزوّد 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 بحيث يمكن حقن المزوّد المطابق.
- مسار مفتاح واجهة برمجة التطبيقات:
minimax/MiniMax-M2.7أوminimax/MiniMax-M2.7-highspeed - مسار OAuth:
minimax-portal/MiniMax-M2.7أوminimax-portal/MiniMax-M2.7-highspeed
مزيد من المساعدة: استكشاف الأخطاء وإصلاحها والأسئلة الشائعة.
ذات صلة
اختيار النموذج
اختيار المزوّدين، ومراجع النماذج، وسلوك تجاوز الفشل.
توليد الصور
معاملات أداة الصور المشتركة واختيار المزوّد.
توليد الموسيقى
معاملات أداة الموسيقى المشتركة واختيار المزوّد.
توليد الفيديو
معاملات أداة الفيديو المشتركة واختيار المزوّد.
بحث MiniMax
إعداد بحث الويب عبر MiniMax Token Plan.
استكشاف الأخطاء وإصلاحها
استكشاف الأخطاء العام والأسئلة الشائعة.