MiniMax

OpenClaw's MiniMax-Provider verwendet standardmäßig MiniMax M2.7.

MiniMax bietet außerdem:

• Gebündelte Sprachsynthese über T2A v2
• Gebündeltes Bildverstehen über MiniMax-VL-01
• Gebündelte Musikgenerierung über music-2.6
• Gebündelte web_search über die MiniMax Token Plan Search API

Provider-Aufteilung:

# Integrierter Katalog

# Erste Schritte

Wählen Sie Ihre bevorzugte Authentifizierungsmethode und folgen Sie den Einrichtungsschritten.

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

# Über openclaw configure konfigurieren

Verwenden Sie den interaktiven Konfigurationsassistenten, um MiniMax ohne Bearbeitung von JSON einzurichten:

openclaw configure

# Funktionen

# Bildgenerierung

Das MiniMax-Plugin registriert das Modell image-01 für das Tool image_generate. Es unterstützt:

• Text-zu-Bild-Generierung mit Steuerung des Seitenverhältnisses
• Bild-zu-Bild-Bearbeitung (Subjektreferenz) mit Steuerung des Seitenverhältnisses
• Bis zu 9 Ausgabebilder pro Anfrage
• Bis zu 1 Referenzbild pro Bearbeitungsanfrage
• Unterstützte Seitenverhältnisse: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9

Um MiniMax für die Bildgenerierung zu verwenden, legen Sie es als Provider für die Bildgenerierung fest:

{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}

Das Plugin verwendet denselben MINIMAX_API_KEY oder dieselbe OAuth-Authentifizierung wie die Textmodelle. Es ist keine zusätzliche Konfiguration erforderlich, wenn MiniMax bereits eingerichtet ist.

Sowohl minimax als auch minimax-portal registrieren image_generate mit demselben Modell image-01. Setups mit API-Schlüssel verwenden MINIMAX_API_KEY; OAuth-Setups können stattdessen den gebündelten Auth-Pfad minimax-portal verwenden.

Die Bildgenerierung verwendet immer den dedizierten Bild-Endpunkt von MiniMax (/v1/image_generation) und ignoriert models.providers.minimax.baseUrl, da dieses Feld die Chat-/Anthropic-kompatible Basis-URL konfiguriert. Setzen Sie MINIMAX_API_HOST=https://api.minimaxi.com, um die Bildgenerierung über den CN-Endpunkt zu leiten; der globale Standardendpunkt ist https://api.minimax.io.

Wenn Onboarding oder die Einrichtung per API-Schlüssel explizite Einträge unter models.providers.minimax schreibt, materialisiert OpenClaw MiniMax-M2.7 und MiniMax-M2.7-highspeed als reine Text-Chat-Modelle. Bildverständnis wird separat über den Plugin-eigenen Medien-Provider MiniMax-VL-01 bereitgestellt.

# Text-zu-Sprache

Das gebündelte Plugin minimax registriert MiniMax T2A v2 als Sprach-Provider für messages.tts.

• Standard-TTS-Modell: speech-2.8-hd
• Standardstimme: English_expressive_narrator
• Unterstützte gebündelte Modell-IDs sind unter anderem 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 und speech-01-turbo.
• Die Auth-Auflösung erfolgt über messages.tts.providers.minimax.apiKey, dann OAuth-/Token-Auth-Profile von minimax-portal, dann Umgebungsschlüssel des Token Plan (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY) und dann MINIMAX_API_KEY.
• Wenn kein TTS-Host konfiguriert ist, verwendet OpenClaw den konfigurierten OAuth-Host von minimax-portal wieder und entfernt Anthropic-kompatible Pfadsuffixe wie /anthropic.
• Normale Audioanhänge bleiben MP3.
• Sprachnotiz-Ziele wie Feishu und Telegram werden mit ffmpeg von MiniMax MP3 in 48-kHz-Opus transkodiert, weil die Feishu/Lark-Datei-API für native Audionachrichten nur file_type: "opus" akzeptiert.
• MiniMax T2A akzeptiert gebrochene Werte für speed und vol, aber pitch wird als Ganzzahl gesendet; OpenClaw kürzt gebrochene pitch-Werte vor der API-Anfrage.

