Skip to content

ربط MiniMax: سلسلة M3 و Coding Plan ​

OpenClaw ربط MiniMax هو المحطة الخامسة في صفحة الموديلات الصينية. يتميز MiniMax في OpenClaw ببعض الخصوصية: مكونه الإضافي الرسمي مدمج (bundled، يأتي مع تثبيت OpenClaw، ويُفعَّل بـ openclaw plugins enable minimax أمر واحد)، لكن المصادقة تنقسم إلى مسارين — API Key للدفع حسب الاستخدام يسلك minimax، واشتراك Coding Plan يسلك minimax-portal عبر OAuth. الخطوات الثلاث «تثبيت المكون الإضافي ← ضبط بيانات الاعتماد ← اختيار النموذج» من الدروس السابقة DeepSeek و Qwen و GLM و Kimi تنطبق جميعها على هذا الدرس، مع إضافة سؤال اختيار «تحديد المسار» في البداية فقط. تستغرق العملية بأكملها نحو 8 دقائق (لا يشمل ذلك التسجيل في MiniMax).

إليك أولًا جدولًا إجماليًا تنطلق منه جميع إعدادات هذا الدرس (الخصائص والقيم منقولة كما هي من الوثائق الرسمية):

المسار A: API Key (الدفع حسب الاستخدام)المسار B: OAuth (Coding Plan)
لمن يصلحمستخدمو API بالدفع حسب الاستخدام (pay-as-you-go)مشتركو MiniMax Coding Plan
معرّف المزوّد (Provider id)minimaxminimax-portal
طريقة المصادقةAPI Key (MINIMAX_API_KEY)تسجيل دخول OAuth (تدفق user-code)
نقطة نهاية الموقع الدوليhttps://api.minimax.io/anthropic (متوافق مع Anthropic)api.minimax.io
نقطة نهاية الموقع الصينيhttps://api.minimaxi.com/anthropic (متوافق مع Anthropic)api.minimaxi.com
auth-choice (الموقع الدولي)minimax-global-apiminimax-global-oauth
auth-choice (الموقع الصيني)minimax-cn-apiminimax-cn-oauth
بادئة مرجع الموديلminimax/...minimax-portal/...
الموديل الافتراضيMiniMax-M3MiniMax-M3
القدرات الإضافيةنصوص + توليد صور/موسيقى/فيديو + فهم الصور + صوت + بحث ويبنصوص + توليد صور/موسيقى/فيديو + فهم الصور + صوت (بدون بحث ويب)

أمرٌ يجب تذكّره أولًا: معرّف المزوّد مختلف بين المسارين، وبالتالي يختلف مرجع الموديل — في مسار API Key تُكتب minimax/MiniMax-M3، وفي مسار OAuth تُكتب minimax-portal/MiniMax-M3، كما أن معرّف الموديل حساس لحالة الأحرف. إذا كتبت في الإعدادات صيغة بأحرف صغيرة مثل minimax/minimax-m3، فلن يتعررف عليها OpenClaw.

كيف تختار؟ في ثلاث جمل:

حالتكاختر هذا
تدفع حسب الاستخدام وتريد المجموعة الكاملة M3 / M3.1-Flash مع بحث الويبمسار API Key (minimax، القدرات الست كاملة)
مشترك في MiniMax Coding Plan وتستخدمه أساسًا لكتابة الأكوادمسار OAuth (minimax-portal، يُستخدم ضمن حصة الاشتراك)
تريد استخدام المسارين معًااضبط كليهما — معرّفا المزوّد مختلفان ولا يلغي أحدهما الآخر

💡 للأصدقاء القادمين من البحث عن «MiniMax M3» أو «MiniMax Coding Plan»

