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

Встроенный каталог

МодельТипОписание
MiniMax-M3Чат (reasoning)Стандартная размещенная модель reasoning
MiniMax-M2.7Чат (reasoning)Предыдущая размещенная модель reasoning
MiniMax-M2.7-highspeedЧат (reasoning)Более быстрый уровень reasoning M2.7
MiniMax-VL-01VisionМодель понимания изображений
image-01Генерация изображенийРедактирование text-to-image и image-to-image
music-2.6Генерация музыкиСтандартная модель для музыки
music-2.5Генерация музыкиПредыдущий уровень генерации музыки
music-2.0Генерация музыкиУстаревший уровень генерации музыки
MiniMax-Hailuo-2.3Генерация видеоПотоки text-to-video и ссылок на изображения

Начало работы

Выберите предпочитаемый способ аутентификации и выполните шаги настройки.
Лучше всего подходит для: быстрой настройки 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-oauthКитайский OAuth (Coding Plan)
minimax-global-apiМеждународный API-ключ
minimax-cn-apiКитайский API-ключ
4

Pick your default model

Выберите модель по умолчанию при появлении запроса.

Возможности

Генерация изображений

Plugin MiniMax регистрирует модель image-01 для инструмента image_generate. Она поддерживает:
  • Генерацию text-to-image с управлением соотношением сторон
  • Редактирование image-to-image (ссылка на объект) с управлением соотношением сторон
  • До 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, чтобы направлять генерацию изображений через конечную точку CN; глобальная конечная точка по умолчанию: https://api.minimax.io. Когда onboarding или настройка API-ключа записывает явные записи models.providers.minimax, OpenClaw материализует MiniMax-M3, MiniMax-M2.7 и MiniMax-M2.7-highspeed как чат-модели. M3 объявляет поддержку текстового и графического ввода; понимание изображений остается отдельно доступным через принадлежащего Plugin медиапровайдера MiniMax-VL-01.
См. Генерация изображений для общих параметров инструмента, выбора провайдера и поведения failover.

Text-to-speech

Встроенный 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.
  • Целевые voice-note, такие как Feishu и Telegram, транскодируются из MP3 MiniMax в Opus 48 кГц с помощью 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
  • Параметры prompt: 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 через поисковый 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.*.
См. поиск 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 уже не задан явно в params/config.Это предотвращает выдачу reasoning_content потоковой конечной точкой M2.x в delta-чанках в стиле OpenAI, что привело бы к утечке внутреннего reasoning в видимый вывод.MiniMax-M3 (и M3.x) исключен: M3 выводит корректные блоки thinking 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 сохраняют fallback CN для совместимости.
  • OpenClaw нормализует использование MiniMax coding-plan к тому же отображению % left, которое используется другими поставщиками. Сырые поля MiniMax usage_percent / usagePercent означают оставшуюся квоту, а не израсходованную, поэтому OpenClaw инвертирует их. Поля на основе счетчиков имеют приоритет, когда присутствуют.
  • Когда API возвращает model_remains, OpenClaw предпочитает запись chat-модели, при необходимости выводит метку окна из start_time / end_time и включает имя выбранной модели в метку плана, чтобы окна coding-plan было проще различать.
  • Снимки использования рассматривают minimax, minimax-cn и minimax-portal как одну и ту же квотную поверхность MiniMax и предпочитают сохраненный OAuth MiniMax перед fallback к переменным окружения ключа Coding Plan.

Примечания

  • Model refs следуют пути аутентификации:
    • Настройка API-ключа: minimax/<model>
    • Настройка OAuth: minimax-portal/<model>
  • Chat-модель по умолчанию: MiniMax-M3
  • Альтернативные chat-модели: MiniMax-M2.7, MiniMax-M2.7-highspeed
  • Онбординг и прямая настройка API-ключа записывают определения моделей для M3 и обоих вариантов M2.7
  • Понимание изображений использует принадлежащий Plugin медиапоставщик MiniMax-VL-01
  • Обновите значения цен в 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.