MiniMax

OpenClaw's MiniMax provider defaults to MiniMax M3.

MiniMax همچنین ارائه می‌کند:

• سنتز گفتار همراه از طریق T2A v2
• درک تصویر همراه از طریق MiniMax-VL-01
• تولید موسیقی همراه از طریق music-2.6
• web_search همراه از طریق API جست‌وجوی MiniMax Token Plan

تفکیک ارائه‌دهنده:

کاتالوگ داخلی

شروع به کار

روش احراز هویت دلخواه خود را انتخاب کنید و مراحل راه‌اندازی را دنبال کنید.

openclaw onboard --auth-choice minimax-global-oauth

openclaw models list --provider minimax-portal

openclaw onboard --auth-choice minimax-cn-oauth

openclaw models list --provider minimax-portal

openclaw onboard --auth-choice minimax-global-api

openclaw models list --provider minimax

openclaw onboard --auth-choice minimax-cn-api

openclaw models list --provider minimax

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

پیکربندی از طریق openclaw configure

از جادوگر پیکربندی تعاملی برای تنظیم MiniMax بدون ویرایش JSON استفاده کنید:

openclaw configure

قابلیت‌ها

تولید تصویر

Plugin MiniMax مدل image-01 را برای ابزار image_generate ثبت می‌کند. پشتیبانی می‌کند از:

• تولید متن‌به‌تصویر با کنترل نسبت تصویر
• ویرایش تصویر‌به‌تصویر (ارجاع سوژه) با کنترل نسبت تصویر
• تا ۹ تصویر خروجی در هر درخواست
• تا ۱ تصویر مرجع در هر درخواست ویرایش
• نسبت‌های تصویر پشتیبانی‌شده: 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 را پیکربندی می‌کند. برای مسیریابی تولید تصویر از طریق نقطه پایانی CN، MINIMAX_API_HOST=https://api.minimaxi.com را تنظیم کنید؛ نقطه پایانی جهانی پیش‌فرض https://api.minimax.io است.

وقتی onboarding یا راه‌اندازی کلید API ورودی‌های صریح models.providers.minimax را می‌نویسد، OpenClaw، MiniMax-M3، MiniMax-M2.7 و MiniMax-M2.7-highspeed را به‌عنوان مدل‌های چت مادی‌سازی می‌کند. M3 ورودی متن و تصویر را اعلام می‌کند؛ درک تصویر همچنان جداگانه از طریق ارائه‌دهنده رسانه مالک Plugin MiniMax-VL-01 ارائه می‌شود.

تبدیل متن به گفتار

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، سپس کلیدهای محیطی Token Plan (MINIMAX_OAUTH_TOKEN، MINIMAX_CODE_PLAN_KEY، MINIMAX_CODING_API_KEY)، سپس MINIMAX_API_KEY است.
• اگر هیچ میزبان TTS پیکربندی نشده باشد، OpenClaw میزبان OAuth پیکربندی‌شده minimax-portal را دوباره استفاده می‌کند و پسوندهای مسیر سازگار با Anthropic مانند /anthropic را حذف می‌کند.
• پیوست‌های صوتی معمولی MP3 باقی می‌مانند.
• مقصدهای voice-note مانند Feishu و Telegram از MP3 MiniMax با ffmpeg به Opus با ۴۸kHz تبدیل می‌شوند، چون API فایل Feishu/Lark فقط file_type: "opus" را برای پیام‌های صوتی بومی می‌پذیرد.
• MiniMax T2A مقدارهای کسری speed و vol را می‌پذیرد، اما pitch به‌صورت عدد صحیح ارسال می‌شود؛ OpenClaw مقدارهای کسری pitch را پیش از درخواست API کوتاه می‌کند.

تولید موسیقی

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
• قالب خروجی: 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",      },    },  },}

درک تصویر

Plugin MiniMax درک تصویر را جدا از کاتالوگ متن ثبت می‌کند:

به همین دلیل مسیریابی خودکار رسانه می‌تواند از درک تصویر MiniMax استفاده کند، حتی وقتی کاتالوگ ارائه‌دهنده متن همراه، ارجاع‌های چت M3 دارای قابلیت تصویر را نیز شامل می‌شود.

جست‌وجوی وب

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.* قرار دارد.

پیکربندی پیشرفته

{  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: minimax/<model>
  • راه‌اندازی OAuth: minimax-portal/<model>
• مدل چت پیش‌فرض: MiniMax-M3
• مدل‌های چت جایگزین: MiniMax-M2.7، MiniMax-M2.7-highspeed
• onboarding و راه‌اندازی مستقیم کلید API تعریف‌های مدل را برای M3 و هر دو گونه M2.7 می‌نویسند
• درک تصویر از ارائه‌دهنده رسانه MiniMax-VL-01 متعلق به Plugin استفاده می‌کند
• اگر به رهگیری دقیق هزینه نیاز دارید، مقدارهای قیمت‌گذاری را در models.json به‌روزرسانی کنید
• برای تایید شناسه ارائه‌دهنده فعلی از openclaw models list استفاده کنید، سپس با openclaw models set minimax/MiniMax-M3 یا openclaw models set minimax-portal/MiniMax-M3 تغییر دهید

عیب‌یابی

openclaw models list

مرتبط