M3 هو نموذج الاستدلال الرائد الافتراضي الحالي من MiniMax، وCoding Plan هو باقة الاشتراك الخاصة به. للاتصال به عبر OpenClaw لا تحتاج إلى حساب MiniMax App، بل إلى تسجيل دخول OAuth واحد (لمستخدمي الاشتراك) أو مفتاح API واحد (لمستخدمي الدفع حسب الاستخدام) — توضح هذه الصفحة المسارين معًا.

يستند هذا البرنامج التعليمي إلى OpenClaw v2026.10.9.

ماذا ستستطيع أن تفعل بعد الانتهاء ​

  • التمييز بين مساري المصادقة minimax وminimax-portal: مفتاح API بالدفع حسب الاستخدام يسلك الأول، وOAuth لـ Coding Plan يسلك الثاني، دون خلط بينهما بعد الآن
  • تمكين إضافة MiniMax المدمجة، وإكمال onboarding باستخدام أربعة auth-choice (دولي/صيني × API/OAuth)
  • فهم دليل النماذج: موقع MiniMax-M3 وMiniMax-M3.1-Flash وMiniMax-M2.7، وسياقها وقيمها الافتراضية
  • تجنب المشكلات الخاصة بـ MiniMax: معرف النموذج حساس لحالة الأحرف، وM3.1-Flash عند تعطيل التفكير يُرجع 400، وM2.x عند تعطيل التفكير يُسرّب نصًا استدلاليًا رغم ذلك
  • الاستفادة من قدرات MiniMax الست في باقة واحدة: توليد الصور، والموسيقى، وفيديو Hailuo، وTTS الصوتي، وفهم الصور، والبحث في الويب

🎒 التحضير قبل البدء ​

  • إتمام نظرة عامة على ربط النماذج: نظام provider وتبديل النماذج: معرفة جيدة بالخطوات الثلاث «provider → المصادقة → اختيار النموذج» وقواعد مرجع provider/model
  • OpenClaw مثبت وGateway يعمل: openclaw gateway status يُخرج نتيجة
  • معرفة ما إذا كنت ستدفع حسب الاستخدام (مفتاح API) أم تشترك في Coding Plan (OAuth) — هذا يحدد المسار الذي ستسلكه
  • إذا كنت ستستخدم نشرًا عبر خادم / daemon، اعرف مكان ~/.openclaw/.env — فالمفتاح سيستقر هناك في النهاية

اتبع الخطوات معي ​

الخطوة 1: تأكيد المسار وتمكين إضافة MiniMax ​

لماذا: إضافة MiniMax مدمجة (bundled مع OpenClaw)، فلا تحتاج إلى plugins install كما في DeepSeek وKimi — فقط فعّلها بـ openclaw plugins enable minimax ثم أعد تشغيل Gateway.

bash
# 1. 启用内置的 MiniMax 插件
openclaw plugins enable minimax

# 2. 重启 Gateway 让插件生效
openclaw gateway restart

ما يجب أن تراه: رسالة نجاح تمكين الإضافة، وعدم ظهور أخطاء بعد إعادة تشغيل Gateway.

بعد التمكين، ابدأ بسؤال اختيار المسار (وفق التوصية الرسمية في الوثائق):

حالتكالمسارauth-choice
API بالدفع حسب الاستخدام، وأنت في الخارج أو تستخدم الموقع الدوليA: مفتاح API (دولي)minimax-global-api
API بالدفع حسب الاستخدام، باستخدام الموقع الصينيA: مفتاح API (صيني)minimax-cn-api
اشتراك Coding Plan، حساب على الموقع الدوليB: OAuth (دولي)minimax-global-oauth
اشتراك Coding Plan، حساب على الموقع الصينيB: OAuth (صيني)minimax-cn-oauth

ملاحظة لمستخدمي الصين: نقطة نهاية الموقع الصيني هي api.minimaxi.com (بزيادة i)، أما الدولية فهي api.minimax.io — لكل موقع auth-choice مختلف، فاختر وفق الموقع الذي ينتمي إليه حسابك ولا تخلط بينهما.

  • openclaw plugins enable minimax نُفّذ بنجاح، وأُعيد تشغيل Gateway

