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

Вбудований каталог

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

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

Виберіть бажаний спосіб автентифікації та виконайте кроки налаштування.
Найкраще для: швидкого налаштування MiniMax Coding Plan через OAuth без потреби в API-ключі.
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-M3.
Реферальне посилання для 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-oauthМіжнародний OAuth (Coding Plan)
minimax-cn-oauthOAuth для Китаю (Coding Plan)
minimax-global-apiМіжнародний API-ключ
minimax-cn-apiAPI-ключ для Китаю
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-ключем використовують MINIMAX_API_KEY; налаштування OAuth можуть натомість використовувати вбудований шлях автентифікації minimax-portal. Генерація зображень завжди використовує спеціальну кінцеву точку MiniMax для зображень (/v1/image_generation) та ігнорує models.providers.minimax.baseUrl, оскільки це поле налаштовує базову URL-адресу для чату/Anthropic-сумісного API. Установіть MINIMAX_API_HOST=https://api.minimaxi.com, щоб спрямовувати генерацію зображень через китайську кінцеву точку; стандартна глобальна кінцева точка: https://api.minimax.io. Коли онбординг або налаштування API-ключа записує явні записи models.providers.minimax, OpenClaw матеріалізує MiniMax-M3, MiniMax-M2.7 і MiniMax-M2.7-highspeed як чат-моделі. M3 заявляє підтримку текстового та зображувального вводу; розуміння зображень залишається окремо доступним через медіапровайдера MiniMax-VL-01, який належить Plugin.
Див. Генерація зображень, щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку failover.

Перетворення тексту на мовлення

Вбудований Plugin minimax реєструє MiniMax T2A v2 як провайдера мовлення для messages.tts.
  • Стандартна TTS-модель: speech-2.8-hd
  • Стандартний голос: English_expressive_narrator
  • Підтримувані вбудовані ID моделей включають 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-запитом.
НалаштуванняЗмінна середовищаСтандартне значенняОпис
messages.tts.providers.minimax.baseUrlMINIMAX_API_HOSThttps://api.minimax.ioХост API MiniMax T2A.
messages.tts.providers.minimax.modelMINIMAX_TTS_MODELspeech-2.8-hdID TTS-моделі.
messages.tts.providers.minimax.speakerVoiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narratorID голосу для мовленнєвого виводу.
messages.tts.providers.minimax.speed1.0Швидкість відтворення, 0.5..2.0.
messages.tts.providers.minimax.vol1.0Гучність, (0, 10].
messages.tts.providers.minimax.pitch0Цілочисельний зсув висоти тону, -12..12.

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

Вбудований 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",
      },
    },
  },
}
Див. Генерація музики, щоб дізнатися про спільні параметри інструмента, вибір постачальника та поведінку failover.

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

Вбудований 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",
      },
    },
  },
}
Див. Генерація відео, щоб дізнатися про спільні параметри інструмента, вибір постачальника та поведінку failover.

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

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

Вебпошук

Plugin MiniMax також реєструє web_search через 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 auth через MINIMAX_OAUTH_TOKEN
Конфігурація міститься в plugins.entries.minimax.config.webSearch.*.
Див. Пошук MiniMax, щоб дізнатися про повну конфігурацію та використання вебпошуку.

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

ПараметрОпис
models.providers.minimax.baseUrlНадавайте перевагу https://api.minimax.io/anthropic (сумісний з Anthropic); https://api.minimax.io/v1 є необов’язковим для payload, сумісних з OpenAI
models.providers.minimax.apiНадавайте перевагу anthropic-messages; openai-completions є необов’язковим для payload, сумісних з OpenAI
models.providers.minimax.apiKeyAPI-ключ 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" } для моделей MiniMax M2.x, якщо thinking ще не задано явно в параметрах/конфігурації.Це не дає потоковому endpoint M2.x видавати reasoning_content у delta chunks стилю OpenAI, що призвело б до витоку внутрішнього reasoning у видимий вивід.MiniMax-M3 (і M3.x) виняток: M3 видає правильні thinking blocks Anthropic і повертає порожній масив content із stop_reason: "end_turn", коли thinking вимкнено, тому wrapper залишає M3 на пропущеному/адаптивному шляху thinking постачальника.
/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/token_plan/remains або https://api.minimax.io/v1/token_plan/remains (потрібен ключ coding plan).
  • Опитування використання виводить host із models.providers.minimax-portal.baseUrl або models.providers.minimax.baseUrl, якщо їх налаштовано, тому глобальні налаштування з https://api.minimax.io/anthropic опитують api.minimax.io. Відсутні або неправильно сформовані базові URL-адреси зберігають резерв CN для сумісності.
  • OpenClaw нормалізує використання coding-plan MiniMax до того самого відображення % left, яке використовують інші постачальники. Сирі поля MiniMax usage_percent / usagePercent означають залишок квоти, а не спожиту квоту, тому OpenClaw інвертує їх. Поля на основі лічильників мають пріоритет, коли вони наявні.
  • Коли API повертає model_remains, OpenClaw надає перевагу запису chat-model, за потреби виводить мітку вікна з start_time / end_time і додає назву вибраної моделі до мітки плану, щоб вікна coding-plan було легше розрізняти.
  • Знімки використання трактують minimax, minimax-cn і minimax-portal як одну поверхню квоти MiniMax і надають перевагу збереженому OAuth MiniMax перед резервним переходом до змінних середовища ключа Coding Plan.

Примітки

  • Model refs відповідають шляху автентифікації:
    • Налаштування 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, щоб підтвердити поточний ID постачальника, а потім перемкніться за допомогою openclaw models set minimax/MiniMax-M3 або openclaw models set minimax-portal/MiniMax-M3
Реферальне посилання для 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-ключа: minimax/MiniMax-M3, minimax/MiniMax-M2.7 або minimax/MiniMax-M2.7-highspeed
  • Шлях OAuth: minimax-portal/MiniMax-M3, minimax-portal/MiniMax-M2.7 або minimax-portal/MiniMax-M2.7-highspeed
Потім перевірте ще раз за допомогою:
openclaw models list
Додаткова допомога: Усунення несправностей і FAQ.

Пов’язане

Вибір моделі

Вибір постачальників, model refs і поведінка failover.

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

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

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

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

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

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

Пошук MiniMax

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

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

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