# Musikgenerierung

Das gebündelte MiniMax-Plugin registriert die Musikgenerierung über das gemeinsame Tool music_generate sowohl für minimax als auch für minimax-portal.

• Standard-Musikmodell: minimax/music-2.6
• OAuth-Musikmodell: minimax-portal/music-2.6
• Unterstützt außerdem minimax/music-2.5 und minimax/music-2.0
• Prompt-Steuerungen: lyrics, instrumental, durationSeconds
• Ausgabeformat: mp3
• Sitzungsbasierte Läufe werden über den gemeinsamen Aufgaben-/Statusablauf abgekoppelt, einschließlich action: "status"

Um MiniMax als Standard-Provider für Musik zu verwenden:

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.6",
      },
    },
  },
}

# Videogenerierung

Das gebündelte MiniMax-Plugin registriert die Videogenerierung über das gemeinsame Tool video_generate sowohl für minimax als auch für minimax-portal.

• Standard-Videomodell: minimax/MiniMax-Hailuo-2.3
• OAuth-Videomodell: minimax-portal/MiniMax-Hailuo-2.3
• Modi: Text-zu-Video und Abläufe mit Einzelbildreferenz
• Unterstützt aspectRatio und resolution

Um MiniMax als Standard-Provider für Video zu verwenden:

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}

# Bildverständnis

Das MiniMax-Plugin registriert Bildverständnis getrennt vom Textkatalog:

Deshalb kann das automatische Medien-Routing das MiniMax-Bildverständnis auch dann nutzen, wenn der gebündelte Text-Provider-Katalog weiterhin reine Text-Chat-Referenzen für M2.7 anzeigt.

# Websuche

Das MiniMax-Plugin registriert außerdem web_search über die Such-API des MiniMax Token Plan.

• Provider-ID: minimax
• Strukturierte Ergebnisse: Titel, URLs, Snippets, verwandte Abfragen
• Bevorzugte Umgebungsvariable: MINIMAX_CODE_PLAN_KEY
• Akzeptierte Umgebungsaliasse: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
• Kompatibilitäts-Fallback: MINIMAX_API_KEY, wenn sie bereits auf eine Token-Plan-Anmeldeinformation verweist
• Wiederverwendung der Region: plugins.entries.minimax.config.webSearch.region, dann MINIMAX_API_HOST, dann MiniMax-Provider-Basis-URLs
• Die Suche bleibt bei der Provider-ID minimax; die OAuth-CN/globale Einrichtung kann die Region indirekt über models.providers.minimax-portal.baseUrl steuern und Bearer-Auth über MINIMAX_OAUTH_TOKEN bereitstellen

Die Konfiguration befindet sich unter plugins.entries.minimax.config.webSearch.*.

# Erweiterte Konfiguration

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

# Hinweise

• Modellreferenzen folgen dem Authentifizierungspfad:
  • API-Schlüssel-Setup: minimax/<model>
  • OAuth-Setup: minimax-portal/<model>
• Standard-Chat-Modell: MiniMax-M2.7
• Alternatives Chat-Modell: MiniMax-M2.7-highspeed
• Onboarding und direktes API-Schlüssel-Setup schreiben reine Textmodelldefinitionen für beide M2.7-Varianten
• Bildverständnis verwendet den Plugin-eigenen Medien-Provider MiniMax-VL-01
• Aktualisieren Sie die Preiswerte in models.json, wenn Sie eine exakte Kostenverfolgung benötigen
• Verwenden Sie openclaw models list, um die aktuelle Provider-ID zu bestätigen, und wechseln Sie dann mit openclaw models set minimax/MiniMax-M2.7 oder openclaw models set minimax-portal/MiniMax-M2.7

# Fehlerbehebung

openclaw models list

# Verwandt