الخطوة 2: ربط MiniMax عبر OpenClaw — إعداد المصادقة ​

لماذا: بيانات الاعتماد في المسارين مختلفة تمامًا — مفتاح API هو سلسلة أحرف، بينما OAuth هو تسجيل دخول user-code واحد في المتصفح؛ ومعرّف provider يتبع المسار أيضًا (minimax مقابل minimax-portal)، فإذا أخطأت المسار لن يتطابق المفتاح.

المسار A: مفتاح API (الدفع حسب الاستخدام) ​

اذهب أولًا إلى منصة MiniMax المفتوحة لإنشاء مفتاح API، وانسخه واحفظه جيدًا. ثم شغّل onboarding:

bash
# 国际站
openclaw onboard --auth-choice minimax-global-api

# 中国站
openclaw onboard --auth-choice minimax-cn-api

ما يجب أن تراه: نجاح التحقق من المفتاح وحفظه؛ عنوان base URL لمسار الموقع الدولي يقع في https://api.minimax.io/anthropic، ولمسار الموقع الصيني في https://api.minimaxi.com/anthropic (كلاهما نقطة نهاية متوافقة مع Anthropic).

تحقق من الدليل على الفور:

bash
openclaw models list --provider minimax

ما يجب أن تراه: عائلة نماذج MiniMax-M3 وMiniMax-M3.1-Flash وMiniMax-M2.7 ظاهرة في القائمة.

المسار B: OAuth (اشتراك Coding Plan) ​

مستخدمو اشتراك Coding Plan لا يحتاجون إلى مفتاح API، بل يسلكون تسجيل دخول OAuth (عملية user-code، تمنحك رمزًا لتأكيده في المتصفح):

bash
# 国际站
openclaw onboard --auth-choice minimax-global-oauth

# 中国站
openclaw onboard --auth-choice minimax-cn-oauth

ما يجب أن تراه: إرشادات تسجيل الدخول في الطرفية، وحفظ بيانات الاعتماد بعد إكمال التفويض في المتصفح؛ وعنوان provider base URL يقع في api.minimax.io (دولي) أو api.minimaxi.com (صيني).

يمكنك أيضًا استخدام أمر تسجيل الدخول auth مباشرة (الطريقة الواردة في README للإضافة الرسمية، و--set-default يضبط النموذج الافتراضي أيضًا):

bash
openclaw models auth login --provider minimax-portal --set-default

تحقق من الدليل على الفور:

bash
openclaw models list --provider minimax-portal

ما يجب أن تراه: دليل النماذج بالبادئة minimax-portal/ ظاهر في القائمة.

سلوك خاص بـ OAuth اعرفه مسبقًا: عند انتهاء صلاحية الرمز، يذهب OpenClaw تلقائيًا إلى نقطة النهاية الإقليمية التي أصدرته أصلًا لتجديده. يرفض التجديد ويطلب منك تسجيل الدخول مجددًا في حالتين — إذا كان تسجيل الدخول المحفوظ أقدم من دعم التجديد (لم يُسجل الإقليم)، أو إذا غيّرت models.providers.minimax-portal.baseUrl إلى إقليم آخر. عند ظهور التنبيه أعد تشغيل openclaw models auth login --provider minimax-portal مرة أخرى.

الإعداد اليدوي (إذا لم ترغب في تشغيل onboarding) ​

الإضافة الرسمية في الأصل لا تحتاج إلى كتابة مدخلات models.providers — يكفي تمكين الإضافة، وضبط auth، واختيار النموذج؛ تُكتب فقط عند الرغبة في تثبيت نقطة النهاية / تعريف النموذج صراحةً. المثال الرسمي لمسار مفتاح API (مقتطف كما هو):

