Перейти до основного вмісту

​
MiniMax

Постачальник MiniMax в OpenClaw типово використовує MiniMax M2.7. MiniMax також надає:
  • Вбудований синтез мовлення через T2A v2
  • Вбудоване розуміння зображень через MiniMax-VL-01
  • Вбудовану генерацію музики через music-2.5+
  • Вбудований web_search через API пошуку MiniMax Coding Plan
Розподіл постачальників:
ID постачальникаАвтентифікаціяМожливості
minimaxAPI keyТекст, генерація зображень, розуміння зображень, мовлення, вебпошук
minimax-portalOAuthТекст, генерація зображень, розуміння зображень

​
Лінійка моделей

МодельТипОпис
MiniMax-M2.7Чат (міркування)Типова розміщена модель для міркування
MiniMax-M2.7-highspeedЧат (міркування)Швидший рівень міркування M2.7
MiniMax-VL-01БаченняМодель розуміння зображень
image-01Генерація зображеньПеретворення тексту на зображення та редагування зображення за зображенням
music-2.5+Генерація музикиТипова музична модель
music-2.5Генерація музикиПопередній рівень генерації музики
music-2.0Генерація музикиЗастарілий рівень генерації музики
MiniMax-Hailuo-2.3Генерація відеоПотоки перетворення тексту на відео та з опорним зображенням

​
Початок роботи

Виберіть бажаний метод автентифікації та виконайте кроки налаштування.
Найкраще для: швидкого налаштування MiniMax Coding Plan через OAuth, API key не потрібен.
1

Run onboarding

openclaw onboard --auth-choice minimax-global-oauth
Це автентифікує через api.minimax.io.
2

Verify the model is available

openclaw models list --provider minimax-portal
Налаштування OAuth використовують ID постачальника minimax-portal. Посилання на моделі мають формат minimax-portal/MiniMax-M2.7.
Реферальне посилання для MiniMax Coding Plan (знижка 10%): MiniMax Coding Plan

​
Налаштування через openclaw configure

Використовуйте інтерактивний майстер конфігурації, щоб налаштувати MiniMax без редагування JSON:
1

Launch the wizard

openclaw configure
2

Select Model/auth

Виберіть Model/auth у меню.
3

Choose a MiniMax auth option

Виберіть один із доступних варіантів автентифікації MiniMax:
Варіант автентифікаціїОпис
minimax-global-oauthInternational OAuth (Coding Plan)
minimax-cn-oauthChina OAuth (Coding Plan)
minimax-global-apiInternational API key
minimax-cn-apiChina API key
4

Pick your default model

Виберіть типову модель, коли з’явиться запит.

​
Можливості

​
Генерація зображень

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 key використовують MINIMAX_API_KEY; налаштування OAuth можуть натомість використовувати вбудований шлях автентифікації minimax-portal. Коли під час початкового налаштування або налаштування API key записуються явні записи models.providers.minimax, OpenClaw матеріалізує MiniMax-M2.7 і MiniMax-M2.7-highspeed з input: ["text", "image"]. Сам вбудований каталог текстових моделей MiniMax залишається метаданими лише для тексту, доки не з’явиться ця явна конфігурація постачальника. Розуміння зображень надається окремо через власний медіапостачальник Plugin MiniMax-VL-01.
Перегляньте Генерація зображень, щоб дізнатися про спільні параметри інструмента, вибір постачальника та поведінку резервного перемикання.

​
Генерація музики

Вбудований plugin minimax також реєструє генерацію музики через спільний інструмент music_generate.
  • Типова музична модель: minimax/music-2.5+
  • Також підтримує minimax/music-2.5 і minimax/music-2.0
  • Керування запитом: lyrics, instrumental, durationSeconds
  • Формат виводу: mp3
  • Запуски з підтримкою сесій відокремлюються через спільний потік завдань/стану, включно з action: "status"
Щоб використовувати MiniMax як типовий музичний постачальник: 
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.5+",
      },
    },
  },
}
Перегляньте Генерація музики, щоб дізнатися про спільні параметри інструмента, вибір постачальника та поведінку резервного перемикання.

​
Генерація відео

Вбудований plugin minimax також реєструє генерацію відео через спільний інструмент video_generate.
  • Типова відеомодель: minimax/MiniMax-Hailuo-2.3
  • Режими: текст у відео та потоки з одним опорним зображенням
  • Підтримує aspectRatio і resolution
Щоб використовувати MiniMax як типовий відеопостачальник: 
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
Перегляньте Генерація відео, щоб дізнатися про спільні параметри інструмента, вибір постачальника та поведінку резервного перемикання.

​
Розуміння зображень

Plugin MiniMax реєструє розуміння зображень окремо від текстового каталогу:
ID постачальникаТипова модель зображень
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
Саме тому автоматична маршрутизація медіа може використовувати розуміння зображень MiniMax, навіть коли вбудований каталог постачальника тексту все ще показує лише текстові посилання на чат M2.7.

​
Вебпошук

