Zum Hauptinhalt springen

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.

OpenClaw’s MiniMax-Provider verwendet standardmäßig MiniMax M2.7. MiniMax bietet außerdem:
  • 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-Aufteilung:
Provider-IDAuthentifizierungFunktionen
minimaxAPI-SchlüsselText, Bildgenerierung, Musikgenerierung, Videogenerierung, Bildverstehen, Sprache, Websuche
minimax-portalOAuthText, Bildgenerierung, Musikgenerierung, Videogenerierung, Bildverstehen, Sprache

Integrierter Katalog

ModellTypBeschreibung
MiniMax-M2.7Chat (Reasoning)Standardmäßig 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 Authentifizierungsmethode und folgen Sie den Einrichtungsschritten.
Am besten für: schnelle Einrichtung mit 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-M2.7.
Empfehlungslink für MiniMax Coding Plan (10 % Rabatt): MiniMax Coding Plan

Über openclaw configure konfigurieren

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

Assistenten starten

openclaw configure
2

Modell/Auth auswählen

Wählen Sie Modell/Auth aus dem Menü.
3

MiniMax-Auth-Option auswählen

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

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. 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
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. 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 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 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-hd und speech-01-turbo.
  • Die Auth-Auflösung erfolgt über messages.tts.providers.minimax.apiKey, dann OAuth-/Token-Auth-Profile von minimax-portal, dann Umgebungsschlüssel des Token Plan (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY) und dann MINIMAX_API_KEY.
  • Wenn kein TTS-Host konfiguriert ist, verwendet OpenClaw den konfigurierten OAuth-Host von minimax-portal wieder 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, weil 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.voiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narratorFür Sprachausgabe verwendete Stimmen-ID.
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 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-Musikmodell: minimax-portal/music-2.6
  • Unterstützt außerdem minimax/music-2.5 und minimax/music-2.0
  • Prompt-Steuerungen: lyrics, instrumental, durationSeconds
  • Ausgabeformat: mp3
  • Sitzungsbasierte Läufe werden über den gemeinsamen Aufgaben-/Statusablauf abgekoppelt, einschließlich action: "status"
Um MiniMax als Standard-Provider für Musik zu verwenden:
{
  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 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-Videomodell: minimax-portal/MiniMax-Hailuo-2.3
  • Modi: Text-zu-Video und Abläufe mit Einzelbildreferenz
  • Unterstützt aspectRatio und resolution
Um MiniMax als Standard-Provider für Video zu verwenden:
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
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-IDStandard-Bildmodell
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
Deshalb kann das automatische Medien-Routing das MiniMax-Bildverständnis auch dann nutzen, wenn der gebündelte Text-Provider-Katalog weiterhin reine Text-Chat-Referenzen für M2.7 anzeigt.

Websuche

Das MiniMax-Plugin registriert außerdem web_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, dann MINIMAX_API_HOST, dann MiniMax-Provider-Basis-URLs
  • Die Suche bleibt bei der Provider-ID minimax; die OAuth-CN/globale Einrichtung kann die Region indirekt über models.providers.minimax-portal.baseUrl steuern und Bearer-Auth über MINIMAX_OAUTH_TOKEN bereitstellen
Die Konfiguration befindet sich unter plugins.entries.minimax.config.webSearch.*.
Siehe MiniMax-Suche für die vollständige Websuchkonfiguration und Nutzung.

Erweiterte Konfiguration

OptionBeschreibung
models.providers.minimax.baseUrlBevorzugen Sie https://api.minimax.io/anthropic (Anthropic-kompatibel); https://api.minimax.io/v1 ist optional für OpenAI-kompatible Payloads
models.providers.minimax.apiBevorzugen Sie anthropic-messages; openai-completions ist optional für OpenAI-kompatible Payloads
models.providers.minimax.apiKeyMiniMax-API-Schlüssel (MINIMAX_API_KEY)
models.providers.minimax.modelsDefinieren Sie id, name, reasoning, contextWindow, maxTokens, cost
agents.defaults.modelsAlias-Modelle, die Sie in der Zulassungsliste haben möchten
models.modeBehalten Sie merge bei, wenn Sie MiniMax zusätzlich zu den integrierten Modellen hinzufügen möchten
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.
/fast on oder params.fastMode: true schreibt MiniMax-M2.7 auf dem Anthropic-kompatiblen Stream-Pfad in MiniMax-M2.7-highspeed um.
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.
{
  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, sodass globale Setups mit https://api.minimax.io/anthropic api.minimax.io abfragen. 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 Felder usage_percent / usagePercent von 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_remains zurückgibt, bevorzugt OpenClaw den Chat-Modell-Eintrag, leitet bei Bedarf die Fensterbeschriftung aus start_time / end_time ab und nimmt den ausgewählten Modellnamen in die Planbeschriftung auf, damit Coding-Plan-Fenster leichter zu unterscheiden sind.
  • Nutzungs-Snapshots behandeln minimax, minimax-cn und minimax-portal als 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>
  • 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 mit openclaw models set minimax/MiniMax-M2.7 oder openclaw models set minimax-portal/MiniMax-M2.7
Empfehlungslink für den MiniMax Coding Plan (10 % Rabatt): MiniMax Coding Plan
Siehe Modell-Provider für Provider-Regeln.

Fehlerbehebung

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 configure und Auswählen 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-Auth-Profils, damit der passende Provider injiziert werden kann.
Stellen Sie sicher, dass bei der Modell-ID die Groß- und Kleinschreibung beachtet wird:
  • API-Schlüssel-Pfad: minimax/MiniMax-M2.7 oder minimax/MiniMax-M2.7-highspeed
  • OAuth-Pfad: 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

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.