MiniMax

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:

# Built-in catalog

# Getting started

Choose your preferred auth method and follow the setup steps.

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-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,
          },
        ],
      },
    },
  },
}

# Configure via openclaw configure

Use the interactive config wizard to set MiniMax without editing JSON:

openclaw configure

# قابلیت‌ها

# تولید تصویر

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 برای تولید تصویر، آن را به‌عنوان ارائه‌دهنده تولید تصویر تنظیم کنید:

{
  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 ارائه می‌شود.

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

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 را حذف می‌کند.

# تولید موسیقی

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 به‌عنوان ارائه‌دهنده پیش‌فرض موسیقی:

{
  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 استفاده کند، حتی وقتی کاتالوگ ارائه‌دهنده متن همراه هنوز ارجاع‌های چت فقط‌متنی 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.* قرار دارد.

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

{
  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-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 تغییر دهید

# عیب‌یابی

openclaw models list

# مرتبط