--- read_when: - Chcesz używać modeli MiniMax w OpenClaw - Potrzebujesz wskazówek dotyczących konfiguracji MiniMax summary: Korzystanie z modeli MiniMax w OpenClaw title: MiniMax x-i18n: generated_at: "2026-05-02T10:00:39Z" model: gpt-5.5 provider: openai source_hash: 7c7aea4d9656d6ffddab7c43b06940e58bdd119a03b62000e689a3348f7df5a2 source_path: providers/minimax.md workflow: 16 --- OpenClaw's MiniMax provider defaults to **MiniMax M2.7**. MiniMax also provides: - Bundled speech synthesis via T2A v2 - Bundled image understanding via `MiniMax-VL-01` - Bundled music generation via `music-2.6` - Bundled `web_search` through the MiniMax Token Plan search API Provider split: | 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. **Best for:** quick setup with MiniMax Coding Plan via OAuth, no API key required. ```bash openclaw onboard --auth-choice minimax-global-oauth ``` This authenticates against `api.minimax.io`. ```bash openclaw models list --provider minimax-portal ``` ```bash openclaw onboard --auth-choice minimax-cn-oauth ``` This authenticates against `api.minimaxi.com`. ```bash openclaw models list --provider minimax-portal ``` OAuth setups use the `minimax-portal` provider id. Model refs follow the form `minimax-portal/MiniMax-M2.7`. Referral link for MiniMax Coding Plan (10% off): [MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link) **Best for:** hosted MiniMax with Anthropic-compatible API. ```bash openclaw onboard --auth-choice minimax-global-api ``` This configures `api.minimax.io` as the base URL. ```bash openclaw models list --provider minimax ``` ```bash openclaw onboard --auth-choice minimax-cn-api ``` This configures `api.minimaxi.com` as the base URL. ```bash openclaw models list --provider minimax ``` ### Config example ```json5 { env: { MINIMAX_API_KEY: "sk-..." }, agents: { defaults: { model: { primary: "minimax/MiniMax-M2.7" } } }, models: { mode: "merge", providers: { minimax: { baseUrl: "https://api.minimax.io/anthropic", apiKey: "${MINIMAX_API_KEY}", api: "anthropic-messages", models: [ { 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, }, ], }, }, }, } ``` On the Anthropic-compatible streaming path, OpenClaw disables MiniMax thinking by default unless you explicitly set `thinking` yourself. MiniMax's streaming endpoint emits `reasoning_content` in OpenAI-style delta chunks instead of native Anthropic thinking blocks, which can leak internal reasoning into visible output if left enabled implicitly. API-key setups use the `minimax` provider id. Model refs follow the form `minimax/MiniMax-M2.7`. ## Configure via `openclaw configure` Use the interactive config wizard to set MiniMax without editing JSON: ```bash openclaw configure ``` Wybierz **Model/uwierzytelnianie** z menu. 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 | Po wyświetleniu monitu wybierz domyślny model. ## Możliwości ### Generowanie obrazów Plugin MiniMax rejestruje model `image-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` Aby używać MiniMax do generowania obrazów, ustaw go jako dostawcę generowania obrazów: ```json5 { agents: { defaults: { imageGenerationModel: { primary: "minimax/image-01" }, }, }, } ``` Plugin używa tego samego `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](/pl/tools/image-generation), aby poznać wspólne parametry narzędzi, wybór dostawcy i zachowanie przełączania awaryjnego. ### Zamiana tekstu na mowę Dołączony Plugin `minimax` 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-hd` i `speech-01-turbo`. - Rozwiązywanie uwierzytelniania przebiega w kolejności: `messages.tts.providers.minimax.apiKey`, następnie profile uwierzytelniania OAuth/token `minimax-portal`, następnie klucze środowiskowe Token Plan (`MINIMAX_OAUTH_TOKEN`, `MINIMAX_CODE_PLAN_KEY`, `MINIMAX_CODING_API_KEY`), a następnie `MINIMAX_API_KEY`. - Jeśli host TTS nie jest skonfigurowany, OpenClaw ponownie używa skonfigurowanego hosta OAuth `minimax-portal` i 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 tylko `file_type: "opus"` dla natywnych wiadomości audio. - MiniMax T2A akceptuje ułamkowe wartości `speed` i `vol`, ale `pitch` jest wysyłane jako liczba całkowita; OpenClaw obcina ułamkowe wartości `pitch` przed żą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ędzie `music_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.5` i `minimax/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"` Aby używać MiniMax jako domyślnego dostawcy muzyki: ```json5 { agents: { defaults: { musicGenerationModel: { primary: "minimax/music-2.6", }, }, }, } ``` Zobacz [Generowanie muzyki](/pl/tools/music-generation), 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ędzie `video_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 `aspectRatio` i `resolution` Aby używać MiniMax jako domyślnego dostawcy wideo: ```json5 { agents: { defaults: { videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3", }, }, }, } ``` Zobacz [Generowanie wideo](/pl/tools/video-generation), 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` | Dlatego automatyczne routowanie mediów może używać rozumienia obrazów MiniMax nawet wtedy, gdy dołączony katalog dostawców tekstu nadal pokazuje tylko tekstowe odwołania czatu M2.7. ### Wyszukiwanie w sieci Plugin MiniMax rejestruje także `web_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`, potem `MINIMAX_API_HOST`, potem bazowe URL-e dostawcy MiniMax - Wyszukiwanie pozostaje przy ID dostawcy `minimax`; konfiguracja OAuth CN/global może pośrednio sterować regionem przez `models.providers.minimax-portal.baseUrl` i może zapewniać uwierzytelnianie bearer przez `MINIMAX_OAUTH_TOKEN` Konfiguracja znajduje się pod `plugins.entries.minimax.config.webSearch.*`. Zobacz [Wyszukiwanie MiniMax](/pl/tools/minimax-search), aby poznać pełną konfigurację i użycie wyszukiwania w sieci. ## Zaawansowana konfiguracja | 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 | 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. `/fast on` lub `params.fastMode: true` zamienia `MiniMax-M2.7` na `MiniMax-M2.7-highspeed` na ścieżce strumieniowania zgodnej z Anthropic. **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. ```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"], }, }, }, } ``` - API użycia Coding Plan: `https://api.minimaxi.com/v1/token_plan/remains` lub `https://api.minimax.io/v1/token_plan/remains` (wymaga klucza Coding Plan). - Odpytywanie użycia wyprowadza host z `models.providers.minimax-portal.baseUrl` lub `models.providers.minimax.baseUrl`, gdy jest skonfigurowany, więc konfiguracje globalne używające `https://api.minimax.io/anthropic` odpytują `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 MiniMax `usage_percent` / `usagePercent` oznaczają 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 z `start_time` / `end_time` i uwzględnia nazwę wybranego modelu w etykiecie planu, aby okna coding-plan były łatwiejsze do odróżnienia. - Migawki użycia traktują `minimax`, `minimax-cn` i `minimax-portal` jako 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/` - Konfiguracja OAuth: `minimax-portal/` - 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.7` lub `openclaw models set minimax-portal/MiniMax-M2.7` Link polecający do MiniMax Coding Plan (10% zniżki): [MiniMax Coding Plan](https://platform.minimax.io/subscribe/coding-plan?code=DbXJTRClnb&source=link) Zobacz [Dostawcy modeli](/pl/concepts/model-providers), aby poznać reguły dostawców. ## Rozwiązywanie problemów 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 configure` i wybranie opcji uwierzytelniania **MiniMax**, albo - Ręczne dodanie pasującego bloku `models.providers.minimax` lub `models.providers.minimax-portal`, albo - Ustawienie `MINIMAX_API_KEY`, `MINIMAX_OAUTH_TOKEN` lub profilu uwierzytelniania MiniMax, aby można było wstrzyknąć pasującego dostawcę. Pamiętaj, że ID modelu rozróżnia wielkość liter: - Ścieżka klucza API: `minimax/MiniMax-M2.7` lub `minimax/MiniMax-M2.7-highspeed` - Ścieżka OAuth: `minimax-portal/MiniMax-M2.7` lub `minimax-portal/MiniMax-M2.7-highspeed` Następnie sprawdź ponownie za pomocą: ```bash openclaw models list ``` Więcej pomocy: [Rozwiązywanie problemów](/pl/help/troubleshooting) i [FAQ](/pl/help/faq). ## Powiązane Wybór dostawców, odwołań do modeli i zachowania przełączania awaryjnego. Wspólne parametry narzędzia generowania obrazów i wybór dostawcy. Wspólne parametry narzędzia generowania muzyki i wybór dostawcy. Wspólne parametry narzędzia generowania wideo i wybór dostawcy. Konfiguracja wyszukiwania w sieci przez MiniMax Token Plan. Ogólne rozwiązywanie problemów i FAQ.