Zum Hauptinhalt springen
OpenClaws MiniMax-Provider verwendet standardmäßig MiniMax M3. MiniMax bietet außerdem:
  • Mitgelieferte Sprachsynthese über T2A v2
  • Mitgeliefertes Bildverstehen über MiniMax-VL-01
  • Mitgelieferte Musikgenerierung über music-2.6
  • Mitgeliefertes web_search über die MiniMax Token Plan Search API
Provider-Aufteilung:
Provider-IDAuthFähigkeiten
minimaxAPI-SchlüsselText, Bildgenerierung, Musikgenerierung, Videogenerierung, Bildverstehen, Sprache, Websuche
minimax-portalOAuthText, Bildgenerierung, Musikgenerierung, Videogenerierung, Bildverstehen, Sprache

Integrierter Katalog

ModellTypBeschreibung
MiniMax-M3Chat (Reasoning)Standardmäßig gehostetes Reasoning-Modell
MiniMax-M2.7Chat (Reasoning)Vorheriges gehostetes Reasoning-Modell
MiniMax-M2.7-highspeedChat (Reasoning)Schnellere M2.7-Reasoning-Stufe
MiniMax-VL-01VisionModell für Bildverstehen
image-01BildgenerierungText-zu-Bild- und Bild-zu-Bild-Bearbeitung
music-2.6MusikgenerierungStandard-Musikmodell
music-2.5MusikgenerierungVorherige Stufe für Musikgenerierung
music-2.0MusikgenerierungLegacy-Stufe für Musikgenerierung
MiniMax-Hailuo-2.3VideogenerierungText-zu-Video- und Bildreferenz-Abläufe

Erste Schritte

Wählen Sie Ihre bevorzugte Auth-Methode und folgen Sie den Einrichtungsschritten.
Am besten geeignet für: schnelle Einrichtung mit dem MiniMax Coding Plan über OAuth, kein API-Schlüssel erforderlich.
1

Run onboarding

openclaw onboard --auth-choice minimax-global-oauth
Dies authentifiziert gegen api.minimax.io.
2

Verify the model is available

openclaw models list --provider minimax-portal
OAuth-Einrichtungen verwenden die Provider-ID minimax-portal. Modellreferenzen folgen der Form minimax-portal/MiniMax-M3.
Empfehlungslink für den MiniMax Coding Plan (10 % Rabatt): MiniMax Coding Plan

Über openclaw configure konfigurieren

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

Launch the wizard

openclaw configure
2

Select Model/auth

Wählen Sie Model/auth aus dem Menü.
3

Choose a MiniMax auth option

Wählen Sie eine der verfügbaren MiniMax-Optionen aus:
Auth-AuswahlBeschreibung
minimax-global-oauthInternationales OAuth (Coding Plan)
minimax-cn-oauthChina-OAuth (Coding Plan)
minimax-global-apiInternationaler API-Schlüssel
minimax-cn-apiChina-API-Schlüssel
4

Pick your default model

Wählen Sie Ihr Standardmodell aus, wenn Sie dazu aufgefordert werden.

Fähigkeiten

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 (Motivreferenz) 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. Wenn MiniMax bereits eingerichtet ist, ist keine zusätzliche Konfiguration erforderlich. Sowohl minimax als auch minimax-portal registrieren image_generate mit demselben Modell image-01. API-Schlüssel-Einrichtungen verwenden MINIMAX_API_KEY; OAuth-Einrichtungen können stattdessen den mitgelieferten 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 standardmäßige globale Endpunkt ist https://api.minimax.io. Wenn Onboarding oder API-Schlüssel-Einrichtung explizite Einträge für models.providers.minimax schreibt, materialisiert OpenClaw MiniMax-M3, MiniMax-M2.7 und MiniMax-M2.7-highspeed als Chat-Modelle. M3 weist Text- und Bildeingabe aus; Bildverstehen bleibt separat über den Plugin-eigenen Medien-Provider MiniMax-VL-01 verfügbar.
Siehe Bildgenerierung für gemeinsame Tool-Parameter, Provider-Auswahl und Failover-Verhalten.

Text-zu-Sprache

Das mitgelieferte 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 mitgelieferte Modell-IDs umfassen 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 ist messages.tts.providers.minimax.apiKey, dann OAuth-/Token-Auth-Profile für minimax-portal, dann Token-Plan-Umgebungs- schlüssel (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), dann MINIMAX_API_KEY.
  • Wenn kein TTS-Host konfiguriert ist, verwendet OpenClaw den konfigurierten OAuth-Host minimax-portal erneut 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, da 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.
EinstellungEnv-VarStandardBeschreibung
messages.tts.providers.minimax.baseUrlMINIMAX_API_HOSThttps://api.minimax.ioMiniMax-T2A-API-Host.
messages.tts.providers.minimax.modelMINIMAX_TTS_MODELspeech-2.8-hdTTS-Modell-ID.
messages.tts.providers.minimax.speakerVoiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narratorStimm-ID für Sprachausgabe.
messages.tts.providers.minimax.speed1.0Wiedergabegeschwindigkeit, 0.5..2.0.
messages.tts.providers.minimax.vol1.0Lautstärke, (0, 10].
messages.tts.providers.minimax.pitch0Ganzzahlige Tonhöhenverschiebung, -12..12.

