- 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-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)
- API key
Am besten geeignet für: schnelle Einrichtung mit dem MiniMax Coding Plan über OAuth, kein API-Schlüssel erforderlich.
- International
- China
OAuth-Einrichtungen verwenden die Provider-ID
minimax-portal. Modellreferenzen folgen der Form minimax-portal/MiniMax-M3.Über openclaw configure konfigurieren
Verwenden Sie den interaktiven Konfigurationsassistenten, um MiniMax ohne JSON-Bearbeitung einzurichten:
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 |
Fähigkeiten
Bildgenerierung
Das MiniMax-Plugin registriert das Modellimage-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
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 Pluginminimax 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-hdundspeech-01-turbo. - Die Auth-Auflösung ist
messages.tts.providers.minimax.apiKey, dann OAuth-/Token-Auth-Profile fürminimax-portal, dann Token-Plan-Umgebungs- schlüssel (MINIMAX_OAUTH_TOKEN,MINIMAX_CODE_PLAN_KEY,MINIMAX_CODING_API_KEY), dannMINIMAX_API_KEY. - Wenn kein TTS-Host konfiguriert ist, verwendet OpenClaw den konfigurierten
OAuth-Host
minimax-portalerneut und entfernt Anthropic-kompatible Pfadsuffixe wie/anthropic. - Normale Audioanhänge bleiben MP3.
- Sprachnotiz-Ziele wie Feishu und Telegram werden mit
ffmpegvon MiniMax- MP3 in 48-kHz-Opus transkodiert, da die Feishu/Lark-Datei-API für native Audionachrichten nurfile_type: "opus"akzeptiert. - MiniMax T2A akzeptiert gebrochene Werte für
speedundvol, aberpitchwird als Ganzzahl gesendet; OpenClaw kürzt gebrochenepitch-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 Toolmusic_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.5undminimax/music-2.0 - Prompt-Steuerungen:
lyrics,instrumental - Ausgabeformat:
mp3 - Sitzungsbasierte Läufe werden über den gemeinsamen Aufgaben-/Statusfluss entkoppelt, einschließlich
action: "status"
Siehe Musikgenerierung für gemeinsame Tool-Parameter, Provider-Auswahl und Failover-Verhalten.
Videogenerierung
Das gebündelte MiniMax-Plugin registriert Videogenerierung über das gemeinsame Toolvideo_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
aspectRatioundresolution
Siehe Videogenerierung für gemeinsame Tool-Parameter, Provider-Auswahl und Failover-Verhalten.
Bildverständnis
Das MiniMax-Plugin registriert Bildverständnis getrennt vom Textkatalog:| Provider-ID | Standard-Bildmodell |
|---|---|
minimax | MiniMax-VL-01 |
minimax-portal | MiniMax-VL-01 |
Websuche
Das MiniMax-Plugin registriert außerdemweb_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, dannMINIMAX_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 übermodels.providers.minimax-portal.baseUrlsteuern und Bearer-Authentifizierung überMINIMAX_OAUTH_TOKENbereitstellen
plugins.entries.minimax.config.webSearch.*.
Siehe MiniMax-Suche für die vollständige Websuchkonfiguration und Nutzung.
Erweiterte Konfiguration
Konfigurationsoptionen
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
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
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
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.
Nutzungsdetails zum Coding Plan
Nutzungsdetails zum Coding Plan
- Coding-Plan-Nutzungs-API:
https://api.minimaxi.com/v1/token_plan/remainsoderhttps://api.minimax.io/v1/token_plan/remains(erfordert einen Coding-Plan-Schlüssel). - Das Nutzungs-Polling leitet den Host aus
models.providers.minimax-portal.baseUrlodermodels.providers.minimax.baseUrlab, wenn konfiguriert. Globale Setups mithttps://api.minimax.io/anthropicpollen daherapi.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 Rohfelderusage_percent/usagePercentvon 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_remainszurückgibt, bevorzugt OpenClaw den Chat-Modell-Eintrag, leitet bei Bedarf die Fensterbezeichnung ausstart_time/end_timeab und nimmt den ausgewählten Modellnamen in die Planbezeichnung auf, damit Coding-Plan-Fenster leichter zu unterscheiden sind. - Nutzungssnapshots behandeln
minimax,minimax-cnundminimax-portalals 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>
- API-Schlüssel-Setup:
- 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 mitopenclaw models set minimax/MiniMax-M3oderopenclaw models set minimax-portal/MiniMax-M3
Siehe Modell-Provider für Provider-Regeln.
Fehlerbehebung
"Unbekanntes Modell: minimax/MiniMax-M3"
"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 configureund Auswahl einer MiniMax-Authentifizierungsoption, oder - Manuelles Hinzufügen des passenden Blocks
models.providers.minimaxodermodels.providers.minimax-portal, oder - Setzen von
MINIMAX_API_KEY,MINIMAX_OAUTH_TOKENoder eines MiniMax-Authentifizierungsprofils, damit der passende Provider injiziert werden kann.
- API-Schlüssel-Pfad:
minimax/MiniMax-M3,minimax/MiniMax-M2.7oderminimax/MiniMax-M2.7-highspeed - OAuth-Pfad:
minimax-portal/MiniMax-M3,minimax-portal/MiniMax-M2.7oderminimax-portal/MiniMax-M2.7-highspeed
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.