MiniMax कनेक्ट करें: M3 सीरीज़ और Coding Plan
OpenClaw से MiniMax कनेक्ट करना देशी मॉडल पेज की पाँचवीं मंज़िल है। MiniMax, OpenClaw में थोड़ा खास है: इसका आधिकारिक प्लगइन बिल्ट-इन है (bundled, OpenClaw इंस्टॉल होते ही साथ आता है, openclaw plugins enable minimax एक कमांड से सक्षम), लेकिन प्रमाणीकरण दो रास्तों में बँटा है — पे-ऐज़-यू-गो API Key वाला minimax पर जाता है, सब्सक्रिप्शन वाला Coding Plan OAuth के minimax-portal पर। पिछले पाठों DeepSeek, Qwen, GLM, Kimi की तीन-चरणीय प्रक्रिया «प्लगइन इंस्टॉल → क्रेडेंशियल कॉन्फ़िगर → मॉडल चुनें» इस पाठ में पूरी तरह लागू होती है, बस शुरुआत में एक «रास्ता चुनें» का प्रश्न जुड़ता है। पूरी प्रक्रिया में लगभग 8 मिनट लगते हैं (MiniMax रजिस्ट्रेशन अलग से)।
पहले आपको एक सारांश तालिका देते हैं, इस पाठ की सारी कॉन्फ़िगरेशन इसी से शुरू होती है (गुण और मान आधिकारिक दस्तावेज़ से जस-के-तस लिए गए हैं):
| रास्ता A: API Key (पे-ऐज़-यू-गो) | रास्ता B: OAuth (Coding Plan) | |
|---|---|---|
| किसके लिए उपयुक्त | पे-ऐज़-यू-गो API उपयोगकर्ता | 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 |
| अतिरिक्त क्षमताएँ | टेक्स्ट + इमेज/म्यूज़िक/वीडियो जनरेशन + इमेज समझ + वॉइस + वेब सर्च | टेक्स्ट + इमेज/म्यूज़िक/वीडियो जनरेशन + इमेज समझ + वॉइस (वेब सर्च नहीं) |
एक बात पहले याद रखना ज़रूरी है: दोनों रास्तों के provider id अलग हैं, इसलिए मॉडल संदर्भ भी अलग हैं — API Key रास्ते पर minimax/MiniMax-M3 लिखें, OAuth रास्ते पर minimax-portal/MiniMax-M3, और मॉडल ID केस-सेंसिटिव होता है। कॉन्फ़िगरेशन में minimax/minimax-m3 जैसा लोअरकेस वेरिएंट लिखने पर OpenClaw उसे पहचान नहीं पाता।
कैसे चुनें, तीन वाक्यों में:
| आपकी स्थिति | यह चुनें |
|---|---|
| पे-ऐज़-यू-गो, M3 / M3.1-Flash पूरा परिवार चाहिए, साथ में वेब सर्च भी | API Key रास्ता (minimax, छह क्षमताएँ सभी चालू) |
| MiniMax Coding Plan सब्सक्राइब किया है, मुख्य रूप से कोड लिखने के लिए उपयोग करते हैं | OAuth रास्ता (minimax-portal, सब्सक्रिप्शन कोटा में उपयोग) |
| दोनों रास्ते उपयोग करना चाहते हैं | दोनों कॉन्फ़िगर करें — provider id अलग हैं, एक-दूसरे को ओवरराइट नहीं करते |
💡 «MiniMax M3» या «MiniMax Coding Plan» से खोजकर आए दोस्तों के लिए
M3 MiniMax का वर्तमान डिफ़ॉल्ट फ़्लैगशिप रीज़निंग मॉडल है, और Coding Plan इसकी सदस्यता (सब्सक्रिप्शन) योजना है। OpenClaw से इसे जोड़ने के लिए MiniMax App का खाता नहीं चाहिए, बल्कि एक बार OAuth लॉगिन (सदस्यता उपयोगकर्ताओं के लिए) या एक API Key (उपयोग-आधारित उपयोगकर्ताओं के लिए) चाहिए — इस पेज पर दोनों रास्ते साफ़-साफ़ समझाए गए हैं।
यह ट्यूटोरियल OpenClaw v2026.10.9 पर आधारित है।
सीखने के बाद आप क्या कर सकते हैं
minimaxऔरminimax-portalदो प्रमाणीकरण रास्तों में अंतर करना: API Key उपयोग-आधारित भुगतान पहले वाले से जाता है, Coding Plan OAuth बाद वाले से — अब दोनों को मिलाकर नहीं चलाना- बिल्ट-इन MiniMax प्लगइन सक्षम करना, चार auth-choice (अंतरराष्ट्रीय/चीन × API/OAuth) के साथ onboarding पूरा करना
- मॉडल कैटलॉग समझना:
MiniMax-M3,MiniMax-M3.1-Flash,MiniMax-M2.7— हर एक की भूमिका, संदर्भ (context) और डिफ़ॉल्ट मान - MiniMax-विशिष्ट जालों से बचना: मॉडल ID केस-संवेदी होते हैं, M3.1-Flash में सोच (thinking) बंद करने पर 400 एरर आता है, M2.x में सोच बंद करने पर भी रीज़निंग टेक्स्ट लीक होता है
- MiniMax की छह-में-एक क्षमताओं का उपयोग करना: इमेज जनरेशन, संगीत, Hailuo वीडियो, TTS वॉयस, इमेज समझ और वेब सर्च
🎒 शुरू करने से पहले की तैयारी
- मॉडल कनेक्शन ओवरव्यू पढ़ चुके हों: provider सिस्टम और मॉडल स्विचिंग: «provider → प्रमाणीकरण → मॉडल चुनाना» तीन चरण और
provider/modelरेफ़रेंस नियम याद रहें - OpenClaw इंस्टॉल हो चुका हो, Gateway चल रहा हो:
openclaw gateway statusका आउटपुट आ रहा हो - पता हो कि आप उपयोग-आधारित भुगतान (API Key) चाहते हैं या Coding Plan की सदस्यता (OAuth) — इसी से तय होता है कि कौन-सा रास्ता लेना है
- सर्वर / डेमन डिप्लॉयमेंट पर जाने पर पता हो कि
~/.openclaw/.envकहाँ है — Key अंततः वहीं रहेगी
मेरे साथ करें
चरण 1: रास्ता तय करें और MiniMax प्लगइन सक्षम करें
क्यों: MiniMax प्लगइन bundled है (OpenClaw के साथ बिल्ट-इन), DeepSeek या Kimi की तरह पहले plugins install नहीं करना पड़ता — openclaw plugins enable minimax से सक्षम करें, फिर Gateway रीस्टार्ट कर दें।
# 1. 启用内置的 MiniMax 插件
openclaw plugins enable minimax
# 2. 重启 Gateway 让插件生效
openclaw gateway restartआपको यह दिखना चाहिए: प्लगइन सक्षम होने का संदेश, और Gateway रीस्टार्ट के बाद कोई एरर नहीं।
सक्षम करने के बाद पहले रास्ते का बहुविकल्पी प्रश्न हल करें (आधिकारिक दस्तावेज़ की अनुशंसित पद्धति):
| आपकी स्थिति | रास्ता | auth-choice |
|---|---|---|
| उपयोग-आधारित API, आप विदेश में हैं या अंतरराष्ट्रीय साइट उपयोग करते हैं | A: API Key (अंतरराष्ट्रीय) | minimax-global-api |
| उपयोग-आधारित API, चीन साइट उपयोग करते हैं | A: API Key (चीन) | 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: OpenClaw से MiniMax जोड़ना — प्रमाणीकरण सेट करना
क्यों: दोनों रास्तों के क्रेडेंशियल पूरी तरह अलग हैं — API Key अक्षरों की एक स्ट्रिंग है, OAuth ब्राउज़र में एक बार user-code लॉगिन है; provider id भी रास्ते के साथ बदलता है (minimax बनाम minimax-portal), गलत रास्ता कॉन्फ़िगर करने पर Key मेल नहीं खाएगी।
रास्ता A: API Key (उपयोग-आधारित भुगतान)
पहले MiniMax ओपन प्लेटफ़ॉर्म पर जाकर एक API Key बनाएँ, कॉपी करके सुरक्षित रखें। फिर onboarding चलाएँ:
# 国际站
openclaw onboard --auth-choice minimax-global-api
# 中国站
openclaw onboard --auth-choice minimax-cn-apiआपको यह दिखना चाहिए: Key सत्यापित होकर सहेज ली गई; अंतरराष्ट्रीय साइट रास्ते का 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 Key नहीं चाहिए, वे 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 token समाप्त होने पर स्वतः उसक्षेत्रीय एंडपॉइंट पर जाकर रिफ़्रेश करता है जिसने उसे मूल रूप से जारी किया था। दो स्थितियों में वह रिफ़्रेश से इनकार करके आपसे दोबारा लॉगिन करवाता है — सहेजा गया लॉगिन रिफ़्रेश समर्थन से पुराना हो (क्षेत्र रिकॉर्ड न हो), या आपने models.providers.minimax-portal.baseUrl को दूसरे क्षेत्र में बदल दिया हो। संदेश दिखे तो openclaw models auth login --provider minimax-portal एक बार दोबारा चलाएँ।
मैन्युअल कॉन्फ़िगरेशन (onboarding न चलाना चाहें तो)
आधिकारिक प्लगइन को मूल रूप से** ज़रूरत नहीं** है models.providers एंट्री लिखने की — प्लगइन सक्षम करें, auth सेट करें, मॉडल चुनें; केवल एंडपॉइंट / मॉडल परिभाषा को स्पष्ट रूप से पिन करना चाहें तभी लिखें। API Key रास्ते का आधिकारिक उदाहरण (जस का तस अंश):
{
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,
},
// ...
],
},
},
},
}तीन मुख्य बातें (आधिकारिक दस्तावेज़ में स्पष्ट लिखी हैं):
baseUrlAnthropic-संगतhttps://api.minimax.io/anthropicको प्राथमिकता दें,apiके साथanthropic-messagesउपयोग करें; OpenAI-संगतhttps://api.minimax.io/v1+openai-completionsवैकल्पिक हैmodels.mode: "merge"MiniMax कैटलॉग को बिल्ट-इन कैटलॉग के साथ सह-अस्तित्व में रखता है, आपके मौजूदा provider मिटाता नहीं- onboarding और सीधी API Key सेटिंग दोनों M3 तथा दो M2.7 वेरिएंट की मॉडल परिभाषाएँ लिखती हैं
Key कहाँ रखें: इंटरैक्टिव शेल में export MINIMAX_API_KEY="<你的 API Key>", या ~/.openclaw/.env में लिखें (डेमन डिप्लॉयमेंट के लिए यही रास्ता अनिवार्य है, नीचे की चेतावनी देखें)। OAuth / Token Plan रास्ते का पर्यावरण चर परिवार MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY है।
⚠️ Gateway डेमन के रूप में चल रहा है? Key इंटरैक्टिव शेल में न रखें
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 per M |
minimax/MiniMax-M3.1-Flash-Preview | रीज़निंग | टेक्स्ट, इमेज | 1,000,000 | 131,072 | पुराना ID, केवल मौजूदा कॉन्फ़िगरेशन के लिए बरकरार |
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 तीनों काम करते हैं;MiniMax-M3.1-Flash-Previewका Token Plan cost फ़ील्ड 0 है, इसका मतलब मुफ़्त नहीं (token-आधारित Preview प्राइसिंग कभी प्रकाशित नहीं हुआ), और अपस्ट्रीम इसे कभी भी बंद कर सकता है—नई कॉन्फ़िगरेशन में हमेशा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 per 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 dashboardControl 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 की आधिकारिक वेबसाइट के अनुसार
- टेस्ट संदेश का उत्तर मिला, provider और मॉडल मेल खाते हैं (
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-choice उपलब्ध हैं)models.providers.minimax(याmodels.providers.minimax-portal) कॉन्फ़िगरेशन ब्लॉक मैन्युअली जोड़ेंMINIMAX_API_KEY,MINIMAX_OAUTH_TOKENया MiniMax auth profile सेट करें, ताकि प्लगइन provider इंजेक्ट कर सके
फिर openclaw models list से दोबारा जाँच करें।
❌ मॉडल ID का केस (case) ग़लत लिखा
लक्षण: कॉन्फ़िगरेशन में मॉडल साफ़ लिखा है, फिर भी अज्ञात मॉडल की त्रुटि आती है।
कारण: MiniMax के मॉडल ID केस-संवेदी (case-sensitive) होते हैं। सही लेखन है MiniMax-M3, MiniMax-M2.7, MiniMax-M2.7-highspeed—minimax-m3, MINIMAX-M3 कोई भी नहीं चलेगा।
सही तरीका: इस पेज की डायरेक्टरी टेबल के लेखन को जस का तस कॉपी करें; प्रीफ़िक्स प्रमाणीकरण रूट के अनुसार रखें (minimax/ या minimax-portal/)।
❌ M3.1-Flash पर /think off से HTTP 400 त्रुटि
कारण: MiniMax-M3.1-Flash (पुराना ID MiniMax-M3.1-Flash-Preview शामिल) adaptive thinking माँगता है—MiniMax disabled thinking अस्वीकार करता है और सीधे HTTP 400 लौटा देता है। इसलिए OpenClaw इसके लिए off विकल्प देता ही नहीं, /think केवल low / medium / high / xhigh / max पाँच स्तर देता है, डिफ़ॉल्ट max।
सही तरीका: M3.1-Flash पर सोच (thinking) बंद न करें; सचमुच बंद करना चाहें तो MiniMax-M3 (off / adaptive दो स्तर) या M2.x सीरीज़ पर जाएँ।
❌ M2.7 पर सोच बंद की, फिर भी उत्तर में रीज़निंग टेक्स्ट मिल जाता है
कारण: आधिकारिक Warning साफ़ कहता है—M2.x Anthropic-संगत पाथ पर OpenAI शैली के स्ट्रीमिंग delta में reasoning_content आउटपुट कर सकता है, जिससे रीज़निंग दृश्य आउटपुट में उजागर हो जाती है। OpenClaw डिफ़ॉल्ट रूप से thinking: { type: "disabled" } भेजता है, लेकिन MiniMax दस्तावेज़ के अनुसार M2.x इस सेटिंग को स्वीकार कर अनदेखा कर देता है, सोच चलती रहती है, रीज़निंग लीक होती रहती है।
सही तरीका: साफ़ आउटपुट की परवाह है तो M2.x पर सोच बंद करके ज़बरदस्ती न चलें; M3 पर जाएँ (डिफ़ॉल्ट adaptive, OpenClaw M3 के लिए अंतर्निहित disabled डिफ़ॉल्ट हटा देता है)।
❌ OAuth token रिफ़्रेश अस्वीकृत, दोबारा लॉगिन करने को कहता है
कारण: दो स्थितियाँ—सहेजा गया लॉगिन रिफ़्रेश सपोर्ट से पुराना है (जारी क्षेत्र रिकॉर्ड नहीं है), या models.providers.minimax-portal.baseUrl दूसरे क्षेत्र (अंतरराष्ट्रीय ↔ चीन) में बदल दिया गया है, OpenClaw क्रॉस-क्षेत्र रिफ़्रेश अस्वीकार करता है।
सही तरीका: संकेत के अनुसार openclaw models auth login --provider minimax-portal दोबारा चलाएँ; baseUrl को मैन्युअली दूसरे क्षेत्र में न बदलें।
❌ Gateway को डेमन के रूप में इंस्टॉल करने के बाद export किया Key "कार्य नहीं करता"
कारण: launchd / systemd सेवाएँ इंटरैक्टिव shell के environment वेरिएबल नहीं देख सकतीं—हर provider दस्तावेज़ बार-बार इस बात पर ज़ोर देता है।
सही तरीका: MINIMAX_API_KEY को ~/.openclaw/.env में लिखें, या कॉन्फ़िगरेशन के env.shellEnv से दें; Key बदलने के बाद Gateway सेवा रीस्टार्ट करें।
❌ baseUrl सेट किया, पर इमेज जनरेशन उससे नहीं गया
कारण: इमेज जनरेशन हमेशा MiniMax-विशेष इमेज एंडपॉइंट पर जाता है (/v1/image_generation), और models.providers.minimax.baseUrl को अनदेखा करता है—वह फ़ील्ड केवल चैट / Anthropic-संगत पाथ के लिए है।
सही तरीका: इमेज जनरेशन को चीन साइट पर चलाना चाहें तो MINIMAX_API_HOST=https://api.minimaxi.com सेट करें (डिफ़ॉल्ट अंतरराष्ट्रीय साइट https://api.minimax.io)।
🔧 MiniMax-विशेष क्षमताएँ (वैकल्पिक)
MiniMax प्लगइन सिर्फ़ चैट नहीं—यह एक बार में दो चैट 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 सर्च API (/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 रूट) पर उपलब्ध है: OAuth केminimax-portalमें यह क्षमता नहीं है। सर्च के लिए पहले पर्यावरण वेरिएबलMINIMAX_CODE_PLAN_KEYप्राथमिकता पाता है,MINIMAX_CODING_API_KEYऔरMINIMAX_OAUTH_TOKENभी स्वीकार्य हैं; कॉन्फ़िगरेशनplugins.entries.minimax.config.webSearch.*में - TTS प्रमाणीकरण की एक प्राथमिकता क्रम है:
tts.providers.minimax.apiKey→minimax-portalका OAuth/token → Token Plan पर्यावरण वेरिएबल →MINIMAX_API_KEY; जब TTS host कॉन्फ़िगर न हो तो OAuth host पुनः उपयोग होता है और/anthropicजैसे सफ़िक्स हटा दिए जाते हैं - वॉइस मैसेज ट्रांसकोडिंग: फ़ेइशू, Telegram जैसे वॉइस नोट माँगने वाले चैनलों के लिए OpenClaw
ffmpegसे MiniMax MP3 को 48kHz Opus में बदलता है (फ़ेइशू फ़ाइल API सिर्फ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 (लेकिन अपस्ट्रीम disabled स्वीकार करके नज़रअंदाज़ करता है) |
/fast on (या params.fastMode: true) MiniMax-M2.7 को MiniMax-M2.7-highspeed में फिर से लिखता है — यह सिर्फ Anthropic-संगत पाथ पर लागू होता है।
Coding Plan उपयोग क्वेरी
सब्सक्रिप्शन उपयोगकर्ता जानना चाहते हैं कि कोटा में कितना बचा है: OpenClaw MiniMax के उपयोग API (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 जोड़ना यहीं पूरा हुआ। घरेलू मॉडल स्पेशल पेज आगे जारी रखें:
- अगला पाठ डूबाओ/वोल्केन इंजन जोड़ना: फ़ांगआर्क एंडपॉइंट और Coding Plan: "पे-एज़-यूज़ + Coding Plan" दोहरे रूट वाला एक और घरेलू provider
- अन्य मॉडल स्पेशल पेज (हुनयुआन/क़ियानफ़ैन, रिले और लोकल मॉडल) मॉडल कनेक्शन ओवरव्यू के पाठ्यक्रम सूची से शुरू करें
- मॉडल कॉन्फ़िगर हो गया? रोज़मर्रा का उपयोग रोज़मर्रा का उपयोग: अपने Claw के साथ कुशलता से काम करना से शुरू करें — Control UI, चैट कमांड, मेमोरी सिस्टम सब उसी अध्याय में हैं