Plugin MiniMax також реєструє web_search через API пошуку MiniMax Coding Plan.
  • ID постачальника: minimax
  • Структуровані результати: заголовки, URL, фрагменти, пов’язані запити
  • Бажана змінна середовища: MINIMAX_CODE_PLAN_KEY
  • Підтримуваний псевдонім змінної середовища: MINIMAX_CODING_API_KEY
  • Сумісний резервний варіант: MINIMAX_API_KEY, якщо він уже вказує на токен coding-plan
  • Повторне використання регіону: plugins.entries.minimax.config.webSearch.region, потім MINIMAX_API_HOST, потім базові URL постачальника MiniMax
  • Пошук залишається на ID постачальника minimax; налаштування OAuth CN/global усе ще можуть опосередковано спрямовувати регіон через models.providers.minimax-portal.baseUrl
Конфігурація розміщується в plugins.entries.minimax.config.webSearch.*.
Перегляньте Пошук MiniMax, щоб дізнатися про повну конфігурацію та використання вебпошуку.

​
Розширена конфігурація

ПараметрОпис
models.providers.minimax.baseUrlНадавайте перевагу https://api.minimax.io/anthropic (сумісний з Anthropic); https://api.minimax.io/v1 є необов’язковим для корисних навантажень, сумісних з OpenAI
models.providers.minimax.apiНадавайте перевагу anthropic-messages; openai-completions є необов’язковим для корисних навантажень, сумісних з OpenAI
models.providers.minimax.apiKeyAPI key MiniMax (MINIMAX_API_KEY)
models.providers.minimax.modelsВизначте id, name, reasoning, contextWindow, maxTokens, cost
agents.defaults.modelsПсевдоніми моделей, які ви хочете додати до allowlist
models.modeЗалиште merge, якщо хочете додати MiniMax поруч із вбудованими моделями
Для api: "anthropic-messages" OpenClaw додає thinking: { type: "disabled" }, якщо thinking ще не встановлено явно в параметрах/конфігурації.Це запобігає тому, щоб потокова кінцева точка MiniMax видавала reasoning_content у дельта-фрагментах у стилі OpenAI, що призвело б до витоку внутрішніх міркувань у видимий вивід.
/fast on або params.fastMode: true переписує MiniMax-M2.7 на MiniMax-M2.7-highspeed на шляху потокової передачі, сумісному з Anthropic.
Найкраще для: залишити вашу найсильнішу найновішу модель покоління як основну та перемикатися на MiniMax M2.7 у разі збою. У прикладі нижче Opus використовується як конкретна основна модель; замініть її на бажану найновішу основну модель покоління.
{
  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/api/openplatform/coding_plan/remains (потребує ключа coding plan).
  • OpenClaw нормалізує використання coding plan MiniMax до того самого відображення % left, що й в інших постачальників. Сирі поля usage_percent / usagePercent у MiniMax означають залишкову квоту, а не використану, тому OpenClaw інвертує їх. Поля на основі лічильників мають пріоритет, якщо вони присутні.
  • Коли API повертає model_remains, OpenClaw надає перевагу запису chat model, за потреби виводить мітку вікна з start_time / end_time і включає вибрану назву моделі в мітку плану, щоб вікна coding plan було легше розрізняти.
  • Знімки використання розглядають minimax, minimax-cn і minimax-portal як ту саму поверхню квоти MiniMax та надають перевагу збереженій MiniMax OAuth перед резервним використанням змінних середовища з ключем Coding Plan.

​
Примітки

  • Посилання на моделі відповідають шляху автентифікації:
    • Налаштування API key: minimax/<model>
    • Налаштування OAuth: minimax-portal/<model>
  • Типова чат-модель: MiniMax-M2.7
  • Альтернативна чат-модель: MiniMax-M2.7-highspeed
  • Початкове налаштування та пряме налаштування API key записують явні визначення моделей з input: ["text", "image"] для обох варіантів M2.7
  • Вбудований каталог постачальника наразі показує посилання чату як метадані лише для тексту, доки не з’явиться явна конфігурація постачальника MiniMax
  • Оновіть значення цін у models.json, якщо вам потрібне точне відстеження вартості
  • Використовуйте openclaw models list, щоб підтвердити поточний ID постачальника, а потім перемкніться за допомогою openclaw models set minimax/MiniMax-M2.7 або openclaw models set minimax-portal/MiniMax-M2.7
Реферальне посилання для MiniMax Coding Plan (знижка 10%): MiniMax Coding Plan
Перегляньте Постачальники моделей, щоб дізнатися про правила для постачальників.

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

Зазвичай це означає, що постачальника 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, щоб можна було додати відповідний постачальник.
Переконайтеся, що ID моделі чутливий до регістру:
  • Шлях API key: minimax/MiniMax-M2.7 або minimax/MiniMax-M2.7-highspeed
  • Шлях OAuth: minimax-portal/MiniMax-M2.7 або minimax-portal/MiniMax-M2.7-highspeed
Потім перевірте ще раз за допомогою:
openclaw models list
Додаткова допомога: Усунення несправностей і FAQ.

​
Пов’язані матеріали

Вибір моделі

Вибір постачальників, посилань на моделі та поведінки резервного перемикання.

Генерація зображень

Спільні параметри інструмента зображень і вибір постачальника.

Генерація музики

Спільні параметри музичного інструмента і вибір постачальника.

Генерація відео

Спільні параметри інструмента відео і вибір постачальника.

Пошук MiniMax

Конфігурація вебпошуку через MiniMax Coding Plan.

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

Загальне усунення несправностей і FAQ.