ربط 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) | minimax | minimax-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-api | minimax-global-oauth |
| auth-choice (الموقع الصيني) | minimax-cn-api | minimax-cn-oauth |
| بادئة مرجع الموديل | minimax/... | minimax-portal/... |
| الموديل الافتراضي | MiniMax-M3 | MiniMax-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.
# 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:
# 国际站
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).
تحقق من الدليل على الفور:
openclaw models list --provider minimaxما يجب أن تراه: عائلة نماذج MiniMax-M3 وMiniMax-M3.1-Flash وMiniMax-M2.7 ظاهرة في القائمة.
المسار B: OAuth (اشتراك Coding Plan)
مستخدمو اشتراك Coding Plan لا يحتاجون إلى مفتاح API، بل يسلكون تسجيل دخول OAuth (عملية user-code، تمنحك رمزًا لتأكيده في المتصفح):
# 国际站
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 يضبط النموذج الافتراضي أيضًا):
openclaw models auth login --provider minimax-portal --set-defaultتحقق من الدليل على الفور:
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 (مقتطف كما هو):
{
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,000 | 131,072 | افتراضي، hosted reasoning |
minimax/MiniMax-M3.1-Flash | استدلال | نص، صور | 1,000,000 | 131,072 | مستوى effort قابل للتعديل؛$0.15 / $0.60 / $0.015 لكل M |
minimax/MiniMax-M3.1-Flash-Preview | استدلال | نص، صور | 1,000,000 | 131,072 | معرّف قديم، محفوظ فقط للإعدادات القائمة |
minimax/MiniMax-M2.7 | استدلال | نص | 204,800 | 131,072 | الجيل السابق من hosted reasoning |
minimax/MiniMax-M2.7-highspeed | استدلال | نص | 204,800 | 131,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 سيتم التبديل إليه تلقائيًا |
تغيير النموذج الافتراضي (لاحظ أن البادئة تتبع المسار):
# API Key 路线
openclaw models set minimax/MiniMax-M3
# OAuth 路线
openclaw models set minimax-portal/MiniMax-M3يمكن أيضًا التبديل مؤقتًا في الدردشة: /model minimax/MiniMax-M3.1-Flash يؤثر فقط على الجلسة الحالية، ولتفاصيل عائلة الأوامر راجع دليل سريع لأوامر الدردشة.
أخيرًا التحقق. أرسل رسالة اختبار:
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-01 | minimax/image-01 | توليد من نص + تحرير من صورة؛ حتى 9 صور في الطلب الواحد؛ نسب العرض إلى الارتفاع 1:1 / 16:9 / 4:3 / 3:2 / 2:3 / 3:4 / 9:16 / 21:9 |
| توليد الموسيقى | music-2.6 | minimax/music-2.6 | تتوفر أيضًا music-2.6-free وmusic-cover وmusic-cover-free؛ المخرجات mp3 |
| توليد الفيديو | MiniMax-Hailuo-2.3 | minimax/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 فقط |
تعيين إحدى القدرات كنموذج وسائط افتراضي (كما في المثال الرسمي حرفيًا، باستخدام الصور مثالًا):
{
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-M3 | off / adaptive | adaptive |
MiniMax-M3.1-Flash | low / medium / high / xhigh / max | max (لا يُقدَّم خيار off، وإيقافه يُرجع 400) |
MiniMax-M2.x | off / minimal / low / medium / high | off (لكن الخدمة 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:
{
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. تابع على صفحة النماذج المحلية:
- الدرس التالي ربط Doubao/Volcengine: نقطة نهاية Ark وCoding Plan: مزوّد محلي آخر بمسارَي «الدفع حسب الاستخدام + Coding Plan»
- صفحات النماذج الأخرى (Hunyuan/Qianfan، النقل المخصص والنماذج المحلية) تبدأ من جدول الدروس في نظرة عامة على ربط النماذج
- هل اكتمل إعداد النماذج؟ الاستخدام اليومي يبدأ من الاستخدام اليومي: التعامل بكفاءة مع Claw الخاص بك — واجهة Control UI وأوامر الدردشة ونظام الذاكرة كلها في ذلك الفصل