Naar hoofdinhoud gaan

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 gebruikt standaard MiniMax M2.7. MiniMax biedt ook:
  • Gebundelde spraaksynthese via T2A v2
  • Gebundeld beeldbegrip via MiniMax-VL-01
  • Gebundelde muziekgeneratie via music-2.6
  • Gebundelde web_search via de zoek-API van MiniMax Coding Plan
Providerindeling:
Provider-IDAuthenticatieMogelijkheden
minimaxAPI-sleutelTekst, beeldgeneratie, muziekgeneratie, videogeneratie, beeldbegrip, spraak, webzoekfunctie
minimax-portalOAuthTekst, beeldgeneratie, muziekgeneratie, videogeneratie, beeldbegrip, spraak

​
Ingebouwde catalogus

ModelTypeBeschrijving
MiniMax-M2.7Chat (redenering)Standaard gehost redeneermodel
MiniMax-M2.7-highspeedChat (redenering)Snellere M2.7-redeneringslaag
MiniMax-VL-01VisieModel voor beeldbegrip
image-01BeeldgeneratieTekst-naar-beeld en beeld-naar-beeld-bewerking
music-2.6MuziekgeneratieStandaard muziekmodel
music-2.5MuziekgeneratieVorige muziekgeneratielaag
music-2.0MuziekgeneratieVerouderde muziekgeneratielaag
MiniMax-Hailuo-2.3VideogeneratieTekst-naar-video en beeldreferentiestromen

​
Aan de slag

Kies je gewenste authenticatiemethode en volg de installatiestappen.
Beste voor: snelle configuratie met MiniMax Coding Plan via OAuth, geen API-sleutel vereist.
1

Run onboarding

openclaw onboard --auth-choice minimax-global-oauth
Dit authenticeert bij api.minimax.io.
2

Verify the model is available

openclaw models list --provider minimax-portal
OAuth-configuraties gebruiken de provider-id minimax-portal. Modelverwijzingen volgen de vorm minimax-portal/MiniMax-M2.7.
Verwijslink voor MiniMax Coding Plan (10% korting): MiniMax Coding Plan

​
Configureren via openclaw configure

Gebruik de interactieve configuratiewizard om MiniMax in te stellen zonder JSON te bewerken:
1

Start de wizard

openclaw configure
2

Selecteer Model/auth

Kies Model/auth in het menu.
3

Kies een MiniMax-authoptie

Kies een van de beschikbare MiniMax-opties:
Auth-keuzeBeschrijving
minimax-global-oauthInternationale OAuth (Coding Plan)
minimax-cn-oauthChina OAuth (Coding Plan)
minimax-global-apiInternationale API-sleutel
minimax-cn-apiChina API-sleutel
4

Kies je standaardmodel

Selecteer je standaardmodel wanneer daarom wordt gevraagd.

​
Mogelijkheden

​
Afbeeldingen genereren

De MiniMax-Plugin registreert het model image-01 voor de tool image_generate. Het ondersteunt:
  • Tekst-naar-afbeelding genereren met beheer van beeldverhouding
  • Afbeelding-naar-afbeelding bewerken (onderwerpreferentie) met beheer van beeldverhouding
  • Maximaal 9 uitvoerafbeeldingen per aanvraag
  • Maximaal 1 referentieafbeelding per bewerkingsaanvraag
  • Ondersteunde beeldverhoudingen: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9
Stel MiniMax in als provider voor het genereren van afbeeldingen om MiniMax daarvoor te gebruiken: 
{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}
De Plugin gebruikt dezelfde MINIMAX_API_KEY of OAuth-auth als de tekstmodellen. Er is geen aanvullende configuratie nodig als MiniMax al is ingesteld. Zowel minimax als minimax-portal registreren image_generate met hetzelfde image-01-model. Instellingen met API-sleutel gebruiken MINIMAX_API_KEY; OAuth-instellingen kunnen in plaats daarvan het meegeleverde minimax-portal-authpad gebruiken. Afbeeldingen genereren gebruikt altijd MiniMax’ speciale afbeeldingseindpunt (/v1/image_generation) en negeert models.providers.minimax.baseUrl, omdat dat veld de chat-/Anthropic-compatibele basis-URL configureert. Stel MINIMAX_API_HOST=https://api.minimaxi.com in om het genereren van afbeeldingen via het CN-eindpunt te routeren; het standaard globale eindpunt is https://api.minimax.io. Wanneer onboarding of instelling met API-sleutel expliciete models.providers.minimax-vermeldingen schrijft, materialiseert OpenClaw MiniMax-M2.7 en MiniMax-M2.7-highspeed als chatmodellen met alleen tekst. Afbeeldingsbegrip wordt apart beschikbaar gemaakt via de door de Plugin beheerde mediaprovider MiniMax-VL-01.
Zie Afbeeldingen genereren voor gedeelde toolparameters, providerselectie en failovergedrag.

​
Tekst-naar-spraak