json5
{
  env: { vars: { 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"],
            compat: { codeMode: "preferred" },
            cost: { input: 0.6, output: 2.4, cacheRead: 0.12, cacheWrite: 0 },
            contextWindow: 1000000,
            maxTokens: 131072,
          },
          // ...
        ],
      },
    },
  },
}

ثلاث نقاط رئيسية (مذكورة صراحةً في الوثائق الرسمية):

  • baseUrl المتوافق مع Anthropic هو الخيار الأول https://api.minimax.io/anthropic، مع api يستخدم anthropic-messages؛ أما https://api.minimax.io/v1 + openai-completions المتوافق مع OpenAI فهو اختياري
  • models.mode: "merge" يجعل دليل MiniMax يتعايش مع الدليل المدمج، دون حذف providers الموجودة لديك
  • كل من onboarding والإعداد المباشر لمفتاح API يكتبان تعريفات النماذج لـ M3 ونسختَي M2.7

أين يوضع المفتاح: في الـ shell التفاعلي عبر export MINIMAX_API_KEY="<你的 API Key>"، أو يُكتب في ~/.openclaw/.env (نشر daemon يجب أن يمر من هنا، انظر التحذير أدناه). عائلة متغيرات البيئة لمسار OAuth / Token Plan هي MINIMAX_OAUTH_TOKEN وMINIMAX_CODE_PLAN_KEY وMINIMAX_CODING_API_KEY.

⚠️ هل يعمل Gateway كـ daemon؟ لا تضع المفتاح في الـ shell التفاعلي

عندما يعمل Gateway كخدمة launchd / systemd، لا يرى متغيرات البيئة التي ضبطتها بـ export في طرفيتك. اكتب MINIMAX_API_KEY في ~/.openclaw/.env، أو زوّد ذلك العملية عبر env.shellEnv في الإعداد.

  • في نظرة عامة على بيانات الاعتماد الخاصة بـ openclaw models status، يمكنك رؤية مصدر بيانات الاعتماد لمسارك

الخطوة 3: اختيار نموذج MiniMax والتحقق ​

لماذا: النموذج الافتراضي في المسارين هو MiniMax-M3، وهو كافٍ للاستخدام المباشر؛ لكن M3.1-Flash يوفر سياق 1M + مستوى استدلال قابل للتعديل، و M2.7 أرخص — لا خسارة في إلقاء نظرة على الدليل قبل اتخاذ القرار.

ألقِ نظرة أولًا على الدليل المدمج (الوثائق الرسمية + أمثلة الإعدادات منسوخة كما هي):

مرجع النموذج (مسار API Key)النوعالإدخالالسياقالحد الأقصى للإخراجملاحظات
minimax/MiniMax-M3استدلالنص، صور1,000,000131,072افتراضي، hosted reasoning
minimax/MiniMax-M3.1-Flashاستدلالنص، صور1,000,000131,072مستوى effort قابل للتعديل؛$0.15 / $0.60 / $0.015 لكل M
minimax/MiniMax-M3.1-Flash-Previewاستدلالنص، صور1,000,000131,072معرّف قديم، محفوظ فقط للإعدادات القائمة
minimax/MiniMax-M2.7استدلالنص204,800131,072الجيل السابق من hosted reasoning
minimax/MiniMax-M2.7-highspeedاستدلالنص204,800131,072الوضع عالي السرعة لـ M2.7
minimax/MiniMax-VL-01فهم الصور———انظر القدرات الخاصة أدناه
minimax/image-01توليد الصور———توليد صور من نص + تحرير صورة من صورة
minimax/music-2.6توليد الموسيقى———نموذج الموسيقى الافتراضي
minimax/MiniMax-Hailuo-2.3توليد الفيديو———فيديو من نص + فيديو من صورة

مسار OAuth يستبدل البادئة بـ minimax-portal/، ودليل نماذج الدردشة هو نفسه؛ لكن قدرة البحث في الويب متاحة فقط في مسار API Key (المزوّد minimax).

