Providers
MiniMax
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_searchvia de zoek-API van het MiniMax Token Plan
Provider-indeling:
| Provider-ID | Auth | Mogelijkheden |
|---|---|---|
minimax |
API-sleutel | Tekst, beeldgeneratie, muziekgeneratie, videogeneratie, beeldbegrip, spraak, webzoekfunctie |
minimax-portal |
OAuth | Tekst, beeldgeneratie, muziekgeneratie, videogeneratie, beeldbegrip, spraak |
Ingebouwde catalogus
| Model | Type | Beschrijving |
|---|---|---|
MiniMax-M2.7 |
Chat (redeneren) | Standaard gehost redeneermodel |
MiniMax-M2.7-highspeed |
Chat (redeneren) | Snellere M2.7-redeneerlaag |
MiniMax-VL-01 |
Vision | Model voor beeldbegrip |
image-01 |
Beeldgeneratie | Tekst-naar-beeld- en beeld-naar-beeldbewerking |
music-2.6 |
Muziekgeneratie | Standaard muziekmodel |
music-2.5 |
Muziekgeneratie | Vorige muziekgeneratielaag |
music-2.0 |
Muziekgeneratie | Verouderde muziekgeneratielaag |
MiniMax-Hailuo-2.3 |
Videogeneratie | Tekst-naar-video- en beeldreferentiestromen |
Aan de slag
Kies je gewenste auth-methode en volg de installatiestappen.
OAuth (Coding Plan)
Beste voor: snelle installatie met MiniMax Coding Plan via OAuth, geen API-sleutel vereist.
Internationaal
Onboarding uitvoeren
openclaw onboard --auth-choice minimax-global-oauth
Dit authenticeert tegen api.minimax.io.
Controleren of het model beschikbaar is
openclaw models list --provider minimax-portal
China
Onboarding uitvoeren
openclaw onboard --auth-choice minimax-cn-oauth
Dit authenticeert tegen api.minimaxi.com.
Controleren of het model beschikbaar is
openclaw models list --provider minimax-portal
API-sleutel
Beste voor: gehoste MiniMax met Anthropic-compatibele API.
Internationaal
Onboarding uitvoeren
openclaw onboard --auth-choice minimax-global-api
Dit configureert api.minimax.io als de basis-URL.
Controleren of het model beschikbaar is
openclaw models list --provider minimax
China
Onboarding uitvoeren
openclaw onboard --auth-choice minimax-cn-api
Dit configureert api.minimaxi.com als de basis-URL.
Controleren of het model beschikbaar is
openclaw models list --provider minimax
Configuratievoorbeeld
{
env: { MINIMAX_API_KEY: "sk-..." },
agents: { defaults: { model: { primary: "minimax/MiniMax-M2.7" } } },
models: {
mode: "merge",
providers: {
minimax: {
baseUrl: "https://api.minimax.io/anthropic",
apiKey: "${MINIMAX_API_KEY}",
api: "anthropic-messages",
models: [
{
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,
},
],
},
},
},
}
Configureren via openclaw configure
Gebruik de interactieve configuratiewizard om MiniMax in te stellen zonder JSON te bewerken:
Start de wizard
openclaw configure
Selecteer Model/auth
Kies Model/auth in het menu.
Kies een MiniMax-authoptie
Kies een van de beschikbare MiniMax-opties:
| Auth-keuze | Beschrijving |
|---|---|
minimax-global-oauth |
Internationale OAuth (Coding Plan) |
minimax-cn-oauth |
China OAuth (Coding Plan) |
minimax-global-api |
Internationale API-sleutel |
minimax-cn-api |
China API-sleutel |
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.
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-hdenspeech-01-turbo. - Auth-resolutie is
messages.tts.providers.minimax.apiKey, daarna OAuth-/token-authprofielen vanminimax-portal, daarna omgevingssleutels voor Token Plan (MINIMAX_OAUTH_TOKEN,MINIMAX_CODE_PLAN_KEY,MINIMAX_CODING_API_KEY), daarnaMINIMAX_API_KEY. - Als er geen TTS-host is geconfigureerd, hergebruikt OpenClaw de geconfigureerde
OAuth-host van
minimax-portalen 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 alleenfile_type: "opus"accepteert voor native audioberichten. - MiniMax T2A accepteert fractionele
speedenvol, maarpitchwordt verzonden als een geheel getal; OpenClaw kapt fractionelepitch-waarden af vóór de API-aanvraag.
| Instelling | Env-var | Standaard | Beschrijving |
|---|---|---|---|
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-model-id. |
messages.tts.providers.minimax.voiceId |
MINIMAX_TTS_VOICE_ID |
English_expressive_narrator |
Stem-id gebruikt voor spraakuitvoer. |
messages.tts.providers.minimax.speed |
1.0 |
Afspeelsnelheid, 0.5..2.0. |
|
messages.tts.providers.minimax.vol |
1.0 |
Volume, (0, 10]. |
|
messages.tts.providers.minimax.pitch |
0 |
Verschuiving 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.5enminimax/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",
},
},
},
}
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
aspectRatioenresolution
MiniMax gebruiken als standaardprovider voor video:
{
agents: {
defaults: {
videoGenerationModel: {
primary: "minimax/MiniMax-Hailuo-2.3",
},
},
},
}
Afbeeldingsbegrip
De MiniMax Plugin registreert afbeeldingsbegrip afzonderlijk van de tekstcatalogus:
| Provider-ID | Standaard afbeeldingsmodel |
|---|---|
minimax |
MiniMax-VL-01 |
minimax-portal |
MiniMax-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_KEYwanneer deze al naar token-plan-inloggegevens verwijst - Hergebruik van regio:
plugins.entries.minimax.config.webSearch.region, daarnaMINIMAX_API_HOST, daarna MiniMax-providerbasis-URL's - Zoeken blijft op provider-id
minimax; OAuth CN/global-configuratie kan de regio indirect sturen viamodels.providers.minimax-portal.baseUrlen kan bearer-auth bieden viaMINIMAX_OAUTH_TOKEN
Configuratie staat onder plugins.entries.minimax.config.webSearch.*.
Geavanceerde configuratie
Configuration options
| Optie | Beschrijving |
|---|---|
models.providers.minimax.baseUrl |
Geef de voorkeur aan https://api.minimax.io/anthropic (Anthropic-compatibel); https://api.minimax.io/v1 is optioneel voor OpenAI-compatibele payloads |
models.providers.minimax.api |
Geef de voorkeur aan anthropic-messages; openai-completions is optioneel voor OpenAI-compatibele payloads |
models.providers.minimax.apiKey |
MiniMax-API-sleutel (MINIMAX_API_KEY) |
models.providers.minimax.models |
Definieer id, name, reasoning, contextWindow, maxTokens, cost |
agents.defaults.models |
Aliasmodellen die je in de allowlist wilt opnemen |
models.mode |
Houd merge aan als je MiniMax naast ingebouwde providers wilt toevoegen |
Thinking defaults
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 mode
/fast on of params.fastMode: true herschrijft MiniMax-M2.7 naar MiniMax-M2.7-highspeed op het Anthropic-compatibele streampad.
Fallback example
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 usage details
- Coding Plan-gebruiks-API:
https://api.minimaxi.com/v1/token_plan/remainsofhttps://api.minimax.io/v1/token_plan/remains(vereist een codingplansleutel). - Gebruikspolling leidt de host af van
models.providers.minimax-portal.baseUrlofmodels.providers.minimax.baseUrlwanneer geconfigureerd, zodat global-configuraties diehttps://api.minimax.io/anthropicgebruikenapi.minimax.iopollen. 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 veldenusage_percent/usagePercentvan 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_remainsretourneert, geeft OpenClaw de voorkeur aan de chatmodelvermelding, leidt indien nodig het vensterlabel af vanstart_time/end_time, en neemt de geselecteerde modelnaam op in het planlabel zodat codingplanvensters makkelijker te onderscheiden zijn. - Gebruikssnapshots behandelen
minimax,minimax-cnenminimax-portalals 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>
- API-sleutelconfiguratie:
- 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.jsonals je exacte kostenregistratie nodig hebt - Gebruik
openclaw models listom de huidige provider-id te bevestigen en schakel daarna over metopenclaw models set minimax/MiniMax-M2.7ofopenclaw models set minimax-portal/MiniMax-M2.7
Probleemoplossing
"Unknown model: minimax/MiniMax-M2.7"
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 configureuit te voeren en een MiniMax-authoptie te selecteren, of- Het overeenkomende blok
models.providers.minimaxofmodels.providers.minimax-portalhandmatig toe te voegen, of MINIMAX_API_KEY,MINIMAX_OAUTH_TOKENof 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.7ofminimax/MiniMax-M2.7-highspeed - OAuth-pad:
minimax-portal/MiniMax-M2.7ofminimax-portal/MiniMax-M2.7-highspeed
Controleer daarna opnieuw met:
openclaw models list
Gerelateerd
Providers, modelrefs en failovergedrag kiezen.
Gedeelde afbeeldingstoolparameters en providerselectie.
Gedeelde muziektolparameters en providerselectie.
Gedeelde videotoolparameters en providerselectie.
Webzoekconfiguratie via MiniMax Token Plan.
Algemene probleemoplossing en FAQ.