OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

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

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)

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

International

  • Onboarding ausführen

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

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

  • Verfügbarkeit des Modells überprüfen

    bash
    openclaw models list --provider minimax-portal

    • China

  • Onboarding ausführen

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

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

  • Verfügbarkeit des Modells überprüfen

    bash
    openclaw models list --provider minimax-portal

    • API-Schlüssel

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

    International

  • Onboarding ausführen

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

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

  • Verfügbarkeit des Modells überprüfen

    bash
    openclaw models list --provider minimax

    • China

  • Onboarding ausführen

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

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

  • Verfügbarkeit des Modells überprüfen

    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

  • Assistenten starten

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

    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"
    json5
    {  agents: {    defaults: {      musicGenerationModel: { primary: "minimax/music-2.6" },    },  },}

    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
    json5
    {  agents: {    defaults: {      videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" },    },  },}

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

    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.

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

    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:

    bash
    openclaw models list

    Verwandte Themen

    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.
    Was this useful?
    On this page

    On this page