MiniMax

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

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

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

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

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

# البدء

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

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-M2.7" } } },
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        apiKey: "${MINIMAX_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            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 لتوجيه توليد الصور عبر نقطة نهاية CN؛ نقطة النهاية العالمية الافتراضية هي https://api.minimax.io.

عندما تكتب عملية التهيئة الأولية أو إعداد مفتاح API إدخالات models.providers.minimax صريحة، يجسد OpenClaw النموذجين MiniMax-M2.7 و MiniMax-M2.7-highspeed كنماذج دردشة نصية فقط. أما فهم الصور فيعرض بشكل منفصل عبر مزود الوسائط 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، ثم مفاتيح بيئة خطة الرموز (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، durationSeconds
• صيغة الإخراج: 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",
      },
    },
  },
}

# فهم الصور

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

لهذا السبب يمكن لتوجيه الوسائط التلقائي استخدام فهم الصور من MiniMax حتى عندما يظل كتالوج مزوّد النصوص المضمّن يعرض مراجع دردشة M2.7 النصية فقط.

# بحث الويب

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

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

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

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

openclaw models list

# ذات صلة