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.

Генерація зображень завжди використовує спеціальний endpoint MiniMax для зображень (/v1/image_generation) та ігнорує models.providers.minimax.baseUrl, оскільки це поле налаштовує базову URL-адресу чату/Anthropic-сумісного API. Задайте MINIMAX_API_HOST=https://api.minimaxi.com, щоб спрямовувати генерацію зображень через CN endpoint; стандартний глобальний endpoint — https://api.minimax.io.

Коли onboarding або налаштування 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/токен-автентифікації 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, транскодуються з MiniMax MP3 у 48 кГц Opus за допомогою ffmpeg, оскільки 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
• Елементи керування prompt: 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.

• ID постачальника: minimax
• Структуровані результати: заголовки, URL-адреси, фрагменти, пов’язані запити
• Бажана змінна середовища: MINIMAX_CODE_PLAN_KEY
• Прийняті псевдоніми середовища: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
• Резервна сумісність: MINIMAX_API_KEY, коли вона вже вказує на облікові дані token-plan
• Повторне використання регіону: plugins.entries.minimax.config.webSearch.region, потім MINIMAX_API_HOST, потім базові URL-адреси постачальника MiniMax
• Пошук лишається на ID постачальника minimax; налаштування OAuth CN/global може опосередковано спрямовувати регіон через 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
• Онбординг і пряме налаштування API-ключа записують текстові визначення моделей для обох варіантів M2.7
• Розуміння зображень використовує медіапостачальника MiniMax-VL-01, який належить Plugin
• Оновіть значення цін у models.json, якщо вам потрібне точне відстеження вартості
• Використайте openclaw models list, щоб підтвердити поточний ID постачальника, потім перемкніться за допомогою openclaw models set minimax/MiniMax-M2.7 або openclaw models set minimax-portal/MiniMax-M2.7

# Усунення несправностей

openclaw models list

# Пов’язане