MiniMax

OpenClaw по умолчанию использует MiniMax M3 для провайдера MiniMax.

MiniMax также предоставляет:

• Встроенный синтез речи через T2A v2
• Встроенное понимание изображений через MiniMax-VL-01
• Встроенную генерацию музыки через music-2.6
• Встроенный web_search через поисковый API MiniMax Token Plan

Разделение провайдеров:

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

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

Выберите предпочитаемый способ аутентификации и выполните шаги настройки.

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-M3" } } },  models: {    mode: "merge",    providers: {      minimax: {        baseUrl: "https://api.minimax.io/anthropic",        apiKey: "${MINIMAX_API_KEY}",        api: "anthropic-messages",        models: [          {            id: "MiniMax-M3",            name: "MiniMax M3",            reasoning: true,            input: ["text", "image"],            cost: { input: 0.6, output: 2.4, cacheRead: 0.12, cacheWrite: 0 },            contextWindow: 1000000,            maxTokens: 131072,          },          {            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,          },        ],      },    },  },}

Настройка через openclaw configure

Используйте интерактивный мастер конфигурации, чтобы настроить MiniMax без редактирования JSON:

openclaw configure

Возможности

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

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.

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-запросом.

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

Встроенный 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",      },    },  },}

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

Встроенный 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, даже когда встроенный каталог текстовых поставщиков также включает 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.*.

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

{  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"],      },    },  },}

Примечания

• 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

Устранение неполадок

openclaw models list

Связанные разделы