De meegeleverde minimax-Plugin registreert MiniMax T2A v2 als spraakprovider voor messages.tts.
  • Standaard TTS-model: speech-2.8-hd
  • Standaardstem: English_expressive_narrator
  • Ondersteunde meegeleverde model-id’s zijn onder andere 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 en speech-01-turbo.
  • Auth-oplossing is messages.tts.providers.minimax.apiKey, daarna OAuth-/token-authprofielen van minimax-portal, daarna omgevingssleutels voor Token Plan (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), en daarna MINIMAX_API_KEY.
  • Als er geen TTS-host is geconfigureerd, hergebruikt OpenClaw de geconfigureerde OAuth-host van minimax-portal en verwijdert het Anthropic-compatibele padsuffixen zoals /anthropic.
  • Normale audiobijlagen blijven MP3.
  • Doelen voor spraaknotities zoals Feishu en Telegram worden van MiniMax MP3 naar 48kHz Opus getranscodeerd met ffmpeg, omdat de Feishu/Lark-bestands-API alleen file_type: "opus" accepteert voor native audioberichten.
  • MiniMax T2A accepteert fractionele speed en vol, maar pitch wordt als een geheel getal verzonden; OpenClaw kapt fractionele pitch-waarden af vóór de API-aanvraag.
InstellingEnv-varStandaardBeschrijving
messages.tts.providers.minimax.baseUrlMINIMAX_API_HOSThttps://api.minimax.ioMiniMax T2A API-host.
messages.tts.providers.minimax.modelMINIMAX_TTS_MODELspeech-2.8-hdTTS-model-id.
messages.tts.providers.minimax.voiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narratorStem-id gebruikt voor spraakuitvoer.
messages.tts.providers.minimax.speed1.0Afspeelsnelheid, 0.5..2.0.
messages.tts.providers.minimax.vol1.0Volume, (0, 10].
messages.tts.providers.minimax.pitch0Gehele pitchverschuiving, -12..12.

​
Muziek genereren

De meegeleverde MiniMax-Plugin registreert het genereren van muziek via de gedeelde tool music_generate voor zowel minimax als minimax-portal.
  • Standaard muziekmodel: minimax/music-2.6
  • OAuth-muziekmodel: minimax-portal/music-2.6
  • Ondersteunt ook minimax/music-2.5 en minimax/music-2.0
  • Promptbesturing: lyrics, instrumental, durationSeconds
  • Uitvoerindeling: mp3
  • Runs met sessieondersteuning koppelen los via de gedeelde taak-/statusstroom, inclusief action: "status"
MiniMax gebruiken als standaard muziekprovider: 
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.6",
      },
    },
  },
}
Zie Muziek genereren voor gedeelde toolparameters, providerselectie en failovergedrag.

​
Video genereren

De meegeleverde MiniMax-Plugin registreert het genereren van video via de gedeelde tool video_generate voor zowel minimax als minimax-portal.
  • Standaard videomodel: minimax/MiniMax-Hailuo-2.3
  • OAuth-videomodel: minimax-portal/MiniMax-Hailuo-2.3
  • Modi: tekst-naar-video en stromen met referentie voor een enkele afbeelding
  • Ondersteunt aspectRatio en resolution
MiniMax gebruiken als standaard videoprovider: 
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
Zie Videogeneratie voor gedeelde toolparameters, providerselectie en failovergedrag.

​
Afbeeldingsbegrip

De MiniMax Plugin registreert afbeeldingsbegrip los van de tekstcatalogus:
Provider-IDStandaard afbeeldingsmodel
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
Daarom kan automatische mediaroutering MiniMax-afbeeldingsbegrip gebruiken, zelfs wanneer de gebundelde catalogus voor tekstproviders nog tekst-only M2.7-chatverwijzingen toont.

​
Webzoekfunctie

De MiniMax Plugin registreert ook web_search via de MiniMax Coding Plan zoek-API.
  • Provider-ID: minimax
  • Gestructureerde resultaten: titels, URL’s, fragmenten, gerelateerde zoekopdrachten
  • Voorkeurs-env-var: MINIMAX_CODE_PLAN_KEY
  • Geaccepteerde env-alias: MINIMAX_CODING_API_KEY
  • Compatibiliteitsfallback: MINIMAX_API_KEY wanneer deze al naar een coding-plan-token verwijst
  • Hergebruik van regio: plugins.entries.minimax.config.webSearch.region, daarna MINIMAX_API_HOST, daarna MiniMax-providerbasis-URL’s
  • Zoeken blijft op provider-ID minimax; OAuth CN/global-configuratie kan de regio nog steeds indirect sturen via models.providers.minimax-portal.baseUrl
Configuratie staat onder plugins.entries.minimax.config.webSearch.*.
Zie MiniMax Zoeken voor volledige configuratie en gebruik van webzoeken.

​
Geavanceerde configuratie