سلوكان للدليلين يجب معرفتهما مسبقًا:

  • MiniMax-M3.1-Flash يعمل مع API Key بالاستخدام ومَع Token Plan و MiniMax Code؛ حقل cost في Token Plan لـ MiniMax-M3.1-Flash-Preview هو 0، وهذا لا يعني أنه مجاني (لم يُنشر تسعير Preview حسب token)، كما أن الخدمة upstream قد يوقفه في أي وقت — للإعدادات الجديدة اختر MiniMax-M3.1-Flash دائمًا
  • M3 و M3.1-Flash هما في المسارين نموذجا Code Mode المفضّلان (compat.codeMode: "preferred")؛ عند عدم تكوين Code Mode عام يمكن للوضع التلقائي تفعيلهما، بينما يبقى التكوين الصريح أولًا

كيف تختار، في أربع جمل:

احتياجكاخترالأساس
مهام عامة دون تعقيدMiniMax-M3النموذج الافتراضي في المسارين، سياق 1M
سياق طويل + ضبط مستوى الاستدلال بنفسكMiniMax-M3.1-Flashسياق 1M، /think بخمسة مستويات قابلة للتعديل
تريد توفير المال / كبديل احتياطيMiniMax-M2.7سعر الدليل $0.3 / $1.2 لكل M، أي نصف سعر M3
تريد M2.7 لكن أسرعMiniMax-M2.7-highspeed/fast on سيتم التبديل إليه تلقائيًا

تغيير النموذج الافتراضي (لاحظ أن البادئة تتبع المسار):

bash
# API Key 路线
openclaw models set minimax/MiniMax-M3

# OAuth 路线
openclaw models set minimax-portal/MiniMax-M3

يمكن أيضًا التبديل مؤقتًا في الدردشة: /model minimax/MiniMax-M3.1-Flash يؤثر فقط على الجلسة الحالية، ولتفاصيل عائلة الأوامر راجع دليل سريع لأوامر الدردشة.

أخيرًا التحقق. أرسل رسالة اختبار:

bash
openclaw dashboard

افتح Control UI، وأرسل في صندوق الدردشة جملة «قدّم نفسك في جملة واحدة».

ما يجب أن تراه: النموذج يرد بشكل طبيعي، دون أخطاء عن نقص بيانات الاعتماد أو عدم وجود النموذج. إلى هنا، يصبح ربط OpenClaw بـ MiniMax ناجحًا.

السعر في جملة واحدة، حسب المسار:

  • مسار API Key يُحتسب بالاستخدام، وتقدير الدليل المدمج (لكل مليون token): M3 بسعر $0.6 إدخال / $2.4 إخراج / $0.12 قراءة من ذاكرة التخزين المؤقت؛ M3.1-Flash بأسعار MiniMax المعلنة $0.15 / $0.60 / $0.015؛ M2.7 بسعر $0.3 / $1.2 / $0.06 / $0.375 كتابة في ذاكرة التخزين المؤقت
  • مسار OAuth يستهلك حصة اشتراك Coding Plan، ولا يُحتسب حسب token؛ أسعار الاشتراك وفقًا لموقع MiniMax الرسمي
  • وصل رد على رسالة الاختبار، والمزوّد والنموذج متطابقان (minimax/... أو minimax-portal/...)

نقطة تحقق ✅ ​

  • إضافة MiniMax مفعّلة (bundled، openclaw plugins enable minimax + إعادة تشغيل Gateway)
  • المسار المستخدم متوافق مع بيانات الاعتماد: Key بالاستخدام → minimax؛ Coding Plan عبر OAuth → minimax-portal
  • openclaw models list --provider minimax (أو --provider minimax-portal) لعرض الدليل
  • بادئة النموذج الافتراضي صحيحة: minimax/MiniMax-M3 أو minimax-portal/MiniMax-M3، دون خطأ في حالة الأحرف
  • تم استلام رد على رسالة الاختبار، ولم يتم ربط مرجع minimax/ بمسار OAuth (أو العكس)