Musikgenerierung

Das mitgelieferte MiniMax-Plugin registriert Musikgenerierung über das gemeinsame Tool music_generate für sowohl minimax als auch 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
  • Ausgabeformat: mp3
  • Sitzungsbasierte Läufe werden über den gemeinsamen Aufgaben-/Statusfluss entkoppelt, einschließlich action: "status"
So verwenden Sie MiniMax als Standard-Musik-Provider:
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.6",
      },
    },
  },
}
Siehe Musikgenerierung für gemeinsame Tool-Parameter, Provider-Auswahl und Failover-Verhalten.

Videogenerierung

Das gebündelte MiniMax-Plugin registriert Videogenerierung über das gemeinsame Tool video_generate für sowohl minimax als auch minimax-portal.
  • Standard-Videomodell: minimax/MiniMax-Hailuo-2.3
  • OAuth-Videomodell: minimax-portal/MiniMax-Hailuo-2.3
  • Modi: Text-zu-Video- und Referenzflüsse mit Einzelbild
  • Unterstützt aspectRatio und resolution
So verwenden Sie MiniMax als Standard-Video-Provider:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
Siehe Videogenerierung für gemeinsame Tool-Parameter, Provider-Auswahl und Failover-Verhalten.

Bildverständnis

Das MiniMax-Plugin registriert Bildverständnis getrennt vom Textkatalog:
Provider-IDStandard-Bildmodell
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
Deshalb kann automatisches Medienrouting das MiniMax-Bildverständnis verwenden, auch wenn der gebündelte Text-Provider-Katalog ebenfalls M3-chatfähige Referenzen mit Bildunterstützung enthält.

Websuche

Das MiniMax-Plugin registriert außerdem web_search über die MiniMax Token Plan Search API.
  • Provider-ID: minimax
  • Strukturierte Ergebnisse: Titel, URLs, Snippets, verwandte Suchanfragen
  • Bevorzugte Umgebungsvariable: MINIMAX_CODE_PLAN_KEY
  • Akzeptierte Umgebungsaliasnamen: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
  • Kompatibilitäts-Fallback: MINIMAX_API_KEY, wenn sie bereits auf eine Token-Plan-Berechtigung verweist
  • Regionswiederverwendung: plugins.entries.minimax.config.webSearch.region, dann MINIMAX_API_HOST, dann MiniMax-Provider-Basis-URLs
  • Die Suche bleibt auf der Provider-ID minimax; die OAuth-Einrichtung für CN/global kann die Region indirekt über models.providers.minimax-portal.baseUrl steuern und Bearer-Authentifizierung über MINIMAX_OAUTH_TOKEN bereitstellen
Die Konfiguration liegt unter plugins.entries.minimax.config.webSearch.*.
Siehe MiniMax-Suche für die vollständige Websuchkonfiguration und Nutzung.

Erweiterte Konfiguration

