Naar hoofdinhoud gaan

Documentation Index

Fetch the complete documentation index at: https://docs2.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 het MiniMax Token Plan
Provider-indeling:
Provider-IDAuthMogelijkheden
minimaxAPI-sleutelTekst, beeldgeneratie, muziekgeneratie, videogeneratie, beeldbegrip, spraak, webzoekfunctie
minimax-portalOAuthTekst, beeldgeneratie, muziekgeneratie, videogeneratie, beeldbegrip, spraak

​
Ingebouwde catalogus

ModelTypeBeschrijving
MiniMax-M2.7Chat (redeneren)Standaard gehost redeneermodel
MiniMax-M2.7-highspeedChat (redeneren)Snellere M2.7-redeneerlaag
MiniMax-VL-01VisionModel voor beeldbegrip
image-01BeeldgeneratieTekst-naar-beeld- en beeld-naar-beeldbewerking
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 auth-methode en volg de installatiestappen.
Beste voor: snelle installatie met MiniMax Coding Plan via OAuth, geen API-sleutel vereist.
1

Onboarding uitvoeren

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

Controleren of het model beschikbaar is

openclaw models list --provider minimax-portal
OAuth-installaties gebruiken de provider-id minimax-portal. Modelverwijzingen volgen de vorm minimax-portal/MiniMax-M2.7.
Verwijzingslink 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:
  • Genereren van tekst naar afbeelding met controle over beeldverhouding
  • Bewerking van afbeelding naar afbeelding (onderwerpreferentie) met controle over 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
Als je MiniMax wilt gebruiken voor het genereren van afbeeldingen, stel je dit in als provider voor afbeeldingsgeneratie: 
{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}
De Plugin gebruikt dezelfde MINIMAX_API_KEY of OAuth-authenticatie 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-sleutels gebruiken MINIMAX_API_KEY; OAuth-instellingen kunnen in plaats daarvan het gebundelde minimax-portal-authenticatiepad gebruiken. Afbeeldingen genereren gebruikt altijd het speciale afbeeldingseindpunt van MiniMax (/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 afbeeldingsgeneratie via het CN-eindpunt te routeren; het standaard globale eindpunt is https://api.minimax.io. Wanneer onboarding of installatie met API-sleutel expliciete models.providers.minimax-vermeldingen schrijft, materialiseert OpenClaw MiniMax-M2.7 en MiniMax-M2.7-highspeed als tekst-only chatmodellen. Afbeeldingsbegrip wordt afzonderlijk beschikbaar gemaakt via de Plugin-eigen mediaprovider MiniMax-VL-01.
Zie Afbeeldingen genereren voor gedeelde toolparameters, providerselectie en failovergedrag.

​
Tekst-naar-spraak

De gebundelde minimax-Plugin registreert MiniMax T2A v2 als spraakprovider voor messages.tts.
  • Standaard TTS-model: speech-2.8-hd
  • Standaardstem: English_expressive_narrator
  • Ondersteunde gebundelde 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-resolutie 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), 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.
  • Voice-note-doelen zoals Feishu en Telegram worden getranscodeerd van MiniMax MP3 naar 48 kHz Opus 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 verzonden als een geheel getal; 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.pitch0Verschuiving van toonhoogte als geheel getal, -12..12.

​
Muziek genereren

De gebundelde MiniMax-Plugin registreert muziekgeneratie 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
  • Uitvoerformaat: mp3
  • Runs met sessieondersteuning worden losgekoppeld via de gedeelde taak-/statusflow, inclusief action: "status"
MiniMax gebruiken als standaardprovider voor muziek: 
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.6",
      },
    },
  },
}
Zie Muziek genereren voor gedeelde toolparameters, providerselectie en failovergedrag.

​
Video genereren

De gebundelde MiniMax-Plugin registreert videogeneratie 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 flows met enkelbeeldreferentie
  • Ondersteunt aspectRatio en resolution
MiniMax gebruiken als standaardprovider voor video: 
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
Zie Videogeneratie voor gedeelde toolparameters, providerselectie en failovergedrag.

​
Afbeeldingsbegrip

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