تنبيهات من العثرات الشائعة ​

❌ ظهور الخطأ "Unknown model: minimax/MiniMax-M3" ​

الظاهرة: عند تبديل النموذج أو إرسال رسالة يظهر خطأ نموذج غير معروف.

السبب: تقول وثائق استكشاف الأخطاء الرسمية إن هذا يعني عادةً أن MiniMax provider غير مُهيأ — فلا يوجد إدخال provider مطابق، ولا يمكن العثور على بيانات اعتماد MiniMax.

الحل الصحيح، اختر واحدًا من ثلاثة:

  • شغّل openclaw configure، واختر في Model/auth أحد خيارات MiniMax (جميع خيارات auth الأربعة موجودة)
  • أضف يدويًا كتلة التهيئة models.providers.minimax (أو models.providers.minimax-portal)
  • عيّن MINIMAX_API_KEY أو MINIMAX_OAUTH_TOKEN أو auth profile لـ MiniMax، بحيث يتمكن المكون الإضافي من حقن الـ provider

ثم تحقق مجددًا عبر openclaw models list.

❌ خطأ في حالة الأحرف لمعرّف النموذج ​

الظاهرة: التهيئة تتضمن النموذج بوضوح، ومع ذلك يظهر خطأ نموذج غير معروف.

السبب: معرّفات نماذج MiniMax حساسة لحالة الأحرف. الصيغة الصحيحة هي MiniMax-M3 وMiniMax-M2.7 وMiniMax-M2.7-highspeed — أما minimax-m3 وMINIMAX-M3 فلا يعملان.

الحل الصحيح: انسخ الصيغة كما هي من جدول الفهرس في هذه الصفحة؛ ويتبع البادئة مسار المصادقة (minimax/ أو minimax-portal/).

❌ الأمر /think off يسبب خطأ HTTP 400 على M3.1-Flash ​

السبب: MiniMax-M3.1-Flash (بما في ذلك المعرّف القديم MiniMax-M3.1-Flash-Preview) يتطلب adaptive thinking — حيث يرفض MiniMax تعطيل التفكير (disabled thinking) ويعيد مباشرةً خطأ HTTP 400. لذلك لا يوفّر OpenClaw خيار off لهذا النموذج أصلًا، بل يكشف /think خمسة مستويات فقط هي low / medium / high / xhigh / max، والافتراضي هو max.

الحل الصحيح: لا تعطّل التفكير على M3.1-Flash؛ وإذا أردت تعطيله فعلًا، فبدّل إلى MiniMax-M3 (مستويان: off / adaptive) أو سلسلة M2.x.

❌ عطّلت التفكير على M2.7 ومع ذلك يتسرب نص الاستدلال إلى الرد ​

السبب: تحذير الوثائق الرسمية واضح — قد يُخرج M2.x على مسار Anthropic المتوافق قيم delta بأسلوب بث OpenAI لـ reasoning_content، مما يكشف الاستدلال في المخرجات المرئية. يرسل OpenClaw افتراضيًا thinking: { type: "disabled" }، لكن وثائق MiniMax تقول إن M2.x يقبل هذا الإعداد ويتجاهله، فيستمر التفكير بالعمل ويستمر تسريب الاستدلال.

الحل الصحيح: إذا كنت تهتم بمخرجات نظيفة، فلا تعطّل التفكير قسرًا على M2.x؛ بدّل إلى M3 (الافتراضي adaptive، وOpenClaw يزيل الإعداد الافتراضي الضمني disabled لـ M3).

❌ رفض تحديث رمز OAuth ويطلب منك تسجيل الدخول مجددًا ​

السبب: حالتان — تسجيل الدخول المحفوظ أقدم من دعم التحديث (لم يُسجَّل منطقة الإصدار)، أو أن models.providers.minimax-portal.baseUrl تم تغييره إلى منطقة أخرى (الدولية ↔ الصين)، وOpenClaw يرفض التحديث عبر المناطق.

