MiniMax

Das gebündelte Plugin minimax registriert zwei Provider sowie fünf Funktionen: Chat, Bildgenerierung, Musikgenerierung, Videogenerierung, Bildverständnis, Sprachausgabe (T2A v2) und Websuche.

Provider-ID	Authentifizierung	Funktionen
`minimax`	API-Schlüssel	Text, Bildgenerierung, Musikgenerierung, Videogenerierung, Bildverständnis, Sprachausgabe, Websuche
`minimax-portal`	OAuth	Text, Bildgenerierung, Musikgenerierung, Videogenerierung, Bildverständnis, Sprachausgabe

Empfehlungslink für den MiniMax Coding Plan (10 % Rabatt): MiniMax Coding Plan

Integrierter Katalog

Modell	Typ	Beschreibung
`MiniMax-M3`	Chat (Reasoning)	Standardmäßig gehostetes Reasoning-Modell
`MiniMax-M2.7`	Chat (Reasoning)	Vorheriges gehostetes Reasoning-Modell
`MiniMax-M2.7-highspeed`	Chat (Reasoning)	Schnellere M2.7-Reasoning-Stufe
`MiniMax-VL-01`	Vision	Modell für Bildverständnis
`image-01`	Bildgenerierung	Text-zu-Bild- und Bild-zu-Bild-Bearbeitung
`music-2.6`	Musikgenerierung	Standard-Musikmodell
`MiniMax-Hailuo-2.3`	Videogenerierung	Text-zu-Video- und Bild-zu-Video-Abläufe

Modellreferenzen folgen dem Authentifizierungspfad: minimax/<model> für Einrichtungen mit API-Schlüssel, minimax-portal/<model> für Einrichtungen mit OAuth.

Erste Schritte

OAuth (Coding Plan)
API-Schlüssel

Am besten geeignet für: schnelle Einrichtung mit dem MiniMax Coding Plan über OAuth, kein API-Schlüssel erforderlich.

International
China

Onboarding ausführen

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

Daraus resultierende Basis-URL des Providers: api.minimax.io.

Verfügbarkeit des Modells überprüfen

openclaw models list --provider minimax-portal

Onboarding ausführen

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

Daraus resultierende Basis-URL des Providers: api.minimaxi.com.

Verfügbarkeit des Modells überprüfen

openclaw models list --provider minimax-portal

OAuth-Einrichtungen verwenden die Provider-ID minimax-portal. Modellreferenzen folgen dem Format minimax-portal/MiniMax-M3.

Am besten geeignet für: gehostetes MiniMax mit Anthropic-kompatibler API.

International
China

Onboarding ausführen

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

Dadurch wird api.minimax.io als Basis-URL konfiguriert.

Verfügbarkeit des Modells überprüfen

openclaw models list --provider minimax

Onboarding ausführen

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

Dadurch wird api.minimaxi.com als Basis-URL konfiguriert.

Verfügbarkeit des Modells überprüfen

openclaw models list --provider minimax

Konfigurationsbeispiel

{
  env: { MINIMAX_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "minimax/MiniMax-M3" } } },
  models: {
    mode: "merge",
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        apiKey: "${MINIMAX_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "MiniMax-M3",
            name: "MiniMax M3",
            reasoning: true,
            input: ["text", "image"],
            cost: { input: 0.6, output: 2.4, cacheRead: 0.12, cacheWrite: 0 },
            contextWindow: 1000000,
            maxTokens: 131072,
          },
          {
            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,
          },
        ],
      },
    },
  },
}

Der Anthropic-kompatible Streaming-Endpunkt von MiniMax-M2.x gibt reasoning_content in Delta-Chunks im OpenAI-Stil statt in nativen Anthropic-Thinking-Blöcken aus. Dadurch gelangt internes Reasoning in die sichtbare Ausgabe, wenn Thinking implizit aktiviert bleibt. OpenClaw deaktiviert Thinking für M2.x standardmäßig, sofern Sie thinking nicht ausdrücklich selbst festlegen. MiniMax-M3 (und vorwärtskompatible M3.x-Versionen) ist davon ausgenommen: M3 gibt korrekte Anthropic-Thinking-Blöcke aus und benötigt aktives Thinking, um sichtbare Inhalte zu erzeugen. Daher belässt OpenClaw M3 im adaptiven Thinking-Pfad des Providers. Weitere Informationen finden Sie unten im Abschnitt „Thinking-Standardeinstellungen“ unter „Erweiterte Konfiguration“.

Einrichtungen mit API-Schlüssel verwenden die Provider-ID minimax. Modellreferenzen folgen dem Format minimax/MiniMax-M3.

Über `openclaw configure` konfigurieren

Assistenten starten

