MiniMax

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:

# Built-in catalog

# Getting started

Choose your preferred auth method and follow the setup steps.

openclaw onboard --auth-choice minimax-global-oauth

openclaw models list --provider minimax-portal

openclaw onboard --auth-choice minimax-cn-oauth

openclaw models list --provider minimax-portal

openclaw onboard --auth-choice minimax-global-api

openclaw models list --provider minimax

openclaw onboard --auth-choice minimax-cn-api

openclaw models list --provider minimax

{
  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,
          },
        ],
      },
    },
  },
}

# Configure via openclaw configure

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

openclaw configure

# 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.

# 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.

# 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",
      },
    },
  },
}

# 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",
      },
    },
  },
}

# Rozumienie obrazów

Plugin MiniMax rejestruje rozumienie obrazów oddzielnie od katalogu tekstowego:

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.*.

# Zaawansowana konfiguracja

{
  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"],
      },
    },
  },
}

# 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

# Rozwiązywanie problemów

openclaw models list

# Powiązane