OptieBeschrijving
models.providers.minimax.baseUrlGeef de voorkeur aan https://api.minimax.io/anthropic (Anthropic-compatibel); https://api.minimax.io/v1 is optioneel voor OpenAI-compatibele payloads
models.providers.minimax.apiGeef de voorkeur aan anthropic-messages; openai-completions is optioneel voor OpenAI-compatibele payloads
models.providers.minimax.apiKeyMiniMax API-sleutel (MINIMAX_API_KEY)
models.providers.minimax.modelsDefinieer id, name, reasoning, contextWindow, maxTokens, cost
agents.defaults.modelsAliasmodellen die je in de allowlist wilt
models.modeHoud merge aan als je MiniMax naast ingebouwde modellen wilt toevoegen
Bij api: "anthropic-messages" injecteert OpenClaw thinking: { type: "disabled" }, tenzij thinking al expliciet is ingesteld in params/config.Dit voorkomt dat het streaming-eindpunt van MiniMax reasoning_content uitzendt in OpenAI-achtige delta chunks, waardoor interne redenering zou lekken naar zichtbare uitvoer.
/fast on of params.fastMode: true herschrijft MiniMax-M2.7 naar MiniMax-M2.7-highspeed op het Anthropic-compatibele streampad.
Het meest geschikt voor: houd je sterkste model van de nieuwste generatie als primair en schakel bij falen over naar MiniMax M2.7. Het onderstaande voorbeeld gebruikt Opus als concreet primair model; vervang dit door je gewenste primaire model van de nieuwste generatie.
{
  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"],
      },
    },
  },
}
  • Gebruiks-API voor Coding Plan: https://api.minimaxi.com/v1/api/openplatform/coding_plan/remains (vereist een Coding Plan-sleutel).
  • OpenClaw normaliseert MiniMax Coding Plan-gebruik naar dezelfde weergave met % resterend die door andere providers wordt gebruikt. De ruwe velden usage_percent / usagePercent van MiniMax zijn resterend quotum, geen verbruikt quotum, dus OpenClaw keert ze om. Op aantallen gebaseerde velden krijgen voorrang wanneer ze aanwezig zijn.
  • Wanneer de API model_remains retourneert, geeft OpenClaw de voorkeur aan de vermelding voor het chatmodel, leidt het zo nodig het vensterlabel af van start_time / end_time, en neemt het de geselecteerde modelnaam op in het planlabel zodat Coding Plan-vensters makkelijker te onderscheiden zijn.
  • Gebruikssnapshots behandelen minimax, minimax-cn en minimax-portal als hetzelfde MiniMax-quotumoppervlak, en geven de voorkeur aan opgeslagen MiniMax OAuth voordat wordt teruggevallen op omgevingsvariabelen voor de Coding Plan-sleutel.

​
Opmerkingen

  • Modelverwijzingen volgen het authenticatiepad:
    • API-sleutelconfiguratie: minimax/<model>
    • OAuth-configuratie: minimax-portal/<model>
  • Standaard chatmodel: MiniMax-M2.7
  • Alternatief chatmodel: MiniMax-M2.7-highspeed
  • Onboarding en directe API-sleutelconfiguratie schrijven tekst-only modeldefinities voor beide M2.7-varianten
  • Beeldbegrip gebruikt de door de plugin beheerde mediaprovider MiniMax-VL-01
  • Werk prijswaarden in models.json bij als je exacte kostentracking nodig hebt
  • Gebruik openclaw models list om de huidige provider-id te bevestigen en schakel daarna over met openclaw models set minimax/MiniMax-M2.7 of openclaw models set minimax-portal/MiniMax-M2.7
Verwijzingslink voor MiniMax Coding Plan (10% korting): MiniMax Coding Plan
Zie Modelproviders voor providerregels.

​
Probleemoplossing

Dit betekent meestal dat de MiniMax-provider niet is geconfigureerd (geen overeenkomende providervermelding en geen MiniMax-authenticatieprofiel/omgevingssleutel gevonden). Een oplossing voor deze detectie staat in 2026.1.12. Los dit op door:
  • Te upgraden naar 2026.1.12 (of te draaien vanaf bron main) en daarna de Gateway opnieuw te starten.
  • openclaw configure uit te voeren en een MiniMax-authenticatieoptie te selecteren, of
  • Het overeenkomende blok models.providers.minimax of models.providers.minimax-portal handmatig toe te voegen, of
  • MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN of een MiniMax-authenticatieprofiel in te stellen zodat de overeenkomende provider kan worden geïnjecteerd.
Zorg ervoor dat de model-id hoofdlettergevoelig is:
  • API-sleutelpad: minimax/MiniMax-M2.7 of minimax/MiniMax-M2.7-highspeed
  • OAuth-pad: minimax-portal/MiniMax-M2.7 of minimax-portal/MiniMax-M2.7-highspeed
Controleer daarna opnieuw met:
openclaw models list
Meer hulp: Probleemoplossing en Veelgestelde vragen.

​
Gerelateerd

Modelselectie

Providers, modelverwijzingen en failover-gedrag kiezen.

Beeldgeneratie

Gedeelde parameters voor beeldtools en providerselectie.

Muziekgeneratie

Gedeelde parameters voor muziektools en providerselectie.

Videogeneratie

Gedeelde parameters voor videotools en providerselectie.

MiniMax Search

Webzoekconfiguratie via MiniMax Coding Plan.

Probleemoplossing

Algemene probleemoplossing en veelgestelde vragen.