Providers

MiniMax

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-ID	Auth	Fähigkeiten
`minimax`	API-Schlüssel	Text, Bildgenerierung, Musikgenerierung, Videogenerierung, Bildverstehen, Sprache, Websuche
`minimax-portal`	OAuth	Text, Bildgenerierung, Musikgenerierung, Videogenerierung, Bildverstehen, Sprache

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 Bildverstehen
`image-01`	Bildgenerierung	Text-zu-Bild- und Bild-zu-Bild-Bearbeitung
`music-2.6`	Musikgenerierung	Standard-Musikmodell
`music-2.5`	Musikgenerierung	Vorherige Stufe für Musikgenerierung
`music-2.0`	Musikgenerierung	Legacy-Stufe für Musikgenerierung
`MiniMax-Hailuo-2.3`	Videogenerierung	Text-zu-Video- und Bildreferenz-Abläufe

Erste Schritte

Wählen Sie Ihre bevorzugte Auth-Methode und folgen Sie den Einrichtungsschritten.

OAuth (Coding Plan)

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

International

Run onboarding

bash

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

Dies authentifiziert gegen api.minimax.io.

Verify the model is available

bash

openclaw models list --provider minimax-portal

China

Run onboarding

bash

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

Dies authentifiziert gegen api.minimaxi.com.

Verify the model is available

bash

openclaw models list --provider minimax-portal

API key

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

International

Run onboarding

bash

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

Dies konfiguriert api.minimax.io als Basis-URL.

Verify the model is available

bash

openclaw models list --provider minimax

China

Run onboarding

bash

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

Dies konfiguriert api.minimaxi.com als Basis-URL.

Verify the model is available

bash

openclaw models list --provider minimax

Konfigurationsbeispiel

json5

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

Über `openclaw configure` konfigurieren

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

Launch the wizard

bash

openclaw configure

Select Model/auth

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

Choose a MiniMax auth option

Wählen Sie eine der verfügbaren MiniMax-Optionen aus:

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

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:

json5

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

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.

Einstellung	Env-Var	Standard	Beschreibung
`messages.tts.providers.minimax.baseUrl`	`MINIMAX_API_HOST`	`https://api.minimax.io`	MiniMax-T2A-API-Host.
`messages.tts.providers.minimax.model`	`MINIMAX_TTS_MODEL`	`speech-2.8-hd`	TTS-Modell-ID.
`messages.tts.providers.minimax.speakerVoiceId`	`MINIMAX_TTS_VOICE_ID`	`English_expressive_narrator`	Stimm-ID für Sprachausgabe.
`messages.tts.providers.minimax.speed`		`1.0`	Wiedergabegeschwindigkeit, `0.5..2.0`.
`messages.tts.providers.minimax.vol`		`1.0`	Lautstärke, `(0, 10]`.
`messages.tts.providers.minimax.pitch`		`0`	Ganzzahlige 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:

json5

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

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:

json5

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

Bildverständnis

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

Provider-ID	Standard-Bildmodell
`minimax`	`MiniMax-VL-01`
`minimax-portal`	`MiniMax-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.*.

Erweiterte Konfiguration

Konfigurationsoptionen

Option	Beschreibung
`models.providers.minimax.baseUrl`	Bevorzugt `https://api.minimax.io/anthropic` (Anthropic-kompatibel); `https://api.minimax.io/v1` ist optional für OpenAI-kompatible Payloads
`models.providers.minimax.api`	Bevorzugt `anthropic-messages`; `openai-completions` ist optional für OpenAI-kompatible Payloads
`models.providers.minimax.apiKey`	MiniMax-API-Schlüssel (`MINIMAX_API_KEY`)
`models.providers.minimax.models`	Definiert `id`, `name`, `reasoning`, `contextWindow`, `maxTokens`, `cost`
`agents.defaults.models`	Weisen Sie Modellen, die Sie in der Allowlist haben möchten, Aliasnamen zu
`models.mode`	Behalten Sie `merge` bei, wenn Sie MiniMax zusätzlich zu den integrierten Providern hinzufügen möchten

Thinking-Standards

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.

Schnellmodus

/fast on oder params.fastMode: true schreibt MiniMax-M2.7 auf dem Anthropic-kompatiblen Stream-Pfad zu MiniMax-M2.7-highspeed um.

Fallback-Beispiel

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.

json5

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

Nutzungsdetails zum Coding Plan

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

Fehlerbehebung

"Unbekanntes Modell: minimax/MiniMax-M3"

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:

bash

openclaw models list

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.

Was this useful?

MiniMax

Integrierter Katalog

Erste Schritte

OAuth (Coding Plan)

International

Run onboarding

Verify the model is available

China

Run onboarding

Verify the model is available

API key

International

Run onboarding

Verify the model is available

China

Run onboarding

Verify the model is available

Konfigurationsbeispiel

Über `openclaw configure` konfigurieren

Launch the wizard

Select Model/auth

Choose a MiniMax auth option

Pick your default model

Fähigkeiten

Bildgenerierung

Text-zu-Sprache

Musikgenerierung

Videogenerierung

Bildverständnis

Websuche

Erweiterte Konfiguration

Hinweise

Fehlerbehebung

Verwandt

On this page

Molty

Integrierter Katalog

Erste Schritte

OAuth (Coding Plan)

International

Run onboarding

Verify the model is available

China

Run onboarding

Verify the model is available

API key

International

Run onboarding

Verify the model is available

China

Run onboarding

Verify the model is available

Konfigurationsbeispiel

Über openclaw configure konfigurieren

Launch the wizard

Select Model/auth

Choose a MiniMax auth option

Pick your default model

Fähigkeiten

Bildgenerierung

Text-zu-Sprache

Musikgenerierung

Videogenerierung

Bildverständnis

Websuche

Erweiterte Konfiguration

Hinweise

Fehlerbehebung

Verwandt

On this page

Über `openclaw configure` konfigurieren