openclaw configure

Modell/Authentifizierung auswählen

Wählen Sie im Menü Modell/Authentifizierung aus.

Eine MiniMax-Authentifizierungsoption auswählen

Authentifizierungsoption	Beschreibung
`minimax-global-oauth`	Internationales OAuth (Coding Plan)
`minimax-cn-oauth`	OAuth für China (Coding Plan)
`minimax-global-api`	Internationaler API-Schlüssel
`minimax-cn-api`	API-Schlüssel für China

Standardmodell auswählen

Wählen Sie bei Aufforderung Ihr Standardmodell aus.

Funktionen

Bildgenerierung

Das MiniMax-Plugin registriert das Modell image-01 für das Tool image_generate sowohl unter minimax als auch unter minimax-portal und verwendet dabei denselben MINIMAX_API_KEY oder dieselbe OAuth-Authentifizierung wie die Textmodelle.

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

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

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

Unter Bildgenerierung finden Sie Informationen zu gemeinsamen Tool-Parametern, zur Provider-Auswahl und zum Failover-Verhalten.

Text-zu-Sprache

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

Standard-TTS-Modell: speech-2.8-hd
Standardstimme: English_expressive_narrator
Gebündelte Modell-IDs: 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, speech-01-turbo
Reihenfolge der Authentifizierungsauflösung: tts.providers.minimax.apiKey, dann OAuth-/Token-Authentifizierungsprofile für minimax-portal, anschließend Token-Plan-Umgebungsschlüssel (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY) und danach 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 im MP3-Format. Für Sprachnachrichten vorgesehene Ziele (Feishu, Telegram und andere Kanäle, die einen mit Sprachnachrichten kompatiblen Anhang anfordern) werden mit ffmpeg von MiniMax-MP3 in Opus mit 48 kHz transkodiert, da beispielsweise die Datei-API von Feishu/Lark für native Audionachrichten ausschließlich file_type: "opus" akzeptiert
MiniMax T2A akzeptiert speed und vol als Dezimalwerte, pitch wird jedoch als Ganzzahl gesendet; OpenClaw schneidet bei pitch Dezimalstellen vor der API-Anfrage ab

Einstellung	Umgebungsvariable	Standardwert	Beschreibung
`tts.providers.minimax.baseUrl`	`MINIMAX_API_HOST`	`https://api.minimax.io`	MiniMax-T2A-API-Host.
`tts.providers.minimax.model`	`MINIMAX_TTS_MODEL`	`speech-2.8-hd`	TTS-Modell-ID.
`tts.providers.minimax.voiceId`	`MINIMAX_TTS_VOICE_ID`	`English_expressive_narrator`	Für die Sprachausgabe verwendete Stimmen-ID.
`tts.providers.minimax.speed`		`1.0`	Wiedergabegeschwindigkeit, `0.5..2.0`.
`tts.providers.minimax.vol`		`1.0`	Lautstärke, `(0, 10]`.
`tts.providers.minimax.pitch`		`0`	Ganzzahlige Tonhöhenverschiebung, `-12..12`.

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: minimax-portal/music-2.6)
Unterstützt außerdem music-2.6-free, music-cover und music-cover-free
Prompt-Steuerung: lyrics, instrumental
Ausgabeformat: mp3
Sitzungsgestützte Ausführungen werden über den gemeinsamen Aufgaben-/Statusablauf abgekoppelt, einschließlich action: "status"

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

Unter Musikgenerierung finden Sie Informationen zu gemeinsamen Tool-Parametern, zur Provider-Auswahl und zum Failover-Verhalten.

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: minimax-portal/MiniMax-Hailuo-2.3)
Unterstützt außerdem MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live und I2V-01
Modi: Text-zu-Video- und Einzelbild-Referenzabläufe
Unterstützt resolution (768P oder 1080P bei Hailuo-2.3/02-Modellen); aspectRatio wird nicht unterstützt und ignoriert

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

Unter Videogenerierung finden Sie gemeinsame Tool-Parameter, die Provider-Auswahl und das Failover-Verhalten.

Bildverständnis

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

Provider-ID	Standard-Bildmodell	PDF-Textextraktion
`minimax`	`MiniMax-VL-01`	`MiniMax-M2.7`
`minimax-portal`	`MiniMax-VL-01`	`MiniMax-M2.7`

Daher kann das automatische Medien-Routing das Bildverständnis von MiniMax verwenden, auch wenn der gebündelte Katalog der Text-Provider ebenfalls bildfähige M3-Chat-Referenzen enthält. Das PDF-Verständnis verwendet MiniMax-M2.7 ausschließlich zur Textextraktion; MiniMax registriert keinen Konvertierungspfad von PDF zu Bild.

Websuche