الحل الصحيح: أعد تشغيل openclaw models auth login --provider minimax-portal وفق التعليمات؛ ولا تغيّر baseUrl يدويًا إلى منطقة أخرى.

❌ بعد تثبيت Gateway كـ daemon، يبدو أن المفتاح المُصدَّر عبر export «لا يسري» ​

السبب: خدمات launchd / systemd لا ترى متغيرات البيئة الخاصة بالـ shell التفاعلي — وهو ما تؤكد عليه وثائق كل provider مرارًا.

الحل الصحيح: اكتب MINIMAX_API_KEY في ~/.openclaw/.env، أو وفّره عبر env.shellEnv في التهيئة؛ وأعد تشغيل خدمة Gateway بعد تغيير المفتاح.

❌ هيأت baseUrl لكن توليد الصور لم يستخدمه ​

السبب: توليد الصوريستخدم دائمًا نقطة نهاية الصور المخصصة لـ MiniMax (/v1/image_generation) ويتجاهل models.providers.minimax.baseUrl — فهذا الحقل يخص مسارات الدردشة / توافق Anthropic فقط.

الحل الصحيح: إذا أردت أن يمر توليد الصور عبر الموقع الصيني، فعيّن MINIMAX_API_HOST=https://api.minimaxi.com (الافتراضي هو الموقع الدولي https://api.minimax.io).

🔧 قدرات MiniMax المخصصة (اختيارية) ​

مكوّن MiniMax الإضافي لا يقتصر على الدردشة — فهو يسجّل دفعة واحدة اثنين من chat provider + ست قدرات: توليد الصور، وتوليد الموسيقى، وتوليد الفيديو، وفهم الصور، والصوت (T2A v2)، والبحث في الويب. أي أنك بمجرد تهيئة هذا المزوّد، يمكن لصور Claw وموسيقاه وتعليقه الصوتي وفيديوهاته والبحث عبر الإنترنت أن تمر جميعها عبر MiniMax.

نظرة عامة على القدرات: الصور، الموسيقى، الفيديو، الصوت، فهم الصور، البحث في الويب ​

القدرةالنموذجالمرجع الافتراضي (مسار API Key)ملاحظات
توليد الصورimage-01minimax/image-01توليد من نص + تحرير من صورة؛ حتى 9 صور في الطلب الواحد؛ نسب العرض إلى الارتفاع 1:1 / 16:9 / 4:3 / 3:2 / 2:3 / 3:4 / 9:16 / 21:9
توليد الموسيقىmusic-2.6minimax/music-2.6تتوفر أيضًا music-2.6-free وmusic-cover وmusic-cover-free؛ المخرجات mp3
توليد الفيديوMiniMax-Hailuo-2.3minimax/MiniMax-Hailuo-2.3تتوفر أيضًا Hailuo-2.3-Fast وHailuo-02 وسلسلة I2V-01؛ الدقة 768P / 1080P؛ لا يدعم aspectRatio
الصوت (TTS)speech-2.8-hd—T2A v2؛ الصوت الافتراضي English_expressive_narrator
فهم الصورMiniMax-VL-01—استخراج نصوص PDF يستخدم MiniMax-M2.7
البحث في الويب—provider minimaxيمر عبر واجهة برمجة تطبيقات البحث في Token Plan (/v1/coding_plan/search)؛ مسار API Key فقط

تعيين إحدى القدرات كنموذج وسائط افتراضي (كما في المثال الرسمي حرفيًا، باستخدام الصور مثالًا):

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

ينطبق الأمر نفسه على الموسيقى والفيديو: mediaModels: { music: { primary: "minimax/music-2.6" } }، mediaModels: { video: { primary: "minimax/MiniMax-Hailuo-2.3" } } (مع استبدال بادئة مسار OAuth بـ minimax-portal/).

