الانتقال إلى المحتوى الرئيسي

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.

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

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

النموذجالنوعالوصف
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-M2.7.
رابط إحالة لخطة MiniMax Coding Plan (خصم 10%): MiniMax Coding Plan

الضبط عبر openclaw configure

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

تشغيل المعالج

openclaw configure
2

تحديد النموذج/المصادقة

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

اختيار خيار مصادقة MiniMax

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

اختيار نموذجك الافتراضي

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

القدرات

توليد الصور

يسجل 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.
الإعدادمتغير البيئةالافتراضيالوصف
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.voiceIdMINIMAX_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، 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 فهم الصور بشكل منفصل عن كتالوج النص:
معرّف المزوّدنموذج الصور الافتراضي
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
لهذا السبب يمكن لتوجيه الوسائط التلقائي استخدام فهم الصور من 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.*.
راجع بحث 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 كنموذج أساسي محدد؛ استبدله بالنموذج الأساسي المفضّل لديك من أحدث جيل.
{
  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"],
      },
    },
  },
}
  • واجهة برمجة تطبيقات استخدام 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 Coding Plan (خصم 10%): MiniMax Coding Plan
راجع مزوّدو النماذج لمعرفة قواعد المزوّدين.

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

يعني هذا عادةً أن مزوّد 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
ثم أعد التحقق باستخدام:
openclaw models list

ذات صلة

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

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

توليد الصور

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

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

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

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

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

بحث MiniMax

إعداد بحث الويب عبر MiniMax Token Plan.

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

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