- Встроенный синтез речи через T2A v2
- Встроенное понимание изображений через
MiniMax-VL-01 - Встроенную генерацию музыки через
music-2.6 - Встроенный
web_searchчерез поисковый API MiniMax Token Plan
| ID провайдера | Аутентификация | Возможности |
|---|---|---|
minimax | API-ключ | Текст, генерация изображений, генерация музыки, генерация видео, понимание изображений, речь, веб-поиск |
minimax-portal | OAuth | Текст, генерация изображений, генерация музыки, генерация видео, понимание изображений, речь |
Встроенный каталог
| Модель | Тип | Описание |
|---|---|---|
MiniMax-M3 | Чат (reasoning) | Стандартная размещенная модель reasoning |
MiniMax-M2.7 | Чат (reasoning) | Предыдущая размещенная модель reasoning |
MiniMax-M2.7-highspeed | Чат (reasoning) | Более быстрый уровень reasoning M2.7 |
MiniMax-VL-01 | Vision | Модель понимания изображений |
image-01 | Генерация изображений | Редактирование text-to-image и image-to-image |
music-2.6 | Генерация музыки | Стандартная модель для музыки |
music-2.5 | Генерация музыки | Предыдущий уровень генерации музыки |
music-2.0 | Генерация музыки | Устаревший уровень генерации музыки |
MiniMax-Hailuo-2.3 | Генерация видео | Потоки text-to-video и ссылок на изображения |
Начало работы
Выберите предпочитаемый способ аутентификации и выполните шаги настройки.- OAuth (Coding Plan)
- API key
Лучше всего подходит для: быстрой настройки MiniMax Coding Plan через OAuth; API-ключ не требуется.
- International
- China
Настройки OAuth используют id провайдера
minimax-portal. Ссылки на модели имеют форму minimax-portal/MiniMax-M3.Настройка через openclaw configure
Используйте интерактивный мастер конфигурации, чтобы настроить MiniMax без редактирования JSON:
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-ключ |
Возможности
Генерация изображений
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_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
Встроенный Pluginminimax регистрирует 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.baseUrl | MINIMAX_API_HOST | https://api.minimax.io | Хост API MiniMax T2A. |
messages.tts.providers.minimax.model | MINIMAX_TTS_MODEL | speech-2.8-hd | id модели TTS. |
messages.tts.providers.minimax.speakerVoiceId | MINIMAX_TTS_VOICE_ID | English_expressive_narrator | id голоса, используемый для речевого вывода. |
messages.tts.providers.minimax.speed | 1.0 | Скорость воспроизведения, 0.5..2.0. | |
messages.tts.providers.minimax.vol | 1.0 | Громкость, (0, 10]. | |
messages.tts.providers.minimax.pitch | 0 | Целочисленный сдвиг высоты тона, -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"
См. генерацию музыки для общих параметров инструмента, выбора поставщика и поведения при failover.
Генерация видео
Встроенный Plugin MiniMax регистрирует генерацию видео через общий инструментvideo_generate как для minimax, так и для minimax-portal.
- Модель видео по умолчанию:
minimax/MiniMax-Hailuo-2.3 - Видеомодель OAuth:
minimax-portal/MiniMax-Hailuo-2.3 - Режимы: преобразование текста в видео и потоки с одной эталонной картинкой
- Поддерживает
aspectRatioиresolution
См. генерацию видео для общих параметров инструмента, выбора поставщика и поведения при failover.
Понимание изображений
Plugin MiniMax регистрирует понимание изображений отдельно от текстового каталога:| ID поставщика | Модель изображений по умолчанию |
|---|---|
minimax | MiniMax-VL-01 |
minimax-portal | MiniMax-VL-01 |
Веб-поиск
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.apiKey | API-ключ MiniMax (MINIMAX_API_KEY) |
models.providers.minimax.models | Определяет id, name, reasoning, contextWindow, maxTokens, cost |
agents.defaults.models | Назначает псевдонимы моделям, которые вы хотите включить в allowlist |
models.mode | Оставьте merge, если хотите добавить MiniMax вместе со встроенными моделями |
Значения thinking по умолчанию
Значения thinking по умолчанию
При
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.Пример fallback
Пример fallback
Лучше всего для: держать самую сильную модель последнего поколения основной, с переключением на MiniMax M2.7 при сбое. Пример ниже использует Opus как конкретную основную модель; замените ее на предпочитаемую основную модель последнего поколения.
Сведения об использовании Coding Plan
Сведения об использовании Coding Plan
- 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, которое используется другими поставщиками. Сырые поля MiniMaxusage_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>
- Настройка API-ключа:
- 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
См. поставщиков моделей для правил поставщиков.
Устранение неполадок
"Unknown model: minimax/MiniMax-M3"
"Unknown model: minimax/MiniMax-M3"
Обычно это означает, что поставщик 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, чтобы можно было внедрить соответствующего поставщика.
- Путь 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
Дополнительная помощь: устранение неполадок и FAQ.
Связанные разделы
Выбор модели
Выбор поставщиков, model refs и поведения при failover.
Генерация изображений
Общие параметры инструмента изображений и выбор поставщика.
Генерация музыки
Общие параметры музыкального инструмента и выбор поставщика.
Генерация видео
Общие параметры видеоинструмента и выбор поставщика.
Поиск MiniMax
Конфигурация веб-поиска через MiniMax Token Plan.
Устранение неполадок
Общее устранение неполадок и FAQ.