ثلاث تفاصيل:

  • البحث في الويب متاح فقط في minimax (مسار API Key): إن minimax-portal الخاص بـ OAuth لا يملك هذه القدرة. يُفضَّل متغير البيئة MINIMAX_CODE_PLAN_KEY للبحث، ويُقبل أيضًا MINIMAX_CODING_API_KEY وMINIMAX_OAUTH_TOKEN؛ والإعداد يكون في plugins.entries.minimax.config.webSearch.*
  • لمصادقة TTS ترتيب أسبقية: tts.providers.minimax.apiKey → OAuth/token الخاص بـ minimax-portal → متغير بيئة Token Plan → MINIMAX_API_KEY؛ وعند عدم إعداد TTS host يُعاد استخدام OAuth host مع إزالة لواحق مثل /anthropic
  • تحويل ترميز الرسائل الصوتية: في القنوات التي تتطلب مقطعًا صوتيًا (voice note) مثل Feishu وTelegram، يستخدم OpenClaw أداة ffmpeg لتحويل MiniMax MP3 إلى Opus بتردد 48kHz (واجهة Feishu للملفات لا تقبل سوى file_type: "opus")

للاطلاع على التطبيقات العملية للصور والأصوات، انظر الصور والصوت: إضافة صور للمحتوى وتحويل المقالات إلى صوت؛ أما لاستخدام أداة البحث في الويب فانظر التحكم بالمتصفح: دع Claw يتصفح الإنترنت وينفذ العمليات نيابةً عنك.

مستويات /think ومرجع سريع لـ /fast ​

عائلة النماذجمستويات /thinkالافتراضي
MiniMax-M3off / adaptiveadaptive
MiniMax-M3.1-Flashlow / medium / high / xhigh / maxmax (لا يُقدَّم خيار off، وإيقافه يُرجع 400)
MiniMax-M2.xoff / minimal / low / medium / highoff (لكن الخدمة upstream تقبله وتتجاهل disabled)

/fast on (أو params.fastMode: true) يعيد كتابة MiniMax-M2.7 إلى MiniMax-M2.7-highspeed — يسري فقط على مسار Anthropic المتوافق.

استعلام استهلاك Coding Plan ​

لمشتركي الخدمة الذين يريدون معرفة المتبقي من حصتهم: يستعلم OpenClaw دوريًا عن واجهة API الخاصة بالاستهلاك لدى MiniMax (https://api.minimaxi.com/v1/token_plan/remains أو https://api.minimax.io/v1/token_plan/remains، ويتطلب coding plan key)، ويوحّد الاستهلاك إلى «نسبة مئوية متبقية» تُعرض كما هو الحال مع بقية الـ provider.

تفصيلان:

  • حقلا MiniMax الأصليان usage_percent / usagePercent يمثلانالمتبقي من الحصة لا المستهلك، لذا يعكس OpenClaw القيمة قبل عرضها؛ وعند وجود حقل عدّ بالمرات تُعتمد المرات
  • تعتبر لقطة الاستهلاك minimax وminimax-cn وminimax-portal وminimax-portal-cnنفس واجهة الحصة، مع تفضيل OAuth المخزَّن، والرجوع إلى متغير بيئة Coding Plan key

::: تفاصيل متقدمة: جعل MiniMax نموذجًا احتياطيًا المثال الرسمي (كما هو) — النموذج الأساسي هو الأقوى، وعند الفشل يتم الرجوع إلى M2.7:

json5
{
  env: { vars: { 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"],
      },
    },
  },
}

Opus في المثال مجرد عنصر نائب، استبدله بنموذجك الأساسي الخاص بك. :::

الخطوة التالية ​

بهذا تكون قد أكملت ربط OpenClaw بـ MiniMax. تابع على صفحة النماذج المحلية:

دروس ذات صلة ​

gaodong.aiAboutPrivacyContact

Independent tutorials, not affiliated with any product mentioned. Product names and trademarks belong to their owners. Check official pages for prices and policies.