MiniMax

Plugin همراه minimax دو ارائه‌دهنده و هفت قابلیت را ثبت می‌کند: گفت‌وگو، تولید تصویر، تولید موسیقی، تولید ویدئو، درک تصویر، گفتار (T2A v2) و جست‌وجوی وب.

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

ارجاع‌های مدل از مسیر احراز هویت پیروی می‌کنند: برای راه‌اندازی‌های مبتنی بر کلید API از minimax/<model> و برای راه‌اندازی‌های OAuth از minimax-portal/<model> استفاده کنید.

شروع به کار

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

openclaw configure

قابلیت‌ها

تولید تصویر

Plugin مربوط به MiniMax، مدل image-01 را برای ابزار image_generate در هر دو ارائه‌دهنده minimax و minimax-portal ثبت می‌کند و از همان MINIMAX_API_KEY یا احراز هویت OAuth مدل‌های متنی استفاده می‌کند.

• تولید تصویر از متن و ویرایش تصویر به تصویر (مرجع سوژه)، هر دو با قابلیت کنترل نسبت ابعاد
• حداکثر ۹ تصویر خروجی در هر درخواست و ۱ تصویر مرجع در هر درخواست ویرایش
• نسبت‌های ابعاد پشتیبانی‌شده: 1:1، 16:9، 4:3، 3:2، 2:3، 3:4، 9:16، 21:9

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

تولید تصویر همیشه از نقطه پایانی اختصاصی تصویر MiniMax (/v1/image_generation) استفاده می‌کند و models.providers.minimax.baseUrl را نادیده می‌گیرد، زیرا آن فیلد به‌جای آن، نشانی پایه سازگار با چت/Anthropic را پیکربندی می‌کند. برای هدایت تولید تصویر از طریق نقطه پایانی چین، MINIMAX_API_HOST=https://api.minimaxi.com را تنظیم کنید؛ نقطه پایانی جهانی پیش‌فرض https://api.minimax.io است.

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

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

تولید موسیقی

Plugin همراه MiniMax، تولید موسیقی را از طریق ابزار مشترک music_generate برای هر دو ارائه‌دهنده minimax و minimax-portal ثبت می‌کند.

• مدل پیش‌فرض موسیقی: minimax/music-2.6‏ (OAuth: ‏minimax-portal/music-2.6)
• همچنین از music-2.6-free، music-cover و music-cover-free پشتیبانی می‌کند
• کنترل‌های اعلان: lyrics، instrumental
• قالب خروجی: mp3
• اجراهای متکی به نشست، از طریق روند مشترک وظیفه/وضعیت جدا می‌شوند، از جمله action: "status"

{  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)
• همچنین از MiniMax-Hailuo-2.3-Fast، MiniMax-Hailuo-02، I2V-01-Director، I2V-01-live و I2V-01 پشتیبانی می‌کند
• حالت‌ها: تبدیل متن به ویدئو و روندهای دارای مرجع تک‌تصویری
• از resolution (مقادیر 768P یا 1080P در مدل‌های Hailuo 2.3/02) پشتیبانی می‌کند؛ aspectRatio پشتیبانی نمی‌شود و نادیده گرفته می‌شود

{  agents: {    defaults: {      videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" },    },  },}

درک تصویر

Plugin مینی‌مکس، قابلیت درک تصویر را جدا از فهرست متنی ثبت می‌کند:

به همین دلیل، مسیریابی خودکار رسانه می‌تواند حتی زمانی که فهرست همراهِ ارائه‌دهندگان متن شامل ارجاع‌های گفت‌وگوی M3 با قابلیت پردازش تصویر نیز هست، از قابلیت درک تصویر مینی‌مکس استفاده کند. درک PDF فقط برای استخراج متن از MiniMax-M2.7 استفاده می‌کند؛ مینی‌مکس هیچ مسیر تبدیل PDF به تصویر را ثبت نمی‌کند.

جست‌وجوی وب

Plugin مینی‌مکس همچنین web_search را از طریق API جست‌وجوی طرح توکن مینی‌مکس (/v1/coding_plan/search) ثبت می‌کند.

• شناسه ارائه‌دهنده: minimax
• نتایج ساخت‌یافته: عنوان‌ها، نشانی‌های اینترنتی، گزیده‌ها و پرس‌وجوهای مرتبط
• متغیر محیطی ترجیحی: MINIMAX_CODE_PLAN_KEY
• نام‌های مستعار پذیرفته‌شده برای متغیر محیطی: MINIMAX_CODING_API_KEY، MINIMAX_OAUTH_TOKEN
• مسیر جایگزین سازگاری: MINIMAX_API_KEY، در صورتی که از قبل به اعتبارنامه طرح توکن اشاره کند
• استفاده مجدد از منطقه: ابتدا plugins.entries.minimax.config.webSearch.region، سپس MINIMAX_API_HOST و بعد نشانی‌های پایه ارائه‌دهنده مینی‌مکس
• جست‌وجو روی شناسه ارائه‌دهنده minimax باقی می‌ماند؛ راه‌اندازی OAuth چین/جهانی می‌تواند از طریق models.providers.minimax-portal.baseUrl به‌طور غیرمستقیم منطقه را هدایت کند و از طریق MINIMAX_OAUTH_TOKEN احراز هویت Bearer را فراهم کند

پیکربندی زیر 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"],      },    },  },}

یادداشت‌ها

• مدل پیش‌فرض گفت‌وگو: MiniMax-M3. مدل‌های جایگزین گفت‌وگو: MiniMax-M2.7، MiniMax-M2.7-highspeed
• فرایند راه‌اندازی اولیه و تنظیم مستقیم کلید 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

مطالب مرتبط