​
Webzoekopdracht

De MiniMax Plugin registreert ook web_search via de MiniMax Token Plan zoek-API.
  • Provider-id: minimax
  • Gestructureerde resultaten: titels, URL’s, snippets, gerelateerde zoekopdrachten
  • Voorkeurs-env-var: MINIMAX_CODE_PLAN_KEY
  • Geaccepteerde env-aliassen: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
  • Compatibiliteitsfallback: MINIMAX_API_KEY wanneer deze al naar token-plan-inloggegevens 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 indirect sturen via models.providers.minimax-portal.baseUrl en kan bearer-auth bieden via MINIMAX_OAUTH_TOKEN
Configuratie staat onder plugins.entries.minimax.config.webSearch.*.
Zie MiniMax Search voor volledige webzoekconfiguratie en gebruik.

​
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 opnemen
models.modeHoud merge aan als je MiniMax naast ingebouwde providers wilt toevoegen
Bij api: "anthropic-messages" injecteert OpenClaw thinking: { type: "disabled" }, tenzij thinking al expliciet is ingesteld in params/config.Dit voorkomt dat het streamingendpoint van MiniMax reasoning_content uitzendt in OpenAI-achtige delta-chunks, waardoor interne redenering naar zichtbare uitvoer zou lekken.
/fast on of params.fastMode: true herschrijft MiniMax-M2.7 naar MiniMax-M2.7-highspeed op het Anthropic-compatibele streampad.
Het meest geschikt voor: behoud je sterkste model van de nieuwste generatie als primaire keuze en val terug op MiniMax M2.7. Het voorbeeld hieronder gebruikt Opus als concrete primaire keuze; vervang dit door je voorkeursmodel 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"],
      },
    },
  },
}
  • Coding Plan-gebruiks-API: https://api.minimaxi.com/v1/token_plan/remains of https://api.minimax.io/v1/token_plan/remains (vereist een codingplansleutel).
  • Gebruikspolling leidt de host af van models.providers.minimax-portal.baseUrl of models.providers.minimax.baseUrl wanneer geconfigureerd, zodat global-configuraties die https://api.minimax.io/anthropic gebruiken api.minimax.io pollen. Ontbrekende of onjuist gevormde basis-URL’s behouden de CN-fallback voor compatibiliteit.
  • OpenClaw normaliseert MiniMax-codingplangebruik naar dezelfde % left-weergave die andere providers gebruiken. De ruwe velden usage_percent / usagePercent van MiniMax zijn resterend quotum, geen verbruikt quotum, dus OpenClaw keert ze om. Op telling gebaseerde velden hebben voorrang wanneer ze aanwezig zijn.
  • Wanneer de API model_remains retourneert, geeft OpenClaw de voorkeur aan de chatmodelvermelding, leidt indien nodig het vensterlabel af van start_time / end_time, en neemt de geselecteerde modelnaam op in het planlabel zodat codingplanvensters 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 env-vars voor Coding Plan-sleutels.

​
Notities

  • Modelrefs 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
  • Afbeeldingsbegrip gebruikt de door de Plugin beheerde MiniMax-VL-01-mediaprovider
  • Werk prijswaarden bij in models.json als je exacte kostenregistratie 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-authprofiel/env-sleutel gevonden). Een oplossing voor deze detectie zit in 2026.1.12. Los dit op door:
  • Te upgraden naar 2026.1.12 (of te draaien vanaf source main) en daarna de Gateway opnieuw te starten.
  • openclaw configure uit te voeren en een MiniMax-authoptie 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-authprofiel in te stellen zodat de overeenkomende provider kan worden geïnjecteerd.
Zorg 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 FAQ.

​
Gerelateerd

Model selection

Providers, modelrefs en failovergedrag kiezen.

Image generation

Gedeelde afbeeldingstoolparameters en providerselectie.

Music generation

Gedeelde muziektolparameters en providerselectie.

Video generation

Gedeelde videotoolparameters en providerselectie.

MiniMax Search

Webzoekconfiguratie via MiniMax Token Plan.

Troubleshooting

Algemene probleemoplossing en FAQ.