MiniMax

تسجّل إضافة minimax المضمّنة مزوّدَين بالإضافة إلى سبع إمكانات: الدردشة، وتوليد الصور، وتوليد الموسيقى، وتوليد الفيديو، وفهم الصور، والكلام (T2A v2)، والبحث على الويب.

الكتالوج المضمّن

تتبع مراجع النماذج مسار المصادقة: minimax/<model> للإعدادات التي تستخدم مفتاح API، وminimax-portal/<model> لإعدادات OAuth.

بدء الاستخدام

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

openclaw configure

الإمكانات

توليد الصور

يسجّل Plugin الخاص بـ MiniMax النموذج image-01 لأداة image_generate على كل من minimax وminimax-portal، مع إعادة استخدام MINIMAX_API_KEY نفسه أو مصادقة OAuth المستخدمة لنماذج النصوص.

• توليد الصور من النص وتحرير صورة بناءً على صورة أخرى (مرجع العنصر)، وكلاهما مع إمكانية التحكم في نسبة العرض إلى الارتفاع
• ما يصل إلى 9 صور ناتجة لكل طلب، وصورة مرجعية واحدة لكل طلب تحرير
• نسب العرض إلى الارتفاع المدعومة: 1:1، 16:9، 4:3، 3:2، 2:3، 3:4، 9:16، 21:9

{  agents: {    defaults: {      imageGenerationModel: { primary: "minimax/image-01" },    },  },}

يستخدم توليد الصور دائمًا نقطة نهاية الصور المخصصة من MiniMax‏ (/v1/image_generation) ويتجاهل models.providers.minimax.baseUrl، لأن هذا الحقل يضبط بدلًا من ذلك عنوان URL الأساسي المتوافق مع الدردشة/Anthropic. اضبط MINIMAX_API_HOST=https://api.minimaxi.com لتوجيه توليد الصور عبر نقطة النهاية الصينية؛ نقطة النهاية العالمية الافتراضية هي https://api.minimax.io.

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

يسجّل 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، speech-01-240228
• ترتيب تحديد المصادقة: 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 بتردد 48 كيلوهرتز باستخدام 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)
• يدعم أيضًا music-2.6-free وmusic-cover وmusic-cover-free
• عناصر التحكم في الموجّه: lyrics، وinstrumental
• تنسيق الإخراج: mp3
• تُفصل عمليات التشغيل المدعومة بجلسة عبر مسار المهمة/الحالة المشترك، بما في ذلك action: "status"

{  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)
• يدعم أيضًا MiniMax-Hailuo-2.3-Fast وMiniMax-Hailuo-02 وI2V-01-Director وI2V-01-live وI2V-01
• الأوضاع: تحويل النص إلى فيديو ومسارات المرجع بصورة واحدة
• يدعم resolution‏ (768P أو 1080P في نماذج Hailuo 2.3/02)؛ أما aspectRatio فغير مدعوم ويُتجاهل

{  agents: {    defaults: {      videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" },    },  },}

فهم الصور

يسجّل Plugin ‏MiniMax فهم الصور بشكل منفصل عن كتالوج النصوص:

لهذا السبب، يمكن للتوجيه التلقائي للوسائط استخدام فهم الصور من MiniMax حتى عندما يتضمن كتالوج مزوّد النصوص المضمّن أيضًا مراجع محادثة من M3 تدعم الصور. يستخدم فهم PDF النموذج MiniMax-M2.7 لاستخراج النص فقط؛ ولا يسجّل MiniMax مسارًا لتحويل PDF إلى صور.

البحث على الويب

يسجّل Plugin ‏MiniMax أيضًا web_search عبر واجهة API للبحث في MiniMax Token Plan ‏(/v1/coding_plan/search).

• معرّف المزوّد: 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"],      },    },  },}

ملاحظات

• نموذج المحادثة الافتراضي: 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

ذو صلة