Das MiniMax-Plugin registriert außerdem web_search über die Such-API des MiniMax Token Plan (/v1/coding_plan/search).

Provider-ID: minimax
Strukturierte Ergebnisse: Titel, URLs, Ausschnitte, verwandte Suchanfragen
Bevorzugte Umgebungsvariable: MINIMAX_CODE_PLAN_KEY
Akzeptierte Umgebungsvariablen-Aliasse: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
Kompatibilitäts-Fallback: MINIMAX_API_KEY, wenn die Variable bereits auf Anmeldedaten für einen Token-Plan verweist
Wiederverwendung der Region: plugins.entries.minimax.config.webSearch.region, dann MINIMAX_API_HOST, dann die Basis-URLs des MiniMax-Providers
Die Suche verwendet weiterhin die Provider-ID minimax; die globale bzw. CN-OAuth-Einrichtung kann die Region indirekt über models.providers.minimax-portal.baseUrl steuern und über MINIMAX_OAUTH_TOKEN eine Bearer-Authentifizierung bereitstellen

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

Unter MiniMax-Suche finden Sie die vollständige Konfiguration und Verwendung der Websuche.

Erweiterte Konfiguration

Konfigurationsoptionen

Option	Beschreibung
`models.providers.minimax.baseUrl`	`https://api.minimax.io/anthropic` bevorzugen (Anthropic-kompatibel); `https://api.minimax.io/v1` ist für OpenAI-kompatible Nutzdaten optional
`models.providers.minimax.api`	`anthropic-messages` bevorzugen; `openai-completions` ist für OpenAI-kompatible Nutzdaten optional
`models.providers.minimax.apiKey`	MiniMax-API-Schlüssel (`MINIMAX_API_KEY`)
`models.providers.minimax.models`	`id`, `name`, `reasoning`, `contextWindow`, `maxTokens`, `cost` definieren
`agents.defaults.models`	Modellspezifische Aliasse, Parameter und Metadaten
`agents.defaults.modelPolicy.allow`	Optionale explizite Modell-Zulassungsliste
`models.mode`	`merge` beibehalten, wenn MiniMax zusätzlich zu den integrierten Providern hinzugefügt werden soll

Standardwerte für das Denken

Bei api: "anthropic-messages" fügt OpenClaw für MiniMax-M2.x-Modelle thinking: { type: "disabled" } ein, sofern nicht bereits ein vorheriger Wrapper das Feld thinking in den Nutzdaten festgelegt hat. Dadurch wird verhindert, dass der Streaming-Endpunkt von M2.x reasoning_content in Delta-Blöcken im OpenAI-Stil ausgibt, wodurch interne Überlegungen in der sichtbaren Ausgabe offengelegt würden.MiniMax-M3 (und M3.x) ist davon ausgenommen: M3 gibt bei deaktiviertem Denken ein leeres content-Array mit stop_reason: "end_turn" zurück. Daher entfernt OpenClaw für M3 den impliziten Standardwert für deaktiviertes Denken und erzwingt stattdessen thinking: { type: "adaptive" }, wenn eine Denkstufe festgelegt ist.Verfügbare Denkstufen je Modellfamilie:

Modellfamilie	Stufen	Standard
`MiniMax-M3`	`off`, `adaptive`	`adaptive`
`MiniMax-M2.x`	`off`, `minimal`, `low`, `medium`, `high`	`off`

Schnellmodus

/fast on oder params.fastMode: true schreibt MiniMax-M2.7 im Anthropic-kompatiblen Streaming-Pfad (api: "anthropic-messages", Provider minimax oder minimax-portal) in MiniMax-M2.7-highspeed um.

Fallback-Beispiel

Am besten geeignet für: Das leistungsstärkste Modell der neuesten Generation als Primärmodell beibehalten und bei einem Fehler auf MiniMax M2.7 ausweichen. Das folgende Beispiel verwendet Opus als konkretes Primärmodell; ersetzen Sie es durch Ihr bevorzugtes Primärmodell 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"],
      },
    },
  },
}

Details zur Nutzung des Coding Plan

