MiniMax

يستخدم مزوّد MiniMax في OpenClaw MiniMax M3 افتراضيًا.

يوفّر MiniMax أيضًا:

• توليد كلام مضمّنًا عبر T2A v2
• فهم صور مضمّنًا عبر MiniMax-VL-01
• توليد موسيقى مضمّنًا عبر music-2.6
• web_search مضمّنًا عبر واجهة API للبحث في MiniMax Token Plan

تقسيم المزوّد:

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

البدء

اختر طريقة المصادقة المفضلة لديك واتبع خطوات الإعداد.

openclaw onboard --auth-choice minimax-global-oauth

openclaw models list --provider minimax-portal

openclaw onboard --auth-choice minimax-cn-oauth

openclaw models list --provider minimax-portal

openclaw onboard --auth-choice minimax-global-api

openclaw models list --provider minimax

openclaw onboard --auth-choice minimax-cn-api

openclaw models list --provider minimax

{  env: { MINIMAX_API_KEY: "sk-..." },  agents: { defaults: { model: { primary: "minimax/MiniMax-M3" } } },  models: {    mode: "merge",    providers: {      minimax: {        baseUrl: "https://api.minimax.io/anthropic",        apiKey: "${MINIMAX_API_KEY}",        api: "anthropic-messages",        models: [          {            id: "MiniMax-M3",            name: "MiniMax M3",            reasoning: true,            input: ["text", "image"],            cost: { input: 0.6, output: 2.4, cacheRead: 0.12, cacheWrite: 0 },            contextWindow: 1000000,            maxTokens: 131072,          },          {            id: "MiniMax-M2.7",            name: "MiniMax M2.7",            reasoning: true,            input: ["text"],            cost: { input: 0.3, output: 1.2, cacheRead: 0.06, cacheWrite: 0.375 },            contextWindow: 204800,            maxTokens: 131072,          },          {            id: "MiniMax-M2.7-highspeed",            name: "MiniMax M2.7 Highspeed",            reasoning: true,            input: ["text"],            cost: { input: 0.6, output: 2.4, cacheRead: 0.06, cacheWrite: 0.375 },            contextWindow: 204800,            maxTokens: 131072,          },        ],      },    },  },}

الضبط عبر openclaw configure

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

openclaw configure

القدرات

توليد الصور

يسجّل 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.

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

يسجّل 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 فهم الصور بشكل منفصل عن كتالوج النص:

لهذا السبب يمكن للتوجيه التلقائي للوسائط استخدام فهم الصور من 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.*.

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

{  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: 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

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

openclaw models list

ذات صلة