OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

MiniMax

Встроенный плагин minimax регистрирует два провайдера и пять возможностей: чат, генерацию изображений, генерацию музыки, генерацию видео, распознавание изображений, речь (T2A v2) и веб-поиск.

Идентификатор провайдера Аутентификация Возможности
minimax API-ключ Текст, генерация изображений, генерация музыки, генерация видео, распознавание изображений, речь, веб-поиск
minimax-portal OAuth Текст, генерация изображений, генерация музыки, генерация видео, распознавание изображений, речь

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

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

Ссылки на модели соответствуют способу аутентификации: minimax/<model> для конфигураций с API-ключом, minimax-portal/<model> для конфигураций OAuth.

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

OAuth (Coding Plan)

Лучше всего подходит для: быстрой настройки MiniMax Coding Plan через OAuth без необходимости использовать API-ключ.

Международный

  • Запустите начальную настройку

    bash
    openclaw onboard --auth-choice minimax-global-oauth

    Итоговый базовый URL провайдера: api.minimax.io.

  • Убедитесь, что модель доступна

    bash
    openclaw models list --provider minimax-portal

    • Китай

  • Запустите начальную настройку

    bash
    openclaw onboard --auth-choice minimax-cn-oauth

    Итоговый базовый URL провайдера: api.minimaxi.com.

  • Убедитесь, что модель доступна

    bash
    openclaw models list --provider minimax-portal

    • API-ключ

    Лучше всего подходит для: размещённого MiniMax с API, совместимым с Anthropic.

    Международный

  • Запустите начальную настройку

    bash
    openclaw onboard --auth-choice minimax-global-api

    Эта команда настраивает api.minimax.io в качестве базового URL.

  • Убедитесь, что модель доступна

    bash
    openclaw models list --provider minimax

    • Китай

  • Запустите начальную настройку

    bash
    openclaw onboard --auth-choice minimax-cn-api

    Эта команда настраивает api.minimaxi.com в качестве базового URL.

  • Убедитесь, что модель доступна

    bash
    openclaw models list --provider minimax

    • Пример конфигурации

    json5
    {  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

  • Запустите мастер

    bash
    openclaw configure

  • Выберите модель и аутентификацию

    Выберите в меню Модель и аутентификация.

  • Выберите способ аутентификации MiniMax

    Вариант аутентификации Описание
    minimax-global-oauth Международный OAuth (Coding Plan)
    minimax-cn-oauth OAuth для Китая (Coding Plan)
    minimax-global-api Международный API-ключ
    minimax-cn-api API-ключ для Китая

  • Выберите модель по умолчанию

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

    • Возможности

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

    Плагин MiniMax регистрирует модель image-01 для инструмента image_generate в обоих провайдерах, minimax и minimax-portal, повторно используя те же MINIMAX_API_KEY или аутентификацию OAuth, что и текстовые модели.

    • Генерация изображения из текста и редактирование изображения по изображению (эталон объекта), в обоих случаях с управлением соотношением сторон
    • До 9 выходных изображений на запрос, 1 эталонное изображение на запрос редактирования
    • Поддерживаемые соотношения сторон: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9
    json5
    {  agents: {    defaults: {      imageGenerationModel: { primary: "minimax/image-01" },    },  },}

    Для генерации изображений всегда используется специализированная конечная точка MiniMax (/v1/image_generation), а models.providers.minimax.baseUrl игнорируется, поскольку это поле настраивает базовый URL чата, совместимый с Anthropic. Задайте MINIMAX_API_HOST=https://api.minimaxi.com, чтобы направлять генерацию изображений через конечную точку для Китая; стандартная глобальная конечная точка — https://api.minimax.io.

    Преобразование текста в речь

    Встроенный плагин minimax регистрирует MiniMax T2A v2 в качестве провайдера речи для messages.tts.

    • Стандартная модель TTS: speech-2.8-hd
    • Стандартный голос: English_expressive_narrator
    • Идентификаторы встроенных моделей: 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, speech-01-240228
    • Порядок определения аутентификации: 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 и других каналов, запрашивающих вложение, совместимое с голосовыми сообщениями) MP3 от MiniMax перекодируется в Opus с частотой 48kHz с помощью 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 Идентификатор модели TTS.
    messages.tts.providers.minimax.voiceId MINIMAX_TTS_VOICE_ID English_expressive_narrator Идентификатор голоса для речевого вывода.
    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.

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

    Встроенный плагин MiniMax регистрирует генерацию музыки через общий инструмент music_generate для обоих провайдеров, minimax и minimax-portal.

    • Стандартная музыкальная модель: minimax/music-2.6 (OAuth: minimax-portal/music-2.6)
    • Также поддерживаются music-2.6-free, music-cover и music-cover-free
    • Параметры промпта: lyrics, instrumental
    • Формат вывода: mp3
    • Запуски с поддержкой сеансов отсоединяются через общий поток задач и состояний, включая action: "status"
    json5
    {  agents: {    defaults: {      musicGenerationModel: { primary: "minimax/music-2.6" },    },  },}

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

    Встроенный плагин MiniMax регистрирует генерацию видео через общий инструмент video_generate для обоих провайдеров, minimax и minimax-portal.

    • Модель видео по умолчанию: minimax/MiniMax-Hailuo-2.3 (OAuth: minimax-portal/MiniMax-Hailuo-2.3)
    • Также поддерживаются MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live и I2V-01
    • Режимы: преобразование текста в видео и сценарии с одним эталонным изображением
    • Поддерживается resolution (768P или 1080P в моделях Hailuo 2.3/02); aspectRatio не поддерживается и игнорируется
    json5
    {  agents: {    defaults: {      videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" },    },  },}

    Распознавание изображений

    Плагин MiniMax регистрирует распознавание изображений отдельно от каталога текстовых моделей:

    Идентификатор провайдера Модель изображений по умолчанию Извлечение текста из PDF
    minimax MiniMax-VL-01 MiniMax-M2.7
    minimax-portal MiniMax-VL-01 MiniMax-M2.7

    Поэтому автоматическая маршрутизация медиафайлов может использовать распознавание изображений MiniMax, даже если встроенный каталог провайдеров текстовых моделей также содержит ссылки на чат-модели M3 с поддержкой изображений. Для распознавания PDF MiniMax-M2.7 используется только для извлечения текста; MiniMax не регистрирует путь преобразования PDF в изображения.

    Веб-поиск

    Плагин MiniMax также регистрирует web_search через API поиска MiniMax Token Plan (/v1/coding_plan/search).

    • Идентификатор провайдера: 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
    • Поиск продолжает использовать идентификатор провайдера minimax; настройка OAuth для Китая или глобального региона может косвенно определять регион через models.providers.minimax-portal.baseUrl и предоставлять аутентификацию с помощью токена-носителя через MINIMAX_OAUTH_TOKEN

    Конфигурация находится в plugins.entries.minimax.config.webSearch.*.

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

    Параметры конфигурации
    Параметр Описание
    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.apiKey Ключ API MiniMax (MINIMAX_API_KEY)
    models.providers.minimax.models Определите id, name, reasoning, contextWindow, maxTokens, cost
    agents.defaults.models Назначьте псевдонимы моделям, которые нужно добавить в список разрешённых
    models.mode Сохраните merge, если хотите добавить MiniMax наряду со встроенными моделями
    Настройки рассуждений по умолчанию

    В api: "anthropic-messages" OpenClaw внедряет thinking: { type: "disabled" } для моделей MiniMax M2.x, если более ранняя обёртка ещё не задала поле thinking в полезной нагрузке. Это предотвращает вывод reasoning_content потоковой конечной точкой M2.x во фрагментах изменений в стиле OpenAI, из-за чего внутренние рассуждения могли бы попасть в видимый вывод.

    MiniMax-M3 (и M3.x) является исключением: при отключённых рассуждениях M3 возвращает пустой массив content с stop_reason: "end_turn", поэтому OpenClaw удаляет неявное отключённое значение по умолчанию для M3, а при заданном уровне рассуждений принудительно устанавливает thinking: { type: "adaptive" }.

    Доступные уровни рассуждений для каждого семейства моделей:

    Семейство моделей Уровни По умолчанию
    MiniMax-M3 off, adaptive adaptive
    MiniMax-M2.x off, minimal, low, medium, high off
    Быстрый режим

    /fast on или params.fastMode: true заменяет MiniMax-M2.7 на MiniMax-M2.7-highspeed в потоковом пути, совместимом с Anthropic (api: "anthropic-messages", провайдер minimax или minimax-portal).

    Пример резервного переключения

    Лучше всего подходит для: использования самой мощной модели последнего поколения в качестве основной с резервным переключением на MiniMax M2.7. В примере ниже Opus используется как конкретная основная модель; замените её предпочтительной основной моделью последнего поколения.

    json5
    {  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"],      },    },  },}
    Подробности использования Coding Plan
    • API использования Coding Plan: https://api.minimaxi.com/v1/token_plan/remains или https://api.minimax.io/v1/token_plan/remains (требуется ключ Coding Plan).
    • При настроенных models.providers.minimax-portal.baseUrl или models.providers.minimax.baseUrl хост для опроса использования определяется из них, поэтому глобальные конфигурации с https://api.minimax.io/anthropic опрашивают api.minimax.io. При отсутствии или некорректности базовых URL-адресов для совместимости сохраняется резервный вариант для Китая.
    • OpenClaw нормализует сведения об использовании Coding Plan MiniMax к тому же представлению % left, которое используется другими провайдерами. Необработанные поля MiniMax usage_percent / usagePercent обозначают оставшуюся, а не израсходованную квоту, поэтому OpenClaw инвертирует их. При наличии приоритет имеют поля на основе количества.
    • Когда API возвращает model_remains, OpenClaw отдаёт предпочтение записи чат-модели, при необходимости формирует метку окна из start_time / end_time и включает имя выбранной модели в метку плана, чтобы окна Coding Plan было проще различать.
    • Снимки использования считают minimax, minimax-cn, minimax-portal и minimax-portal-cn одной и той же квотой MiniMax и отдают предпочтение сохранённому OAuth MiniMax, прежде чем переходить к переменным окружения с ключом Coding Plan.

    Примечания

    • Чат-модель по умолчанию: MiniMax-M3. Альтернативные чат-модели: MiniMax-M2.7, MiniMax-M2.7-highspeed
    • При первоначальной настройке и прямой настройке ключа API записываются определения модели для M3 и обоих вариантов M2.7
    • Для распознавания изображений используется принадлежащий плагину медиапровайдер MiniMax-VL-01
    • Если требуется точный учёт затрат, обновите значения цен в models.json
    • Используйте openclaw models list, чтобы подтвердить текущий идентификатор провайдера, затем переключитесь с помощью openclaw models set minimax/MiniMax-M3 или openclaw models set minimax-portal/MiniMax-M3

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

    "Неизвестная модель: minimax/MiniMax-M3"

    Обычно это означает, что провайдер MiniMax не настроен (не найдена соответствующая запись провайдера, профиль аутентификации MiniMax или ключ переменной окружения). Способы исправления:

    • Выполнить 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

    Затем повторно проверьте с помощью:

    bash
    openclaw models list

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

    Выбор модели

    Выбор провайдеров, ссылок на модели и поведения при переключении после сбоя.
    Генерация изображений

    Общие параметры инструмента для работы с изображениями и выбор провайдера.
    Генерация музыки

    Общие параметры инструмента для работы с музыкой и выбор провайдера.
    Генерация видео

    Общие параметры инструмента для работы с видео и выбор провайдера.
    Поиск MiniMax

    Настройка веб-поиска через MiniMax Token Plan.
    Устранение неполадок

    Общие сведения об устранении неполадок и часто задаваемые вопросы.
    Was this useful?
    On this page

    On this page