OptionBeschreibung
models.providers.minimax.baseUrlBevorzugt https://api.minimax.io/anthropic (Anthropic-kompatibel); https://api.minimax.io/v1 ist optional für OpenAI-kompatible Payloads
models.providers.minimax.apiBevorzugt anthropic-messages; openai-completions ist optional für OpenAI-kompatible Payloads
models.providers.minimax.apiKeyMiniMax-API-Schlüssel (MINIMAX_API_KEY)
models.providers.minimax.modelsDefiniert id, name, reasoning, contextWindow, maxTokens, cost
agents.defaults.modelsWeisen Sie Modellen, die Sie in der Allowlist haben möchten, Aliasnamen zu
models.modeBehalten Sie merge bei, wenn Sie MiniMax zusätzlich zu den integrierten Providern hinzufügen möchten
Bei api: "anthropic-messages" injiziert OpenClaw thinking: { type: "disabled" } für MiniMax-M2.x-Modelle, sofern Thinking nicht bereits explizit in Parametern/Konfiguration gesetzt ist.Dadurch wird verhindert, dass der Streaming-Endpunkt von M2.x reasoning_content in OpenAI-artigen Delta-Chunks ausgibt, was internes Reasoning in sichtbare Ausgaben leaken würde.MiniMax-M3 (und M3.x) ist ausgenommen: M3 gibt korrekte Anthropic-Thinking-Blöcke aus und liefert ein leeres content-Array mit stop_reason: "end_turn", wenn Thinking deaktiviert ist. Deshalb belässt der Wrapper M3 auf dem ausgelassenen/adaptiven Thinking-Pfad des Providers.
/fast on oder params.fastMode: true schreibt MiniMax-M2.7 auf dem Anthropic-kompatiblen Stream-Pfad zu MiniMax-M2.7-highspeed um.
Am besten für: Ihr stärkstes Modell der neuesten Generation als primäres Modell behalten und bei Bedarf auf MiniMax M2.7 ausweichen. Das folgende Beispiel verwendet Opus als konkretes primäres Modell; ersetzen Sie es durch Ihr bevorzugtes primäres Modell der neuesten Generation.
{
  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"],
      },
    },
  },
}
  • Coding-Plan-Nutzungs-API: https://api.minimaxi.com/v1/token_plan/remains oder https://api.minimax.io/v1/token_plan/remains (erfordert einen Coding-Plan-Schlüssel).
  • Das Nutzungs-Polling leitet den Host aus models.providers.minimax-portal.baseUrl oder models.providers.minimax.baseUrl ab, wenn konfiguriert. Globale Setups mit https://api.minimax.io/anthropic pollen daher api.minimax.io. Fehlende oder fehlerhafte Basis-URLs behalten aus Kompatibilitätsgründen den CN-Fallback bei.
  • OpenClaw normalisiert die MiniMax-Coding-Plan-Nutzung auf dieselbe Anzeige für % left, die auch von anderen Providern verwendet wird. Die Rohfelder usage_percent / usagePercent von MiniMax stehen für verbleibendes Kontingent, nicht verbrauchtes Kontingent, daher invertiert OpenClaw sie. Zählerbasierte Felder haben Vorrang, wenn sie vorhanden sind.
  • Wenn die API model_remains zurückgibt, bevorzugt OpenClaw den Chat-Modell-Eintrag, leitet bei Bedarf die Fensterbezeichnung aus start_time / end_time ab und nimmt den ausgewählten Modellnamen in die Planbezeichnung auf, damit Coding-Plan-Fenster leichter zu unterscheiden sind.
  • Nutzungssnapshots behandeln minimax, minimax-cn und minimax-portal als dieselbe MiniMax-Kontingentfläche und bevorzugen gespeichertes MiniMax OAuth, bevor sie auf Umgebungsvariablen für den Coding-Plan-Schlüssel zurückfallen.

Hinweise

  • Modellreferenzen folgen dem Authentifizierungspfad:
    • API-Schlüssel-Setup: minimax/<model>
    • OAuth-Setup: minimax-portal/<model>
  • Standard-Chatmodell: MiniMax-M3
  • Alternative Chatmodelle: MiniMax-M2.7, MiniMax-M2.7-highspeed
  • Onboarding und direktes API-Schlüssel-Setup schreiben Modelldefinitionen für M3 und beide M2.7-Varianten
  • Bildverständnis verwendet den Plugin-eigenen Medien-Provider MiniMax-VL-01
  • Aktualisieren Sie Preiswerte in models.json, wenn Sie exakte Kostenerfassung 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-M3 oder openclaw models set minimax-portal/MiniMax-M3
Empfehlungslink für MiniMax Coding Plan (10 % Rabatt): MiniMax Coding Plan
Siehe Modell-Provider für Provider-Regeln.

Fehlerbehebung

Das bedeutet in der Regel, dass der MiniMax-Provider nicht konfiguriert ist (kein passender Provider-Eintrag und kein MiniMax-Authentifizierungsprofil/Umgebungsschlüssel gefunden). Ein Fix für diese Erkennung ist in 2026.1.12 enthalten. Beheben Sie dies durch:
  • Upgrade auf 2026.1.12 (oder Ausführung aus Source main) und anschließenden Neustart des Gateways.
  • Ausführen von openclaw configure und Auswahl einer MiniMax-Authentifizierungsoption, oder
  • Manuelles Hinzufügen des passenden Blocks models.providers.minimax oder models.providers.minimax-portal, oder
  • Setzen von MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN oder eines MiniMax-Authentifizierungsprofils, damit der passende Provider injiziert werden kann.
Stellen Sie sicher, dass die Modell-ID Groß-/Kleinschreibung beachtet:
  • API-Schlüssel-Pfad: minimax/MiniMax-M3, minimax/MiniMax-M2.7 oder minimax/MiniMax-M2.7-highspeed
  • OAuth-Pfad: minimax-portal/MiniMax-M3, minimax-portal/MiniMax-M2.7 oder minimax-portal/MiniMax-M2.7-highspeed
Prüfen Sie anschließend erneut mit:
openclaw models list
Weitere Hilfe: Fehlerbehebung und FAQ.

Verwandt

Modellauswahl

Auswahl von Providern, Modellreferenzen und Failover-Verhalten.

Bildgenerierung

Gemeinsame Parameter für Bild-Tools und Provider-Auswahl.

Musikgenerierung

Gemeinsame Parameter für Musik-Tools und Provider-Auswahl.

Videogenerierung

Gemeinsame Parameter für Video-Tools und Provider-Auswahl.

MiniMax-Suche

Websuchkonfiguration über MiniMax Token Plan.

Fehlerbehebung

Allgemeine Fehlerbehebung und FAQ.