OpenClaw’s MiniMax provider defaults to MiniMax M2.7. MiniMax also provides:Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
- Bundled speech synthesis via T2A v2
- Bundled image understanding via
MiniMax-VL-01 - Bundled music generation via
music-2.6 - Bundled
web_searchthrough the MiniMax Token Plan search API
| Provider ID | Auth | Capabilities |
|---|---|---|
minimax | API key | Text, image generation, music generation, video generation, image understanding, speech, web search |
minimax-portal | OAuth | Text, image generation, music generation, video generation, image understanding, speech |
Built-in catalog
| Model | Type | Description |
|---|---|---|
MiniMax-M2.7 | Chat (reasoning) | Default hosted reasoning model |
MiniMax-M2.7-highspeed | Chat (reasoning) | Faster M2.7 reasoning tier |
MiniMax-VL-01 | Vision | Image understanding model |
image-01 | Image generation | Text-to-image and image-to-image editing |
music-2.6 | Music generation | Default music model |
music-2.5 | Music generation | Previous music generation tier |
music-2.0 | Music generation | Legacy music generation tier |
MiniMax-Hailuo-2.3 | Video generation | Text-to-video and image reference flows |
Getting started
Choose your preferred auth method and follow the setup steps.- OAuth (Coding Plan)
- API key
Configure via openclaw configure
Use the interactive config wizard to set MiniMax without editing JSON:
Виберіть варіант автентифікації MiniMax
Виберіть один із доступних варіантів 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. Вона підтримує:
- Генерацію зображень із тексту з керуванням співвідношенням сторін
- Редагування зображення за зображенням (референс об’єкта) з керуванням співвідношенням сторін
- До 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.
Генерація зображень завжди використовує спеціальний endpoint MiniMax для зображень
(/v1/image_generation) та ігнорує models.providers.minimax.baseUrl,
оскільки це поле налаштовує базову URL-адресу чату/Anthropic-сумісного API. Задайте
MINIMAX_API_HOST=https://api.minimaxi.com, щоб спрямовувати генерацію зображень
через CN endpoint; стандартний глобальний endpoint —
https://api.minimax.io.
Коли onboarding або налаштування API-ключа записує явні записи models.providers.minimax,
OpenClaw матеріалізує MiniMax-M2.7 і
MiniMax-M2.7-highspeed як текстові моделі чату. Розуміння зображень
надається окремо через медіапровайдера MiniMax-VL-01, який належить Plugin.
Див. Генерація зображень щодо спільних параметрів інструмента, вибору провайдера та поведінки failover.
Перетворення тексту на мовлення
Вбудований Pluginminimax реєструє 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. - Розв’язання автентифікації відбувається в такому порядку:
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.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. |
Генерація музики
Вбудований 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,durationSeconds - Формат виводу:
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
Див. Генерація відео щодо спільних параметрів інструмента, вибору постачальника та поведінки відмовостійкого перемикання.
Розуміння зображень
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 поруч із вбудованими моделями |
Типові налаштування мислення
Типові налаштування мислення
Для
api: "anthropic-messages" OpenClaw вставляє thinking: { type: "disabled" }, якщо мислення ще не задано явно в params/config.Це запобігає тому, щоб потоковий endpoint MiniMax видавав reasoning_content у delta-фрагментах у стилі OpenAI, що розкрило б внутрішнє міркування у видимому виводі.Швидкий режим
Швидкий режим
/fast on або params.fastMode: true переписує MiniMax-M2.7 на MiniMax-M2.7-highspeed у потоковому шляху, сумісному з Anthropic.Приклад резервного перемикання
Приклад резервного перемикання
Найкраще для: тримайте свою найсильнішу модель останнього покоління як основну, а в разі збою перемикайтеся на 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). - Опитування використання визначає хост із
models.providers.minimax-portal.baseUrlабоmodels.providers.minimax.baseUrl, коли це налаштовано, тому глобальні налаштування, що використовуютьhttps://api.minimax.io/anthropic, опитуютьapi.minimax.io. Відсутні або неправильно сформовані базові URL-адреси зберігають резервний CN-вариант для сумісності. - OpenClaw нормалізує використання coding-plan MiniMax до того самого відображення
% left, яке використовують інші постачальники. Сирі поля MiniMaxusage_percent/usagePercentозначають залишок квоти, а не спожиту квоту, тому OpenClaw інвертує їх. Поля на основі кількості мають пріоритет, коли вони наявні. - Коли API повертає
model_remains, OpenClaw надає перевагу запису моделі чату, за потреби виводить мітку вікна зstart_time/end_timeі включає назву вибраної моделі в мітку плану, щоб вікна coding-plan було легше розрізняти. - Знімки використання трактують
minimax,minimax-cnіminimax-portalяк одну й ту саму поверхню квоти MiniMax і надають перевагу збереженому MiniMax OAuth перед резервним переходом до змінних середовища ключа Coding Plan.
Примітки
- Посилання на моделі відповідають шляху автентифікації:
- Налаштування з API-ключем:
minimax/<model> - Налаштування OAuth:
minimax-portal/<model>
- Налаштування з API-ключем:
- Типова модель чату:
MiniMax-M2.7 - Альтернативна модель чату:
MiniMax-M2.7-highspeed - Онбординг і пряме налаштування API-ключа записують текстові визначення моделей для обох варіантів M2.7
- Розуміння зображень використовує медіапостачальника
MiniMax-VL-01, який належить Plugin - Оновіть значення цін у
models.json, якщо вам потрібне точне відстеження вартості - Використайте
openclaw models list, щоб підтвердити поточний ID постачальника, потім перемкніться за допомогоюopenclaw models set minimax/MiniMax-M2.7абоopenclaw models set minimax-portal/MiniMax-M2.7
Див. Постачальники моделей щодо правил постачальників.
Усунення несправностей
"Невідома модель: minimax/MiniMax-M2.7"
"Невідома модель: minimax/MiniMax-M2.7"
Зазвичай це означає, що постачальника 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-M2.7абоminimax/MiniMax-M2.7-highspeed - Шлях OAuth:
minimax-portal/MiniMax-M2.7абоminimax-portal/MiniMax-M2.7-highspeed
Більше довідки: Усунення несправностей і Поширені запитання.
Пов’язане
Вибір моделі
Вибір постачальників, посилань на моделі та поведінки відмовостійкого перемикання.
Генерація зображень
Спільні параметри інструмента зображень і вибір постачальника.
Генерація музики
Спільні параметри інструмента музики та вибір постачальника.
Генерація відео
Спільні параметри інструмента відео та вибір постачальника.
Пошук MiniMax
Конфігурація вебпошуку через MiniMax Token Plan.
Усунення несправностей
Загальне усунення несправностей і поширені запитання.