--- read_when: - می‌خواهید مدل‌های MiniMax را در OpenClaw داشته باشید - به راهنمای راه‌اندازی MiniMax نیاز دارید summary: از مدل‌های MiniMax در OpenClaw استفاده کنید title: MiniMax x-i18n: generated_at: "2026-05-02T11:59:52Z" model: gpt-5.5 provider: openai source_hash: 7c7aea4d9656d6ffddab7c43b06940e58bdd119a03b62000e689a3348f7df5a2 source_path: providers/minimax.md workflow: 16 --- OpenClaw's MiniMax provider defaults to **MiniMax M2.7**. MiniMax also provides: - Bundled speech synthesis via T2A v2 - Bundled image understanding via `MiniMax-VL-01` - Bundled music generation via `music-2.6` - Bundled `web_search` through the MiniMax Token Plan search API Provider split: | Provider ID | Auth | Capabilities | | ---------------- | ------- | --------------------------------------------------------------------------------------------------- | | `minimax` | API key | Text, image generation, music generation, video generation, image understanding, speech, web search | | `minimax-portal` | OAuth | Text, image generation, music generation, video generation, image understanding, speech | ## Built-in catalog | Model | Type | Description | | ------------------------ | ---------------- | ---------------------------------------- | | `MiniMax-M2.7` | Chat (reasoning) | Default hosted reasoning model | | `MiniMax-M2.7-highspeed` | Chat (reasoning) | Faster M2.7 reasoning tier | | `MiniMax-VL-01` | Vision | Image understanding model | | `image-01` | Image generation | Text-to-image and image-to-image editing | | `music-2.6` | Music generation | Default music model | | `music-2.5` | Music generation | Previous music generation tier | | `music-2.0` | Music generation | Legacy music generation tier | | `MiniMax-Hailuo-2.3` | Video generation | Text-to-video and image reference flows | ## Getting started Choose your preferred auth method and follow the setup steps. **Best for:** quick setup with MiniMax Coding Plan via OAuth, no API key required. ```bash openclaw onboard --auth-choice minimax-global-oauth ``` This authenticates against `api.minimax.io`. ```bash openclaw models list --provider minimax-portal ``` ```bash openclaw onboard --auth-choice minimax-cn-oauth ``` This authenticates against `api.minimaxi.com`. ```bash openclaw models list --provider minimax-portal ``` OAuth setups use the `minimax-portal` provider id. Model refs follow the form `minimax-portal/MiniMax-M2.7`. Referral link for MiniMax Coding Plan (10% off): [MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link) **Best for:** hosted MiniMax with Anthropic-compatible API. ```bash openclaw onboard --auth-choice minimax-global-api ``` This configures `api.minimax.io` as the base URL. ```bash openclaw models list --provider minimax ``` ```bash openclaw onboard --auth-choice minimax-cn-api ``` This configures `api.minimaxi.com` as the base URL. ```bash openclaw models list --provider minimax ``` ### Config example ```json5 { 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, }, ], }, }, }, } ``` On the Anthropic-compatible streaming path, OpenClaw disables MiniMax thinking by default unless you explicitly set `thinking` yourself. MiniMax's streaming endpoint emits `reasoning_content` in OpenAI-style delta chunks instead of native Anthropic thinking blocks, which can leak internal reasoning into visible output if left enabled implicitly. API-key setups use the `minimax` provider id. Model refs follow the form `minimax/MiniMax-M2.7`. ## Configure via `openclaw configure` Use the interactive config wizard to set MiniMax without editing JSON: ```bash openclaw configure ``` از منو، **مدل/احراز هویت** را انتخاب کنید. یکی از گزینه‌های موجود MiniMax را انتخاب کنید: | انتخاب احراز هویت | توضیح | | --- | --- | | `minimax-global-oauth` | OAuth بین‌المللی (طرح کدنویسی) | | `minimax-cn-oauth` | OAuth چین (طرح کدنویسی) | | `minimax-global-api` | کلید API بین‌المللی | | `minimax-cn-api` | کلید API چین | هنگام نمایش درخواست، مدل پیش‌فرض خود را انتخاب کنید. ## قابلیت‌ها ### تولید تصویر Plugin مربوط به MiniMax مدل `image-01` را برای ابزار `image_generate` ثبت می‌کند. این مدل از موارد زیر پشتیبانی می‌کند: - **تولید متن به تصویر** با کنترل نسبت تصویر - **ویرایش تصویر به تصویر** (مرجع سوژه) با کنترل نسبت تصویر - تا **9 تصویر خروجی** در هر درخواست - تا **1 تصویر مرجع** در هر درخواست ویرایش - نسبت‌های تصویر پشتیبانی‌شده: `1:1`، `16:9`، `4:3`، `3:2`، `2:3`، `3:4`، `9:16`، `21:9` برای استفاده از MiniMax برای تولید تصویر، آن را به‌عنوان ارائه‌دهنده تولید تصویر تنظیم کنید: ```json5 { 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` را تنظیم کنید؛ نقطه پایانی جهانی پیش‌فرض `https://api.minimax.io` است. وقتی ورود اولیه یا راه‌اندازی کلید API ورودی‌های صریح `models.providers.minimax` را می‌نویسد، OpenClaw مدل‌های `MiniMax-M2.7` و `MiniMax-M2.7-highspeed` را به‌عنوان مدل‌های چت فقط متنی ایجاد می‌کند. درک تصویر به‌صورت جداگانه از طریق ارائه‌دهنده رسانه `MiniMax-VL-01` تحت مالکیت Plugin ارائه می‌شود. برای پارامترهای مشترک ابزار، انتخاب ارائه‌دهنده و رفتار failover، [تولید تصویر](/fa/tools/image-generation) را ببینید. ### تبدیل متن به گفتار 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/token مربوط به `minimax-portal`، سپس کلیدهای محیطی Token Plan (`MINIMAX_OAUTH_TOKEN`، `MINIMAX_CODE_PLAN_KEY`، `MINIMAX_CODING_API_KEY`) و سپس `MINIMAX_API_KEY` است. - اگر میزبان TTS پیکربندی نشده باشد، OpenClaw از میزبان OAuth پیکربندی‌شده `minimax-portal` دوباره استفاده می‌کند و پسوندهای مسیر سازگار با Anthropic مانند `/anthropic` را حذف می‌کند. - پیوست‌های صوتی معمولی به‌صورت MP3 باقی می‌مانند. - مقصدهای یادداشت صوتی مانند Feishu و Telegram از MP3 تولیدشده توسط MiniMax با `ffmpeg` به Opus با نرخ 48kHz تبدیل می‌شوند، زیرا API فایل Feishu/Lark فقط `file_type: "opus"` را برای پیام‌های صوتی بومی می‌پذیرد. - MiniMax T2A مقادیر اعشاری `speed` و `vol` را می‌پذیرد، اما `pitch` به‌صورت عدد صحیح ارسال می‌شود؛ OpenClaw پیش از درخواست API، بخش اعشاری مقادیر `pitch` را حذف می‌کند. | تنظیمات | متغیر محیطی | پیش‌فرض | توضیح | | ---------------------------------------- | ---------------------- | ----------------------------- | -------------------------------- | | `messages.tts.providers.minimax.baseUrl` | `MINIMAX_API_HOST` | `https://api.minimax.io` | میزبان API مربوط به MiniMax T2A. | | `messages.tts.providers.minimax.model` | `MINIMAX_TTS_MODEL` | `speech-2.8-hd` | شناسه مدل TTS. | | `messages.tts.providers.minimax.voiceId` | `MINIMAX_TTS_VOICE_ID` | `English_expressive_narrator` | شناسه صدای استفاده‌شده برای خروجی گفتار. | | `messages.tts.providers.minimax.speed` | | `1.0` | سرعت پخش، `0.5..2.0`. | | `messages.tts.providers.minimax.vol` | | `1.0` | حجم صدا، `(0, 10]`. | | `messages.tts.providers.minimax.pitch` | | `0` | تغییر زیر و بمی عدد صحیح، `-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 به‌عنوان ارائه‌دهنده پیش‌فرض موسیقی: ```json5 { agents: { defaults: { musicGenerationModel: { primary: "minimax/music-2.6", }, }, }, } ``` برای پارامترهای مشترک ابزار، انتخاب ارائه‌دهنده و رفتار failover، [تولید موسیقی](/fa/tools/music-generation) را ببینید. ### تولید ویدئو Plugin بسته‌بندی‌شده MiniMax تولید ویدئو را از طریق ابزار مشترک `video_generate` برای هر دو `minimax` و `minimax-portal` ثبت می‌کند. - مدل ویدئوی پیش‌فرض: `minimax/MiniMax-Hailuo-2.3` - مدل ویدئوی OAuth: `minimax-portal/MiniMax-Hailuo-2.3` - حالت‌ها: جریان‌های متن به ویدئو و مرجع تک‌تصویر - از `aspectRatio` و `resolution` پشتیبانی می‌کند برای استفاده از MiniMax به‌عنوان ارائه‌دهنده پیش‌فرض ویدئو: ```json5 { agents: { defaults: { videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3", }, }, }, } ``` برای پارامترهای ابزار مشترک، انتخاب ارائه‌دهنده، و رفتار failover، [تولید ویدئو](/fa/tools/video-generation) را ببینید. ### درک تصویر Plugin MiniMax درک تصویر را جدا از کاتالوگ متنی ثبت می‌کند: | شناسه ارائه‌دهنده | مدل تصویر پیش‌فرض | | ---------------- | ------------------- | | `minimax` | `MiniMax-VL-01` | | `minimax-portal` | `MiniMax-VL-01` | به همین دلیل مسیریابی خودکار رسانه می‌تواند از درک تصویر MiniMax استفاده کند، حتی وقتی کاتالوگ ارائه‌دهنده متن همراه هنوز ارجاع‌های چت فقط‌متنی M2.7 را نشان می‌دهد. ### جست‌وجوی وب Plugin MiniMax همچنین `web_search` را از طریق API جست‌وجوی MiniMax Token Plan ثبت می‌کند. - شناسه ارائه‌دهنده: `minimax` - نتایج ساختاریافته: عنوان‌ها، URLها، بریده‌ها، پرس‌وجوهای مرتبط - متغیر محیطی ترجیحی: `MINIMAX_CODE_PLAN_KEY` - نام‌های مستعار محیطی پذیرفته‌شده: `MINIMAX_CODING_API_KEY`، `MINIMAX_OAUTH_TOKEN` - fallback سازگاری: `MINIMAX_API_KEY` وقتی از قبل به یک اعتبار token-plan اشاره می‌کند - استفاده مجدد از منطقه: `plugins.entries.minimax.config.webSearch.region`، سپس `MINIMAX_API_HOST`، سپس URLهای پایه ارائه‌دهنده MiniMax - جست‌وجو روی شناسه ارائه‌دهنده `minimax` می‌ماند؛ راه‌اندازی OAuth چین/جهانی می‌تواند منطقه را به‌طور غیرمستقیم از طریق `models.providers.minimax-portal.baseUrl` هدایت کند و می‌تواند احراز هویت bearer را از طریق `MINIMAX_OAUTH_TOKEN` فراهم کند پیکربندی زیر `plugins.entries.minimax.config.webSearch.*` قرار دارد. برای پیکربندی کامل جست‌وجوی وب و نحوه استفاده، [جست‌وجوی MiniMax](/fa/tools/minimax-search) را ببینید. ## پیکربندی پیشرفته | گزینه | توضیح | | --- | --- | | `models.providers.minimax.baseUrl` | `https://api.minimax.io/anthropic` را ترجیح دهید (سازگار با Anthropic)؛ `https://api.minimax.io/v1` برای payloadهای سازگار با OpenAI اختیاری است | | `models.providers.minimax.api` | `anthropic-messages` را ترجیح دهید؛ `openai-completions` برای payloadهای سازگار با OpenAI اختیاری است | | `models.providers.minimax.apiKey` | کلید API MiniMax (`MINIMAX_API_KEY`) | | `models.providers.minimax.models` | `id`، `name`، `reasoning`، `contextWindow`، `maxTokens`، `cost` را تعریف کنید | | `agents.defaults.models` | مدل‌هایی را که در allowlist می‌خواهید alias کنید | | `models.mode` | اگر می‌خواهید MiniMax را در کنار موارد داخلی اضافه کنید، `merge` را نگه دارید | روی `api: "anthropic-messages"`، OpenClaw مقدار `thinking: { type: "disabled" }` را تزریق می‌کند، مگر اینکه thinking از قبل به‌صراحت در params/config تنظیم شده باشد. این کار جلوی endpoint استریم MiniMax را می‌گیرد تا `reasoning_content` را در قطعه‌های delta به سبک OpenAI منتشر نکند؛ چیزی که می‌توانست استدلال داخلی را به خروجی قابل مشاهده نشت دهد. `/fast on` یا `params.fastMode: true` مقدار `MiniMax-M2.7` را در مسیر stream سازگار با Anthropic به `MiniMax-M2.7-highspeed` بازنویسی می‌کند. **بهترین برای:** قوی‌ترین مدل نسل جدید خود را به‌عنوان مدل اصلی نگه دارید و در صورت شکست به MiniMax M2.7 بروید. نمونه زیر از Opus به‌عنوان مدل اصلی مشخص استفاده می‌کند؛ آن را با مدل اصلی نسل جدید دلخواه خود جایگزین کنید. ```json5 { 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"], }, }, }, } ``` - API استفاده 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های پایه ناقص یا بدشکل برای سازگاری fallback چین را نگه می‌دارند. - OpenClaw استفاده coding-plan MiniMax را به همان نمایش `% left` که دیگر ارائه‌دهندگان استفاده می‌کنند، نرمال‌سازی می‌کند. فیلدهای خام `usage_percent` / `usagePercent` MiniMax سهمیه باقی‌مانده هستند، نه سهمیه مصرف‌شده؛ بنابراین OpenClaw آن‌ها را معکوس می‌کند. وقتی فیلدهای مبتنی بر شمارش وجود داشته باشند، اولویت دارند. - وقتی API مقدار `model_remains` را برمی‌گرداند، OpenClaw ورودی مدل چت را ترجیح می‌دهد، در صورت نیاز برچسب پنجره را از `start_time` / `end_time` استخراج می‌کند، و نام مدل انتخاب‌شده را در برچسب طرح می‌آورد تا پنجره‌های coding-plan آسان‌تر از هم تشخیص داده شوند. - snapshotهای استفاده، `minimax`، `minimax-cn`، و `minimax-portal` را به‌عنوان همان سطح سهمیه MiniMax در نظر می‌گیرند، و پیش از fallback به متغیرهای محیطی کلید Coding Plan، OAuth ذخیره‌شده MiniMax را ترجیح می‌دهند. ## یادداشت‌ها - ارجاع‌های مدل مسیر احراز هویت را دنبال می‌کنند: - راه‌اندازی با کلید API: `minimax/` - راه‌اندازی OAuth: `minimax-portal/` - مدل چت پیش‌فرض: `MiniMax-M2.7` - مدل چت جایگزین: `MiniMax-M2.7-highspeed` - onboarding و راه‌اندازی مستقیم با کلید API، تعریف‌های مدل فقط‌متنی را برای هر دو گونه 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 (۱۰٪ تخفیف): [MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link) برای قواعد ارائه‌دهنده، [ارائه‌دهندگان مدل](/fa/concepts/model-providers) را ببینید. ## عیب‌یابی این معمولاً یعنی **ارائه‌دهنده 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 تا ارائه‌دهنده منطبق بتواند تزریق شود. مطمئن شوید شناسه مدل **به بزرگی و کوچکی حروف حساس است**: - مسیر کلید API: `minimax/MiniMax-M2.7` یا `minimax/MiniMax-M2.7-highspeed` - مسیر OAuth: `minimax-portal/MiniMax-M2.7` یا `minimax-portal/MiniMax-M2.7-highspeed` سپس با دستور زیر دوباره بررسی کنید: ```bash openclaw models list ``` راهنمای بیشتر: [عیب‌یابی](/fa/help/troubleshooting) و [پرسش‌های متداول](/fa/help/faq). ## مرتبط انتخاب ارائه‌دهندگان، ارجاع‌های مدل، و رفتار failover. پارامترهای ابزار تصویر مشترک و انتخاب ارائه‌دهنده. پارامترهای ابزار موسیقی مشترک و انتخاب ارائه‌دهنده. پارامترهای ابزار ویدئوی مشترک و انتخاب ارائه‌دهنده. پیکربندی جست‌وجوی وب از طریق MiniMax Token Plan. عیب‌یابی عمومی و پرسش‌های متداول.