Przejdź do głównej treści

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.

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 IDAuthCapabilities
minimaxAPI keyText, image generation, music generation, video generation, image understanding, speech, web search
minimax-portalOAuthText, image generation, music generation, video generation, image understanding, speech

Built-in catalog

ModelTypeDescription
MiniMax-M2.7Chat (reasoning)Default hosted reasoning model
MiniMax-M2.7-highspeedChat (reasoning)Faster M2.7 reasoning tier
MiniMax-VL-01VisionImage understanding model
image-01Image generationText-to-image and image-to-image editing
music-2.6Music generationDefault music model
music-2.5Music generationPrevious music generation tier
music-2.0Music generationLegacy music generation tier
MiniMax-Hailuo-2.3Video generationText-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.
1

Run onboarding

openclaw onboard --auth-choice minimax-global-oauth
This authenticates against api.minimax.io.
2

Verify the model is available

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

Configure via openclaw configure

Use the interactive config wizard to set MiniMax without editing JSON:
1

Uruchom kreator

openclaw configure
2

Wybierz Model/uwierzytelnianie

Wybierz Model/uwierzytelnianie z menu.
3

Wybierz opcję uwierzytelniania MiniMax

Wybierz jedną z dostępnych opcji MiniMax:
Wybór uwierzytelnianiaOpis
minimax-global-oauthMiędzynarodowe OAuth (Coding Plan)
minimax-cn-oauthOAuth dla Chin (Coding Plan)
minimax-global-apiMiędzynarodowy klucz API
minimax-cn-apiKlucz API dla Chin
4

Wybierz domyślny model

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:
{
  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, 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.
UstawienieZmienna środowiskowaDomyślneOpis
messages.tts.providers.minimax.baseUrlMINIMAX_API_HOSThttps://api.minimax.ioHost API MiniMax T2A.
messages.tts.providers.minimax.modelMINIMAX_TTS_MODELspeech-2.8-hdIdentyfikator modelu TTS.
messages.tts.providers.minimax.voiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narratorIdentyfikator głosu używany do wyjścia mowy.
messages.tts.providers.minimax.speed1.0Szybkość odtwarzania, 0.5..2.0.
messages.tts.providers.minimax.vol1.0Głośność, (0, 10].
messages.tts.providers.minimax.pitch0Cał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:
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.6",
      },
    },
  },
}
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ę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:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
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 dostawcyDomyślny model obrazu
minimaxMiniMax-VL-01
minimax-portalMiniMax-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, aby poznać pełną konfigurację i użycie wyszukiwania w sieci.

Zaawansowana konfiguracja

OpcjaOpis
models.providers.minimax.baseUrlPreferuj https://api.minimax.io/anthropic (zgodne z Anthropic); https://api.minimax.io/v1 jest opcjonalne dla ładunków zgodnych z OpenAI
models.providers.minimax.apiPreferuj anthropic-messages; openai-completions jest opcjonalne dla ładunków zgodnych z OpenAI
models.providers.minimax.apiKeyKlucz API MiniMax (MINIMAX_API_KEY)
models.providers.minimax.modelsZdefiniuj id, name, reasoning, contextWindow, maxTokens, cost
agents.defaults.modelsModele aliasów, które chcesz mieć na liście dozwolonych
models.modeZachowaj 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.
{
  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/<model>
    • Konfiguracja OAuth: minimax-portal/<model>
  • 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
Zobacz Dostawcy modeli, 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ą:
openclaw models list
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.