- Wbudowaną syntezę mowy przez T2A v2
- Wbudowane rozumienie obrazów przez
MiniMax-VL-01 - Wbudowane generowanie muzyki przez
music-2.6 - Wbudowane
web_searchprzez API wyszukiwania MiniMax Token Plan
| ID dostawcy | Uwierzytelnianie | Możliwości |
|---|---|---|
minimax | Klucz API | Tekst, generowanie obrazów, generowanie muzyki, generowanie wideo, rozumienie obrazów, mowa, wyszukiwanie w sieci |
minimax-portal | OAuth | Tekst, generowanie obrazów, generowanie muzyki, generowanie wideo, rozumienie obrazów, mowa |
Wbudowany katalog
| Model | Typ | Opis |
|---|---|---|
MiniMax-M3 | Czat (rozumowanie) | Domyślny hostowany model rozumowania |
MiniMax-M2.7 | Czat (rozumowanie) | Poprzedni hostowany model rozumowania |
MiniMax-M2.7-highspeed | Czat (rozumowanie) | Szybsza warstwa rozumowania M2.7 |
MiniMax-VL-01 | Wizja | Model rozumienia obrazów |
image-01 | Generowanie obrazów | Edycja tekst-na-obraz i obraz-na-obraz |
music-2.6 | Generowanie muzyki | Domyślny model muzyki |
music-2.5 | Generowanie muzyki | Poprzednia warstwa generowania muzyki |
music-2.0 | Generowanie muzyki | Starsza warstwa generowania muzyki |
MiniMax-Hailuo-2.3 | Generowanie wideo | Przepływy tekst-na-wideo i z obrazem referencyjnym |
Pierwsze kroki
Wybierz preferowaną metodę uwierzytelniania i wykonaj kroki konfiguracji.- OAuth (Coding Plan)
- API key
Najlepsze dla: szybkiej konfiguracji z MiniMax Coding Plan przez OAuth, bez wymaganego klucza API.
- International
- China
Konfiguracje OAuth używają identyfikatora dostawcy
minimax-portal. Odwołania do modeli mają postać minimax-portal/MiniMax-M3.Konfiguracja przez openclaw configure
Użyj interaktywnego kreatora konfiguracji, aby ustawić MiniMax bez edytowania JSON:
Choose a MiniMax auth option
Wybierz jedną z dostępnych opcji MiniMax:
| Wybór uwierzytelniania | Opis |
|---|---|
minimax-global-oauth | Międzynarodowy OAuth (Coding Plan) |
minimax-cn-oauth | Chiński OAuth (Coding Plan) |
minimax-global-api | Międzynarodowy klucz API |
minimax-cn-api | Chiński klucz API |
Możliwości
Generowanie obrazów
Plugin MiniMax rejestruje modelimage-01 dla narzędzia image_generate. Obsługuje on:
- Generowanie obrazów z tekstu z kontrolą proporcji
- Edycję obraz-na-obraz (referencja obiektu) z kontrolą proporcji
- Do 9 obrazów wynikowych na żądanie
- Do 1 obrazu referencyjnego na żądanie edycji
- Obsługiwane proporcje:
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ć
wbudowanej ścieżki uwierzytelniania minimax-portal.
Generowanie obrazów zawsze używa dedykowanego punktu końcowego obrazów MiniMax
(/v1/image_generation) i ignoruje models.providers.minimax.baseUrl,
ponieważ to pole konfiguruje bazowy adres URL czatu zgodny z Anthropic. Ustaw
MINIMAX_API_HOST=https://api.minimaxi.com, aby kierować generowanie obrazów
przez punkt końcowy CN; domyślny globalny punkt końcowy to
https://api.minimax.io.
Gdy onboarding lub konfiguracja z kluczem API zapisuje jawne wpisy models.providers.minimax,
OpenClaw materializuje MiniMax-M3, MiniMax-M2.7 i
MiniMax-M2.7-highspeed jako modele czatu. M3 deklaruje obsługę wejścia tekstowego i obrazowego;
rozumienie obrazów pozostaje udostępnione osobno przez należącego do Plugin
dostawcę mediów MiniMax-VL-01.
Zobacz Generowanie obrazów, aby poznać wspólne parametry narzędzia, wybór dostawcy i zachowanie przełączania awaryjnego.
Zamiana tekstu na mowę
Wbudowany 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 wbudowane 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. - Rozpoznawanie uwierzytelniania używa kolejno
messages.tts.providers.minimax.apiKey, potem profili uwierzytelniania OAuth/tokenminimax-portal, potem kluczy środowiskowych 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 zgodnych 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 MiniMax
MP3 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ślna | 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 | ID modelu TTS. |
messages.tts.providers.minimax.speakerVoiceId | MINIMAX_TTS_VOICE_ID | English_expressive_narrator | ID głosu używany dla wyniku 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łkowite przesunięcie wysokości tonu, -12..12. |
Generowanie muzyki
Wbudowany Plugin MiniMax rejestruje generowanie muzyki przez współdzielone 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 - Kontrolki promptu:
lyrics,instrumental - Format wyjściowy:
mp3 - Uruchomienia oparte na sesji odłączają się przez współdzielony przepływ zadań/statusu, w tym
action: "status"
Zobacz Generowanie muzyki, aby poznać współdzielone parametry narzędzia, wybór dostawcy i zachowanie przełączania awaryjnego.
Generowanie wideo
Dołączony Plugin MiniMax rejestruje generowanie wideo przez współdzielone 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 tekst-na-wideo i referencji pojedynczego obrazu
- Obsługuje
aspectRatioiresolution
Zobacz Generowanie wideo, aby poznać współdzielone parametry narzędzia, wybór dostawcy i zachowanie przełączania awaryjnego.
Rozumienie obrazu
Plugin MiniMax rejestruje rozumienie obrazu osobno względem katalogu tekstowego:| Identyfikator dostawcy | Domyślny model obrazu |
|---|---|
minimax | MiniMax-VL-01 |
minimax-portal | MiniMax-VL-01 |
Wyszukiwanie w internecie
Plugin MiniMax rejestruje takżeweb_search przez interfejs API wyszukiwania MiniMax Token Plan.
- Identyfikator dostawcy:
minimax - Wyniki strukturalne: tytuły, adresy URL, fragmenty, powiązane zapytania
- Preferowana zmienna środowiskowa:
MINIMAX_CODE_PLAN_KEY - Akceptowane aliasy środowiskowe:
MINIMAX_CODING_API_KEY,MINIMAX_OAUTH_TOKEN - Awaryjna zgodność:
MINIMAX_API_KEY, gdy wskazuje już poświadczenie planu tokenów - Ponowne użycie regionu:
plugins.entries.minimax.config.webSearch.region, następnieMINIMAX_API_HOST, następnie bazowe adresy URL dostawcy MiniMax - Wyszukiwanie pozostaje przy identyfikatorze dostawcy
minimax; konfiguracja OAuth CN/global może pośrednio sterować regionem przezmodels.providers.minimax-portal.baseUrli może dostarczać uwierzytelnianie bearer przezMINIMAX_OAUTH_TOKEN
plugins.entries.minimax.config.webSearch.*.
Zobacz MiniMax Search, aby poznać pełną konfigurację i użycie wyszukiwania w internecie.
Konfiguracja zaawansowana
Configuration options
Configuration options
| 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 | Aliasuj modele, które chcesz umieścić na liście dozwolonych |
models.mode | Zachowaj merge, jeśli chcesz dodać MiniMax obok wbudowanych modeli |
Thinking defaults
Thinking defaults
Przy
api: "anthropic-messages" OpenClaw wstrzykuje thinking: { type: "disabled" } dla modeli MiniMax M2.x, chyba że thinking jest już jawnie ustawione w parametrach/konfiguracji.Zapobiega to emitowaniu przez punkt końcowy strumieniowania M2.x reasoning_content w fragmentach delta w stylu OpenAI, co ujawniłoby wewnętrzne rozumowanie w widocznym wyjściu.MiniMax-M3 (i M3.x) jest wyłączony z tej reguły: M3 emituje poprawne bloki thinking Anthropic i zwraca pustą tablicę content z stop_reason: "end_turn", gdy thinking jest wyłączone, więc wrapper utrzymuje M3 na pominiętej/adaptacyjnej ścieżce thinking dostawcy.Fast mode
Fast mode
/fast on lub params.fastMode: true przepisuje MiniMax-M2.7 na MiniMax-M2.7-highspeed na ścieżce strumieniowania zgodnej z Anthropic.Fallback example
Fallback example
Najlepsze dla: zachowania najsilniejszego modelu najnowszej generacji jako podstawowego i przełączania awaryjnego na MiniMax M2.7. Poniższy przykład używa Opus jako konkretnego modelu podstawowego; zamień go na preferowany podstawowy model najnowszej generacji.
Coding Plan usage details
Coding Plan usage details
- Interfejs API użycia Coding Plan:
https://api.minimaxi.com/v1/token_plan/remainslubhttps://api.minimax.io/v1/token_plan/remains(wymaga klucza planu kodowania). - Odpytywanie użycia wyprowadza hosta z
models.providers.minimax-portal.baseUrllubmodels.providers.minimax.baseUrl, gdy jest skonfigurowane, więc konfiguracje globalne używającehttps://api.minimax.io/anthropicodpytująapi.minimax.io. Brakujące lub niepoprawnie sformatowane bazowe adresy URL zachowują awaryjną zgodność CN. - OpenClaw normalizuje użycie planu kodowania MiniMax do tego samego wyświetlania
% left, którego używają inni dostawcy. Surowe pola MiniMaxusage_percent/usagePercentoznaczają pozostały limit, a nie zużyty limit, więc OpenClaw je odwraca. Pola oparte na liczbach mają pierwszeństwo, gdy są obecne. - Gdy interfejs API zwraca
model_remains, OpenClaw preferuje wpis modelu czatu, wyprowadza etykietę okna zstart_time/end_time, gdy jest to potrzebne, i dołącza nazwę wybranego modelu do etykiety planu, aby okna planu kodowania były łatwiejsze do rozróżnienia. - Migawki użycia traktują
minimax,minimax-cniminimax-portaljako tę samą powierzchnię limitu MiniMax oraz preferują zapisany OAuth MiniMax przed powrotem do zmiennych środowiskowych klucza Coding Plan.
Uwagi
- Referencje modeli podążają ścieżką uwierzytelniania:
- Konfiguracja z kluczem API:
minimax/<model> - Konfiguracja OAuth:
minimax-portal/<model>
- Konfiguracja z kluczem API:
- Domyślny model czatu:
MiniMax-M3 - Alternatywne modele czatu:
MiniMax-M2.7,MiniMax-M2.7-highspeed - Onboarding i bezpośrednia konfiguracja klucza API zapisują definicje modeli dla M3 oraz obu wariantów M2.7
- Rozumienie obrazu używa należącego do Pluginu dostawcy multimedió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 identyfikator dostawcy, a następnie przełącz za pomocąopenclaw models set minimax/MiniMax-M3lubopenclaw models set minimax-portal/MiniMax-M3
Zobacz Dostawcy modeli, aby poznać reguły dostawców.
Rozwiązywanie problemów
"Unknown model: minimax/MiniMax-M3"
"Unknown model: minimax/MiniMax-M3"
Zwykle oznacza to, że dostawca MiniMax nie jest skonfigurowany (brak pasującego wpisu dostawcy i brak profilu uwierzytelniania MiniMax/klucza środowiskowego). Poprawka dla tego wykrywania jest w 2026.1.12. Napraw 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-M3,minimax/MiniMax-M2.7lubminimax/MiniMax-M2.7-highspeed - Ścieżka OAuth:
minimax-portal/MiniMax-M3,minimax-portal/MiniMax-M2.7lubminimax-portal/MiniMax-M2.7-highspeed
Więcej pomocy: Rozwiązywanie problemów i FAQ.
Powiązane
Model selection
Wybieranie dostawców, referencji modeli i zachowania przełączania awaryjnego.
Image generation
Współdzielone parametry narzędzia obrazu i wybór dostawcy.
Music generation
Współdzielone parametry narzędzia muzyki i wybór dostawcy.
Video generation
Współdzielone parametry narzędzia wideo i wybór dostawcy.
MiniMax Search
Konfiguracja wyszukiwania w internecie przez MiniMax Token Plan.
Troubleshooting
Ogólne rozwiązywanie problemów i FAQ.