Nutzungs-API des Coding Plan: https://api.minimaxi.com/v1/token_plan/remains oder https://api.minimax.io/v1/token_plan/remains (erfordert einen Coding-Plan-Schlüssel).
Die Nutzungsabfrage leitet den Host aus models.providers.minimax-portal.baseUrl oder models.providers.minimax.baseUrl ab, sofern konfiguriert. Daher fragen globale Einrichtungen, die https://api.minimax.io/anthropic verwenden, api.minimax.io ab. Fehlende oder fehlerhafte Basis-URLs behalten aus Kompatibilitätsgründen den CN-Fallback bei.
OpenClaw normalisiert die Coding-Plan-Nutzung von MiniMax auf dieselbe % left-Darstellung, die auch von anderen Providern verwendet wird. Die Rohfelder usage_percent / usagePercent von MiniMax geben das verbleibende und nicht das verbrauchte Kontingent an, weshalb OpenClaw sie invertiert. Anzahlbasierte Felder haben Vorrang, wenn sie vorhanden sind.
Wenn die API model_remains zurückgibt, bevorzugt OpenClaw den Chatmodell-Eintrag, leitet bei Bedarf die Fensterbezeichnung aus start_time / end_time ab und nimmt den Namen des ausgewählten Modells in die Planbezeichnung auf, damit sich Coding-Plan-Fenster leichter unterscheiden lassen.
Nutzungsmomentaufnahmen behandeln minimax, minimax-cn, minimax-portal und minimax-portal-cn als dieselbe MiniMax-Kontingentoberfläche und bevorzugen gespeichertes MiniMax-OAuth, bevor auf Umgebungsvariablen für Coding-Plan-Schlüssel zurückgegriffen wird.

Hinweise

Standard-Chatmodell: MiniMax-M3. Alternative Chatmodelle: MiniMax-M2.7, MiniMax-M2.7-highspeed
Onboarding und die direkte Einrichtung per API-Schlüssel schreiben Modelldefinitionen für M3 und beide M2.7-Varianten
Das Bildverständnis verwendet den Plugin-eigenen Medien-Provider MiniMax-VL-01
Aktualisieren Sie die Preiswerte in models.json, wenn Sie eine genaue Kostenverfolgung benötigen
Verwenden Sie openclaw models list, um die aktuelle Provider-ID zu bestätigen, und wechseln Sie anschließend mit openclaw models set minimax/MiniMax-M3 oder openclaw models set minimax-portal/MiniMax-M3

Unter Modell-Provider finden Sie die Regeln für Provider.

Fehlerbehebung

"Unbekanntes Modell: minimax/MiniMax-M3"

Dies bedeutet in der Regel, dass der MiniMax-Provider nicht konfiguriert ist (kein passender Provider-Eintrag und kein MiniMax-Authentifizierungsprofil bzw. Umgebungsschlüssel gefunden). So beheben Sie das Problem:

Führen Sie openclaw configure aus und wählen Sie eine MiniMax-Authentifizierungsoption aus, oder
fügen Sie den passenden Block models.providers.minimax oder models.providers.minimax-portal manuell hinzu, oder
legen Sie MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN oder ein MiniMax-Authentifizierungsprofil fest, damit der passende Provider eingefügt werden kann.

Stellen Sie sicher, dass bei der Modell-ID die Groß-/Kleinschreibung beachtet wird:

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.

Modellauswahl

Auswahl von Providern, Modellreferenzen und Failover-Verhalten.

Bildgenerierung

Gemeinsame Parameter des Bild-Tools und Provider-Auswahl.

Musikgenerierung

Gemeinsame Parameter des Musik-Tools und Provider-Auswahl.

Videogenerierung

Gemeinsame Parameter des Video-Tools und Provider-Auswahl.

MiniMax-Suche

Websuchkonfiguration über den MiniMax Token Plan.

Fehlerbehebung

Allgemeine Fehlerbehebung und FAQ.

Overview

Concepts and configuration

Providers

Integrierter Katalog

Erste Schritte

Konfigurationsbeispiel

Über `openclaw configure` konfigurieren

Funktionen

Bildgenerierung

Text-zu-Sprache

Musikgenerierung

Videogenerierung

Bildverständnis

Websuche

Erweiterte Konfiguration

Hinweise

Fehlerbehebung

Verwandte Themen

Modellauswahl

Bildgenerierung

Musikgenerierung

Videogenerierung

MiniMax-Suche

Fehlerbehebung

​Integrierter Katalog

​Erste Schritte

​Konfigurationsbeispiel

​Über openclaw configure konfigurieren

​Funktionen

​Bildgenerierung

​Text-zu-Sprache

​Musikgenerierung

​Videogenerierung

​Bildverständnis

​Websuche

​Erweiterte Konfiguration

​Hinweise

​Fehlerbehebung

​Verwandte Themen

Modellauswahl

Bildgenerierung

Musikgenerierung

Videogenerierung

MiniMax-Suche

Fehlerbehebung

Integrierter Katalog

Erste Schritte

Konfigurationsbeispiel

Über `openclaw configure` konfigurieren

Funktionen

Bildgenerierung

Text-zu-Sprache

Musikgenerierung

Videogenerierung

Bildverständnis

Websuche

Erweiterte Konfiguration

Hinweise

Fehlerbehebung

Verwandte Themen