Przejdź do głównej treści
OpenClaw domyślnie używa MiniMax M3 dla dostawcy MiniMax. MiniMax zapewnia też:
  • Wbudowaną syntezę mowy przez T2A v2
  • Wbudowane rozumienie obrazów przez MiniMax-VL-01
  • Wbudowane generowanie muzyki przez music-2.6
  • Wbudowane web_search przez API wyszukiwania MiniMax Token Plan
Podział dostawców:
ID dostawcyUwierzytelnianieMożliwości
minimaxKlucz APITekst, generowanie obrazów, generowanie muzyki, generowanie wideo, rozumienie obrazów, mowa, wyszukiwanie w sieci
minimax-portalOAuthTekst, generowanie obrazów, generowanie muzyki, generowanie wideo, rozumienie obrazów, mowa

Wbudowany katalog

ModelTypOpis
MiniMax-M3Czat (rozumowanie)Domyślny hostowany model rozumowania
MiniMax-M2.7Czat (rozumowanie)Poprzedni hostowany model rozumowania
MiniMax-M2.7-highspeedCzat (rozumowanie)Szybsza warstwa rozumowania M2.7
MiniMax-VL-01WizjaModel rozumienia obrazów
image-01Generowanie obrazówEdycja tekst-na-obraz i obraz-na-obraz
music-2.6Generowanie muzykiDomyślny model muzyki
music-2.5Generowanie muzykiPoprzednia warstwa generowania muzyki
music-2.0Generowanie muzykiStarsza warstwa generowania muzyki
MiniMax-Hailuo-2.3Generowanie wideoPrzepływy tekst-na-wideo i z obrazem referencyjnym

Pierwsze kroki

Wybierz preferowaną metodę uwierzytelniania i wykonaj kroki konfiguracji.
Najlepsze dla: szybkiej konfiguracji z MiniMax Coding Plan przez OAuth, bez wymaganego klucza API.
1

Run onboarding

openclaw onboard --auth-choice minimax-global-oauth
To uwierzytelnia względem api.minimax.io.
2

Verify the model is available

openclaw models list --provider minimax-portal
Konfiguracje OAuth używają identyfikatora dostawcy minimax-portal. Odwołania do modeli mają postać minimax-portal/MiniMax-M3.
Link polecający do MiniMax Coding Plan (10% zniżki): MiniMax Coding Plan

Konfiguracja przez openclaw configure

Użyj interaktywnego kreatora konfiguracji, aby ustawić MiniMax bez edytowania JSON:
1

Launch the wizard

openclaw configure
2

Select Model/auth

Wybierz Model/auth z menu.
3

Choose a MiniMax auth option

Wybierz jedną z dostępnych opcji MiniMax:
Wybór uwierzytelnianiaOpis
minimax-global-oauthMiędzynarodowy OAuth (Coding Plan)
minimax-cn-oauthChiński OAuth (Coding Plan)
minimax-global-apiMiędzynarodowy klucz API
minimax-cn-apiChiński klucz API
4

Pick your default model

Wybierz domyślny model po wyświetleniu monitu.

Możliwości

Generowanie obrazów

Plugin MiniMax rejestruje model image-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
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ć 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 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 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-hd i speech-01-turbo.
  • Rozpoznawanie uwierzytelniania używa kolejno messages.tts.providers.minimax.apiKey, potem profili uwierzytelniania OAuth/token minimax-portal, potem kluczy środowiskowych 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 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 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ślnaOpis
messages.tts.providers.minimax.baseUrlMINIMAX_API_HOSThttps://api.minimax.ioHost API MiniMax T2A.
messages.tts.providers.minimax.modelMINIMAX_TTS_MODELspeech-2.8-hdID modelu TTS.
messages.tts.providers.minimax.speakerVoiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narratorID głosu używany dla wyniku 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łkowite przesunięcie wysokości tonu, -12..12.

Generowanie muzyki

Wbudowany Plugin MiniMax rejestruje generowanie muzyki przez współdzielone 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
  • 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"
Aby użyć MiniMax jako domyślnego dostawcy muzyki:
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.6",
      },
    },
  },
}
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ę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 tekst-na-wideo i referencji pojedynczego obrazu
  • Obsługuje aspectRatio i resolution
Aby użyć MiniMax jako domyślnego dostawcy wideo:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
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 dostawcyDomyślny model obrazu
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
Dlatego automatyczne routowanie multimediów może używać rozumienia obrazu MiniMax nawet wtedy, gdy dołączony katalog dostawców tekstu zawiera także referencje czatu M3 obsługujące obrazy.

Wyszukiwanie w internecie

Plugin MiniMax rejestruje także web_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ępnie MINIMAX_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 przez models.providers.minimax-portal.baseUrl i może dostarczać uwierzytelnianie bearer przez MINIMAX_OAUTH_TOKEN
Konfiguracja znajduje się pod plugins.entries.minimax.config.webSearch.*.
Zobacz MiniMax Search, aby poznać pełną konfigurację i użycie wyszukiwania w internecie.

Konfiguracja zaawansowana

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.modelsAliasuj modele, które chcesz umieścić na liście dozwolonych
models.modeZachowaj merge, jeśli chcesz dodać MiniMax obok wbudowanych modeli
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 on lub params.fastMode: true przepisuje MiniMax-M2.7 na MiniMax-M2.7-highspeed na ścieżce strumieniowania zgodnej z Anthropic.
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.
{
  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"],
      },
    },
  },
}
  • Interfejs API użycia Coding Plan: https://api.minimaxi.com/v1/token_plan/remains lub https://api.minimax.io/v1/token_plan/remains (wymaga klucza planu kodowania).
  • Odpytywanie użycia wyprowadza hosta z models.providers.minimax-portal.baseUrl lub models.providers.minimax.baseUrl, gdy jest skonfigurowane, więc konfiguracje globalne używające https://api.minimax.io/anthropic odpytują 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 MiniMax usage_percent / usagePercent oznaczają 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 z start_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-cn i minimax-portal jako 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>
  • 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-M3 lub openclaw models set minimax-portal/MiniMax-M3
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 (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 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ę.
Upewnij się, że identyfikator modelu rozróżnia wielkość liter:
  • Ścieżka klucza API: minimax/MiniMax-M3, minimax/MiniMax-M2.7 lub minimax/MiniMax-M2.7-highspeed
  • Ścieżka OAuth: minimax-portal/MiniMax-M3, 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

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.