OpenClaw’s MiniMax-Provider verwendet standardmäßig MiniMax M2.7. MiniMax bietet außerdem:Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
- 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-ID | Authentifizierung | Funktionen |
|---|---|---|
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-M2.7 | Chat (Reasoning) | Standardmäßig 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 Authentifizierungsmethode und folgen Sie den Einrichtungsschritten.- OAuth (Coding Plan)
- API key
Am besten für: schnelle Einrichtung mit 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-M2.7.Über openclaw configure konfigurieren
Verwenden Sie den interaktiven Konfigurationsassistenten, um MiniMax ohne Bearbeitung von JSON einzurichten:
MiniMax-Auth-Option auswählen
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 |
Funktionen
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 (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
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.
Siehe Bildgenerierung für gemeinsame Tool-Parameter, Provider-Auswahl und Failover-Verhalten.
Text-zu-Sprache
Das gebündelte 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 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-hdundspeech-01-turbo. - Die Auth-Auflösung erfolgt über
messages.tts.providers.minimax.apiKey, dann OAuth-/Token-Auth-Profile vonminimax-portal, dann Umgebungsschlüssel des Token Plan (MINIMAX_OAUTH_TOKEN,MINIMAX_CODE_PLAN_KEY,MINIMAX_CODING_API_KEY) und dannMINIMAX_API_KEY. - Wenn kein TTS-Host konfiguriert ist, verwendet OpenClaw den konfigurierten
OAuth-Host von
minimax-portalwieder 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, weil 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.voiceId | MINIMAX_TTS_VOICE_ID | English_expressive_narrator | Für Sprachausgabe verwendete Stimmen-ID. |
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 gebündelte MiniMax-Plugin registriert die Musikgenerierung über das gemeinsame Toolmusic_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.5undminimax/music-2.0 - Prompt-Steuerungen:
lyrics,instrumental,durationSeconds - Ausgabeformat:
mp3 - Sitzungsbasierte Läufe werden über den gemeinsamen Aufgaben-/Statusablauf abgekoppelt, einschließlich
action: "status"
Siehe Musikgenerierung für gemeinsame Tool-Parameter, Provider-Auswahl und Failover-Verhalten.
Videogenerierung
Das gebündelte MiniMax-Plugin registriert die Videogenerierung über das gemeinsame Toolvideo_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
aspectRatioundresolution
Siehe Videogenerierung für gemeinsam genutzte 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 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, dannMINIMAX_API_HOST, dann MiniMax-Provider-Basis-URLs - Die Suche bleibt bei der Provider-ID
minimax; die OAuth-CN/globale Einrichtung kann die Region indirekt übermodels.providers.minimax-portal.baseUrlsteuern und Bearer-Auth ü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 | Bevorzugen Sie https://api.minimax.io/anthropic (Anthropic-kompatibel); https://api.minimax.io/v1 ist optional für OpenAI-kompatible Payloads |
models.providers.minimax.api | Bevorzugen Sie 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 | Definieren Sie id, name, reasoning, contextWindow, maxTokens, cost |
agents.defaults.models | Alias-Modelle, die Sie in der Zulassungsliste haben möchten |
models.mode | Behalten Sie merge bei, wenn Sie MiniMax zusätzlich zu den integrierten Modellen hinzufügen möchten |
Thinking-Standards
Thinking-Standards
Bei
api: "anthropic-messages" injiziert OpenClaw thinking: { type: "disabled" }, sofern Thinking nicht bereits explizit in Parametern/Konfiguration gesetzt ist.Dadurch wird verhindert, dass der Streaming-Endpunkt von MiniMax reasoning_content in Delta-Chunks im OpenAI-Stil ausgibt, wodurch internes Reasoning in sichtbare Ausgaben gelangen würde.Schneller Modus
Schneller Modus
/fast on oder params.fastMode: true schreibt MiniMax-M2.7 auf dem Anthropic-kompatiblen Stream-Pfad in MiniMax-M2.7-highspeed um.Fallback-Beispiel
Fallback-Beispiel
Am besten geeignet für: Behalten Sie Ihr stärkstes Modell der neuesten Generation als primäres Modell bei und wechseln Sie bei einem Ausfall zu MiniMax M2.7. Das folgende Beispiel verwendet Opus als konkretes primäres Modell; ersetzen Sie es durch Ihr bevorzugtes primäres Modell der neuesten Generation.
Details zur Coding-Plan-Nutzung
Details zur Coding-Plan-Nutzung
- 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, sodass globale Setups mithttps://api.minimax.io/anthropicapi.minimax.ioabfragen. 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 andere Provider verwenden. Die rohen Felderusage_percent/usagePercentvon MiniMax geben das verbleibende Kontingent an, nicht das verbrauchte Kontingent, daher invertiert OpenClaw sie. Anzahlbasierte Felder haben Vorrang, wenn sie vorhanden sind. - Wenn die API
model_remainszurückgibt, bevorzugt OpenClaw den Chat-Modell-Eintrag, leitet bei Bedarf die Fensterbeschriftung ausstart_time/end_timeab und nimmt den ausgewählten Modellnamen in die Planbeschriftung auf, damit Coding-Plan-Fenster leichter zu unterscheiden sind. - Nutzungs-Snapshots behandeln
minimax,minimax-cnundminimax-portalals dieselbe MiniMax-Kontingentoberfläche und bevorzugen gespeichertes MiniMax-OAuth, bevor auf Coding-Plan-Schlüssel aus Umgebungsvariablen zurückgegriffen wird.
Hinweise
- Modellreferenzen folgen dem Authentifizierungspfad:
- API-Schlüssel-Setup:
minimax/<model> - OAuth-Setup:
minimax-portal/<model>
- API-Schlüssel-Setup:
- 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 mitopenclaw models set minimax/MiniMax-M2.7oderopenclaw models set minimax-portal/MiniMax-M2.7
Siehe Modell-Provider für Provider-Regeln.
Fehlerbehebung
"Unbekanntes Modell: minimax/MiniMax-M2.7"
"Unbekanntes Modell: minimax/MiniMax-M2.7"
Das bedeutet normalerweise, dass der MiniMax-Provider nicht konfiguriert ist (kein passender Provider-Eintrag und kein MiniMax-Auth-Profil/Umgebungsschlüssel gefunden). Eine Korrektur für diese Erkennung ist in 2026.1.12 enthalten. Beheben Sie dies durch:
- Upgrade auf 2026.1.12 (oder Ausführung aus dem Quellcode von
main) und anschließenden Neustart des Gateway. - Ausführen von
openclaw configureund Auswählen 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-Auth-Profils, damit der passende Provider injiziert werden kann.
- API-Schlüssel-Pfad:
minimax/MiniMax-M2.7oderminimax/MiniMax-M2.7-highspeed - OAuth-Pfad:
minimax-portal/MiniMax-M2.7oderminimax-portal/MiniMax-M2.7-highspeed
Weitere Hilfe: Fehlerbehebung und FAQ.
Verwandt
Modellauswahl
Provider, Modellreferenzen und Failover-Verhalten auswählen.
Bildgenerierung
Gemeinsame Parameter des Bildwerkzeugs und Provider-Auswahl.
Musikgenerierung
Gemeinsame Parameter des Musikwerkzeugs und Provider-Auswahl.
Videogenerierung
Gemeinsame Parameter des Videowerkzeugs und Provider-Auswahl.
MiniMax-Suche
Websuche-Konfiguration über den MiniMax Token Plan.
Fehlerbehebung
Allgemeine Fehlerbehebung und FAQ.