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:
Wybierz opcję uwierzytelniania MiniMax
Wybierz jedną z dostępnych opcji MiniMax:
| Wybór uwierzytelniania | Opis |
|---|---|
minimax-global-oauth | Międzynarodowe OAuth (Coding Plan) |
minimax-cn-oauth | OAuth dla Chin (Coding Plan) |
minimax-global-api | Międzynarodowy klucz API |
minimax-cn-api | Klucz API dla Chin |
Możliwości
Generowanie obrazów
Plugin MiniMax rejestruje modelimage-01 dla narzędzia image_generate. Obsługuje on:
- Generowanie tekstu na obraz z kontrolą proporcji obrazu
- Edycję obrazu na podstawie obrazu (odniesienie do obiektu) z kontrolą proporcji obrazu
- Do 9 obrazów wyjściowych na żądanie
- Do 1 obrazu referencyjnego na żądanie edycji
- Obsługiwane proporcje obrazu:
1:1,16:9,4:3,3:2,2:3,3:4,9:16,21:9
MINIMAX_API_KEY lub uwierzytelniania OAuth co modele tekstowe. Jeśli MiniMax jest już skonfigurowany, dodatkowa konfiguracja nie jest potrzebna.
Zarówno minimax, jak i minimax-portal rejestrują image_generate z tym samym
modelem image-01. Konfiguracje z kluczem API używają MINIMAX_API_KEY; konfiguracje OAuth mogą zamiast tego używać
dołączonej ścieżki uwierzytelniania minimax-portal.
Generowanie obrazów zawsze używa dedykowanego endpointu obrazów MiniMax
(/v1/image_generation) i ignoruje models.providers.minimax.baseUrl,
ponieważ to pole konfiguruje bazowy URL czatu zgodny z Anthropic. Ustaw
MINIMAX_API_HOST=https://api.minimaxi.com, aby kierować generowanie obrazów
przez endpoint CN; domyślny endpoint globalny to
https://api.minimax.io.
Gdy onboarding lub konfiguracja klucza API zapisuje jawne wpisy models.providers.minimax,
OpenClaw materializuje MiniMax-M2.7 i
MiniMax-M2.7-highspeed jako modele czatu wyłącznie tekstowego. Rozumienie obrazów jest
udostępniane osobno przez należącego do Plugin dostawcę multimediów MiniMax-VL-01.
Zobacz Generowanie obrazów, aby poznać wspólne parametry narzędzi, wybór dostawcy i zachowanie przełączania awaryjnego.
Zamiana tekstu na mowę
Dołączony Pluginminimax rejestruje MiniMax T2A v2 jako dostawcę mowy dla
messages.tts.
- Domyślny model TTS:
speech-2.8-hd - Domyślny głos:
English_expressive_narrator - Obsługiwane dołączone identyfikatory modeli obejmują
speech-2.8-hd,speech-2.8-turbo,speech-2.6-hd,speech-2.6-turbo,speech-02-hd,speech-02-turbo,speech-01-hdispeech-01-turbo. - Rozwiązywanie uwierzytelniania przebiega w kolejności:
messages.tts.providers.minimax.apiKey, następnie profile uwierzytelniania OAuth/tokenminimax-portal, następnie klucze środowiskowe Token Plan (MINIMAX_OAUTH_TOKEN,MINIMAX_CODE_PLAN_KEY,MINIMAX_CODING_API_KEY), a następnieMINIMAX_API_KEY. - Jeśli host TTS nie jest skonfigurowany, OpenClaw ponownie używa skonfigurowanego
hosta OAuth
minimax-portali usuwa sufiksy ścieżek zgodne z Anthropic, takie jak/anthropic. - Zwykłe załączniki audio pozostają w formacie MP3.
- Cele notatek głosowych, takie jak Feishu i Telegram, są transkodowane z MP3 MiniMax
do Opus 48 kHz za pomocą
ffmpeg, ponieważ API plików Feishu/Lark akceptuje tylkofile_type: "opus"dla natywnych wiadomości audio. - MiniMax T2A akceptuje ułamkowe wartości
speedivol, alepitchjest wysyłane jako liczba całkowita; OpenClaw obcina ułamkowe wartościpitchprzed żądaniem API.
| Ustawienie | Zmienna środowiskowa | Domyślne | Opis |
|---|---|---|---|
messages.tts.providers.minimax.baseUrl | MINIMAX_API_HOST | https://api.minimax.io | Host API MiniMax T2A. |
messages.tts.providers.minimax.model | MINIMAX_TTS_MODEL | speech-2.8-hd | Identyfikator modelu TTS. |
messages.tts.providers.minimax.voiceId | MINIMAX_TTS_VOICE_ID | English_expressive_narrator | Identyfikator głosu używany do wyjścia mowy. |
messages.tts.providers.minimax.speed | 1.0 | Szybkość odtwarzania, 0.5..2.0. | |
messages.tts.providers.minimax.vol | 1.0 | Głośność, (0, 10]. | |
messages.tts.providers.minimax.pitch | 0 | Całkowitoliczbowe przesunięcie wysokości tonu, -12..12. |
Generowanie muzyki
Dołączony Plugin MiniMax rejestruje generowanie muzyki przez wspólne narzędziemusic_generate zarówno dla minimax, jak i minimax-portal.
- Domyślny model muzyki:
minimax/music-2.6 - Model muzyki OAuth:
minimax-portal/music-2.6 - Obsługuje także
minimax/music-2.5iminimax/music-2.0 - Elementy sterujące promptem:
lyrics,instrumental,durationSeconds - Format wyjściowy:
mp3 - Uruchomienia oparte na sesji odłączają się przez wspólny przepływ zadań/statusu, w tym
action: "status"
Zobacz Generowanie muzyki, aby poznać wspólne parametry narzędzi, wybór dostawcy i zachowanie przełączania awaryjnego.
Generowanie wideo
Dołączony Plugin MiniMax rejestruje generowanie wideo przez wspólne narzędzievideo_generate zarówno dla minimax, jak i minimax-portal.
- Domyślny model wideo:
minimax/MiniMax-Hailuo-2.3 - Model wideo OAuth:
minimax-portal/MiniMax-Hailuo-2.3 - Tryby: przepływy tekstu na wideo i odniesienia do pojedynczego obrazu
- Obsługuje
aspectRatioiresolution
Zobacz Generowanie wideo, aby poznać wspólne parametry narzędzia, wybór dostawcy i zachowanie przełączania awaryjnego.
Rozumienie obrazów
Plugin MiniMax rejestruje rozumienie obrazów oddzielnie od katalogu tekstowego:| ID dostawcy | Domyślny model obrazu |
|---|---|
minimax | MiniMax-VL-01 |
minimax-portal | MiniMax-VL-01 |
Wyszukiwanie w sieci
Plugin MiniMax rejestruje takżeweb_search przez API wyszukiwania MiniMax Token Plan.
- ID dostawcy:
minimax - Wyniki strukturalne: tytuły, URL-e, fragmenty, powiązane zapytania
- Preferowana zmienna środowiskowa:
MINIMAX_CODE_PLAN_KEY - Akceptowane aliasy env:
MINIMAX_CODING_API_KEY,MINIMAX_OAUTH_TOKEN - Fallback zgodności:
MINIMAX_API_KEY, gdy już wskazuje na dane uwierzytelniające planu tokenów - Ponowne użycie regionu:
plugins.entries.minimax.config.webSearch.region, potemMINIMAX_API_HOST, potem bazowe URL-e dostawcy MiniMax - Wyszukiwanie pozostaje przy ID dostawcy
minimax; konfiguracja OAuth CN/global może pośrednio sterować regionem przezmodels.providers.minimax-portal.baseUrli może zapewniać uwierzytelnianie bearer przezMINIMAX_OAUTH_TOKEN
plugins.entries.minimax.config.webSearch.*.
Zobacz Wyszukiwanie MiniMax, aby poznać pełną konfigurację i użycie wyszukiwania w sieci.
Zaawansowana konfiguracja
Opcje konfiguracji
Opcje konfiguracji
| Opcja | Opis |
|---|---|
models.providers.minimax.baseUrl | Preferuj https://api.minimax.io/anthropic (zgodne z Anthropic); https://api.minimax.io/v1 jest opcjonalne dla ładunków zgodnych z OpenAI |
models.providers.minimax.api | Preferuj anthropic-messages; openai-completions jest opcjonalne dla ładunków zgodnych z OpenAI |
models.providers.minimax.apiKey | Klucz API MiniMax (MINIMAX_API_KEY) |
models.providers.minimax.models | Zdefiniuj id, name, reasoning, contextWindow, maxTokens, cost |
agents.defaults.models | Modele aliasów, które chcesz mieć na liście dozwolonych |
models.mode | Zachowaj merge, jeśli chcesz dodać MiniMax obok wbudowanych modeli |
Domyślne ustawienia rozumowania
Domyślne ustawienia rozumowania
Przy
api: "anthropic-messages" OpenClaw wstrzykuje thinking: { type: "disabled" }, chyba że rozumowanie jest już jawnie ustawione w parametrach/konfiguracji.Zapobiega to emitowaniu przez punkt końcowy strumieniowania MiniMax pól reasoning_content we fragmentach delta w stylu OpenAI, co ujawniłoby wewnętrzne rozumowanie w widocznym wyniku.Tryb szybki
Tryb szybki
/fast on lub params.fastMode: true zamienia MiniMax-M2.7 na MiniMax-M2.7-highspeed na ścieżce strumieniowania zgodnej z Anthropic.Przykład fallbacku
Przykład fallbacku
Najlepsze do: zachowania najsilniejszego modelu najnowszej generacji jako podstawowego i awaryjnego przełączania na MiniMax M2.7. Poniższy przykład używa Opus jako konkretnego modelu podstawowego; zamień go na preferowany model podstawowy najnowszej generacji.
Szczegóły użycia Coding Plan
Szczegóły użycia Coding Plan
- API użycia Coding Plan:
https://api.minimaxi.com/v1/token_plan/remainslubhttps://api.minimax.io/v1/token_plan/remains(wymaga klucza Coding Plan). - Odpytywanie użycia wyprowadza host z
models.providers.minimax-portal.baseUrllubmodels.providers.minimax.baseUrl, gdy jest skonfigurowany, więc konfiguracje globalne używającehttps://api.minimax.io/anthropicodpytująapi.minimax.io. Brakujące lub źle sformatowane bazowe URL-e zachowują fallback CN dla zgodności. - OpenClaw normalizuje użycie MiniMax coding-plan do tego samego wyświetlania
% left, którego używają inni dostawcy. Surowe pola MiniMaxusage_percent/usagePercentoznaczają pozostały limit, a nie wykorzystany limit, więc OpenClaw je odwraca. Pola oparte na licznikach mają pierwszeństwo, gdy są obecne. - Gdy API zwraca
model_remains, OpenClaw preferuje wpis modelu czatu, w razie potrzeby wyprowadza etykietę okna zstart_time/end_timei uwzględnia nazwę wybranego modelu w etykiecie planu, aby okna coding-plan były łatwiejsze do odróżnienia. - Migawki użycia traktują
minimax,minimax-cniminimax-portaljako ten sam obszar limitów MiniMax i preferują zapisane OAuth MiniMax przed fallbackiem do zmiennych środowiskowych klucza Coding Plan.
Notatki
- Odwołania do modeli podążają za ścieżką uwierzytelniania:
- Konfiguracja z kluczem API:
minimax/<model> - Konfiguracja OAuth:
minimax-portal/<model>
- Konfiguracja z kluczem API:
- Domyślny model czatu:
MiniMax-M2.7 - Alternatywny model czatu:
MiniMax-M2.7-highspeed - Proces konfiguracji początkowej i bezpośrednia konfiguracja z kluczem API zapisują definicje modeli tylko tekstowych dla obu wariantów M2.7
- Rozumienie obrazów używa należącego do Pluginu dostawcy mediów
MiniMax-VL-01 - Zaktualizuj wartości cen w
models.json, jeśli potrzebujesz dokładnego śledzenia kosztów - Użyj
openclaw models list, aby potwierdzić bieżący ID dostawcy, a następnie przełącz za pomocąopenclaw models set minimax/MiniMax-M2.7lubopenclaw models set minimax-portal/MiniMax-M2.7
Zobacz Dostawcy modeli, aby poznać reguły dostawców.
Rozwiązywanie problemów
"Nieznany model: minimax/MiniMax-M2.7"
"Nieznany model: minimax/MiniMax-M2.7"
Zwykle oznacza to, że dostawca MiniMax nie jest skonfigurowany (nie znaleziono pasującego wpisu dostawcy ani profilu uwierzytelniania/klucza środowiskowego MiniMax). Poprawka tego wykrywania jest w 2026.1.12. Możesz to naprawić przez:
- Uaktualnienie do 2026.1.12 (lub uruchomienie ze źródeł
main), a następnie ponowne uruchomienie Gateway. - Uruchomienie
openclaw configurei wybranie opcji uwierzytelniania MiniMax, albo - Ręczne dodanie pasującego bloku
models.providers.minimaxlubmodels.providers.minimax-portal, albo - Ustawienie
MINIMAX_API_KEY,MINIMAX_OAUTH_TOKENlub profilu uwierzytelniania MiniMax, aby można było wstrzyknąć pasującego dostawcę.
- Ścieżka klucza API:
minimax/MiniMax-M2.7lubminimax/MiniMax-M2.7-highspeed - Ścieżka OAuth:
minimax-portal/MiniMax-M2.7lubminimax-portal/MiniMax-M2.7-highspeed
Więcej pomocy: Rozwiązywanie problemów i FAQ.
Powiązane
Wybór modelu
Wybór dostawców, odwołań do modeli i zachowania przełączania awaryjnego.
Generowanie obrazów
Wspólne parametry narzędzia generowania obrazów i wybór dostawcy.
Generowanie muzyki
Wspólne parametry narzędzia generowania muzyki i wybór dostawcy.
Generowanie wideo
Wspólne parametry narzędzia generowania wideo i wybór dostawcy.
Wyszukiwanie MiniMax
Konfiguracja wyszukiwania w sieci przez MiniMax Token Plan.
Rozwiązywanie problemów
Ogólne rozwiązywanie problemów i FAQ.