MiniMax

Le fournisseur MiniMax d’OpenClaw utilise par défaut MiniMax M3.

MiniMax fournit également :

• Synthèse vocale intégrée via T2A v2
• Compréhension d’images intégrée via MiniMax-VL-01
• Génération de musique intégrée via music-2.6
• Regroupé web_search via l’API de recherche Token Plan de MiniMaxAPI

Répartition du fournisseur :

ID du fournisseur	Auth	Capacités
minimax	Clé API	Texte, génération d’images, génération de musique, génération de vidéo, compréhension d’images, synthèse vocale, recherche web
minimax-portal	OAuth	Texte, génération d’images, génération de musique, génération de vidéo, compréhension d’images, synthèse vocale

Catalogue intégré

Modèle	Type	Description
MiniMax-M3	Chat (raisonnement)	Modèle de raisnement hébergé par défaut
MiniMax-M2.7	Chat (raisonnement)	Modèle de raisonnement hébergé précédent
MiniMax-M2.7-highspeed	Chat (raisonnement)	Niveau de raisonnement M2.7 plus rapide
MiniMax-VL-01	Vision	Modèle de compréhension d’image
image-01	Génération d’images	Édition texte vers image et image vers image
music-2.6	Génération de musique	Modèle de musique par défaut
music-2.5	Génération de musique	Niveau de génération musicale précédent
music-2.0	Génération de musique	Niveau de génération musicale hérité
MiniMax-Hailuo-2.3	Génération de vidéo	Flux texte vers vidéo et références d’image

Getting started

Choisissez votre méthode d’authentification préférée et suivez les étapes de configuration.

OAuthOAuth (Coding Plan)APIClé API

Idéal pour : configuration rapide avec le MiniMax Coding Plan via OAuth, aucune clé API requise.

InternationalChina

1. Run onboarding

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

   Ceci s’authentifie auprès de api.minimax.io.

2. Verify the model is available

   openclaw models list --provider minimax-portal

1. Run onboarding

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

   Ceci s’authentifie auprès de api.minimaxi.com.

2. Verify the model is available

   openclaw models list --provider minimax-portal
   ```OAuth

Note

Les configurations OAuth utilisent l’id de fournisseur minimax-portal. Les références de modèle suivent la forme minimax-portal/MiniMax-M3MiniMaxMiniMax.

Tip

Lien de parrainage pour le MiniMax Coding Plan (10% de réduction) : MiniMax Coding Plan

Idéal pour : MiniMax hébergé avec une API compatible AnthropicAPI.

InternationalChine

1. Lancer l'intégration

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

   Cela configure api.minimax.io comme URL de base.

2. Vérifier que le modèle est disponible

   openclaw models list --provider minimax

1. Lancer l'intégration

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

   Cela configure api.minimaxi.com comme URL de base.

2. Vérifier que le modèle est disponible

   openclaw models list --provider minimax

Exemple de configuration

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

Warning

Sur le chemin de streaming compatible Anthropic, OpenClaw désactive la réflexion MiniMax par défaut, sauf si vous définissez explicitement thinking vous-même. Le point de terminaison de streaming de MiniMax émet reasoning_content dans des blocs delta de style OpenAI au lieu des blocs de réflexion natifs de AnthropicAPI, ce qui peut entraîner une fuite du raisonnement interne dans la sortie visible si l’option est implicitement laissée activée.

Note

Les configurations par clé API utilisent l’identifiant de fournisseur minimax. Les références de modèle suivent le format minimax/MiniMax-M3.

Configurer via openclaw configure

Utilisez l’assistant de configuration interactif pour définir MiniMax sans modifier le JSON :

1. Lancer l'assistant

   openclaw configure

2. Sélectionner Model/auth

   Choisissez Model/auth dans le menu.

3. MiniMaxChoisir une option d'auth MiniMax

   Sélectionnez l’une des options MiniMax disponibles :

   Choix d’authentification	Description
   minimax-global-oauthOAuth	OAuth international (Coding Plan)
   minimax-cn-oauthOAuth	OAuth Chine (Coding Plan)
   minimax-global-apiAPI	Clé API internationale
   minimax-cn-apiAPI	Clé API Chine

4. Choisir votre model par défaut

   Sélectionnez votre model par défaut lorsqu’il vous est demandé.

Capacités

Génération d’images

Le plugin MiniMax enregistre le model MiniMaximage-01 pour le tool image_generate. Il prend en charge :

• Génération de texte vers image avec contrôle du format
• Édition d’image vers image (référence de sujet) avec contrôle du format
• Jusqu’à 9 images de sortie par demande
• Jusqu’à 1 image de référence par demande d’édition
• Formats pris en charge : 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9

Pour utiliser MiniMax pour la génération d’images, définissez-le comme le provider de génération d’images :

{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}

Le plugin utilise la même auth MINIMAX_API_KEYOAuthMiniMax ou OAuth que les models de texte. Aucune configuration supplémentaire n’est nécessaire si MiniMax est déjà configuré.

minimax et minimax-portal enregistrent tous deux image_generate avec le même model image-01API. Les configurations par clé API utilisent MINIMAX_API_KEYOAuth ; les configurations OAuth peuvent utiliser le chemin d’auth minimax-portal intégré à la place.

La génération d’images utilise toujours le point de terminaison d’image dédié de MiniMax (/v1/image_generation) et ignore models.providers.minimax.baseUrl, car ce champ configure l’URL de base compatible avec le chat/Anthropic. Définissez MINIMAX_API_HOST=https://api.minimaxi.com pour acheminer la génération d’images via le point de terminaison CN ; le point de terminaison global par défaut est https://api.minimax.io.

Lors de l’intégration ou de la configuration de la clé API écrit des entrées models.providers.minimax explicites, OpenClaw matérialise MiniMax-M3, MiniMax-M2.7 et MiniMax-M2.7-highspeed en tant que modèles de chat. M3 prend en charge la saisie de texte et d’image ; la compréhension d’image reste exposée séparément via le fournisseur de média MiniMax-VL-01 appartenant au plugin.

Note

Voir

Image Generation

pour les paramètres d’outil partagés, la sélection du fournisseur et le comportement de basculement.

Synthèse vocale

Le plugin minimax inclus enregistre MiniMax T2A v2 en tant que fournisseur vocal pour messages.tts.

• Modèle TTS par défaut : speech-2.8-hd
• Voix par défaut : English_expressive_narrator
• Les identifiants de modèles inclus pris en charge incluent 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 et speech-01-turbo.
• La résolution d’authentification est messages.tts.providers.minimax.apiKey, puis les profils d’authentification OAuth/token minimax-portal, puis les clés d’environnement du Plan de jeton (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), puis MINIMAX_API_KEY.
• Si aucun hôte TTS n’est configuré, OpenClaw réutilise l’hôte OAuth minimax-portal configuré et supprime les suffixes de chemin compatibles avec Anthropic tels que /anthropic.
• Les pièces jointes audio normales restent en MP3.
• Les cibles de notes vocales telles que Feishu et Telegram sont transcrites du MP3 MiniMax en Opus 48kHz avec ffmpegAPI, car l’API de fichiers Feishu/Lark n’accepte que file_type: "opus" pour les messages audio natifs.
• Le T2A MiniMax accepte les speed et vol fractionnaires, mais pitch est envoyé sous forme d’entier ; OpenClaw tronque les valeurs fractionnaires pitch avant la requête API.

Paramètre	Var. d’env.	Par défaut	Description
messages.tts.providers.minimax.baseUrl	MINIMAX_API_HOST	https://api.minimax.io	Hôte de l’MiniMax T2A API.
messages.tts.providers.minimax.model	MINIMAX_TTS_MODEL	speech-2.8-hd	ID du modèle TTS.
messages.tts.providers.minimax.speakerVoiceId	MINIMAX_TTS_VOICE_ID	English_expressive_narrator	ID de voix utilisé pour la sortie audio.
messages.tts.providers.minimax.speed		1.0	Vitesse de lecture, 0.5..2.0.
messages.tts.providers.minimax.vol		1.0	Volume, (0, 10].
messages.tts.providers.minimax.pitch		0	Décalage de hauteur entier, -12..12.

Génération de musique

Le plugin MiniMax inclus enregistre la génération de musique via l’outil partagé music_generate pour minimax et minimax-portal.

• Modèle de musique par défaut : minimax/music-2.6
• Modèle de musique OAuth : minimax-portal/music-2.6
• Prend également en charge minimax/music-2.5 et minimax/music-2.0
• Contrôles de prompt : lyrics, instrumental
• Format de sortie : mp3
• Les exécutions basées sur des sessions se détachent via le flux partagé de tâches/statuts, y compris action: "status"

Pour utiliser MiniMax comme fournisseur de musique par défaut :

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.6",
      },
    },
  },
}

Note

Voir

Génération de musique

pour les paramètres d’outil partagés, la sélection du fournisseur et le comportement de basculement.

Génération vidéo

Le plugin MiniMax intégré enregistre la génération vidéo via l’outil partagé video_generate pour à la fois minimax et minimax-portal.

• Modèle vidéo par défaut : minimax/MiniMax-Hailuo-2.3
• Modèle vidéo OAuth : minimax-portal/MiniMax-Hailuo-2.3
• Modes : flux texte-vers-vidéo et flux de référence à image unique
• Prend en charge aspectRatio et resolution

Pour utiliser MiniMax comme fournisseur vidéo par défaut :

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}

Note

Voir

Génération vidéo

pour les paramètres d’outil partagés, la sélection du fournisseur et le comportement de basculement.

Compréhension d’image

Le plugin MiniMax enregistre la compréhension d’image séparément du catalogue de texte :

ID du fournisseur	Modèle d’image par défaut
minimax	MiniMax-VL-01
minimax-portal	MiniMax-VL-01

C’est pourquoi le routage automatique des médias peut utiliser la compréhension d’image MiniMax, même lorsque le catalogue de fournisseurs de texte intégré inclut également des références de discussion compatibles avec les images M3.

Recherche Web

Le plugin MiniMax enregistre également web_search via l’API de recherche du MiniMaxAPI Token Plan.

• ID du fournisseur : minimax
• Résultats structurés : titres, URL, extraits, requêtes associées
• Variable d’environnement préférée : MINIMAX_CODE_PLAN_KEY
• Alias d’environnement acceptés : MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
• Retour de compatibilité : MINIMAX_API_KEY lorsqu’il pointe déjà vers des informations d’identification de plan de jetons
• Réutilisation de la région : plugins.entries.minimax.config.webSearch.region, puis MINIMAX_API_HOST, puis les URL de base du fournisseur MiniMax
• La recherche reste sur l’id de fournisseur minimaxOAuth ; la configuration OAuth CN/global peut orienter indirectement la région via models.providers.minimax-portal.baseUrl et peut fournir l’authentification bearer via MINIMAX_OAUTH_TOKEN

La configuration se trouve sous plugins.entries.minimax.config.webSearch.*.

Note

Voir

Recherche MiniMax

pour la configuration complète et l’utilisation de la recherche web.

Configuration avancée

Configuration options

Option	Description
models.providers.minimax.baseUrl	Préférer https://api.minimax.io/anthropic (compatible Anthropic) ; https://api.minimax.io/v1 est optionnel pour les payloads compatibles OpenAI
models.providers.minimax.api	Préférer anthropic-messages ; openai-completions est optionnel pour les payloads compatibles OpenAI
models.providers.minimax.apiKey	Clé d’MiniMax API (MINIMAX_API_KEY)
models.providers.minimax.models	Définir id, name, reasoning, contextWindow, maxTokens, cost
agents.defaults.models	Modèles alias que vous souhaitez dans la liste blanche
models.mode	Gardez merge si vous souhaitez ajouter MiniMax alongside built-ins

Thinking defaults

Sur api: "anthropic-messages", OpenClaw injecte thinking: { type: "disabled" } sauf si thinking est déjà défini explicitement dans params/config.

Cela empêche le endpoint de streaming de MiniMax d’émettre reasoning_content dans les chunks delta de style OpenAI, ce qui fuirait le raisonnement interne dans la sortie visible.

Fast mode

/fast on ou params.fastMode: true réécrit MiniMax-M2.7 en MiniMax-M2.7-highspeed sur le chemin de flux compatible Anthropic.

Fallback example

Idéal pour : gardez votre modèle de dernière génération le plus puissant comme principal, basculez sur MiniMax M2.7 en cas de panne. L’exemple ci-dessous utilise Opus comme principal concret ; remplacez-le par votre modèle principal de dernière génération préféré.

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

Détails de l'utilisation du Coding Plan

• API d’utilisation du Coding Plan : https://api.minimaxi.com/v1/token_plan/remains ou https://api.minimax.io/v1/token_plan/remains (requiert une clé de coding plan).
• L’interrogation de l’utilisation dérive l’hôte de models.providers.minimax-portal.baseUrl ou models.providers.minimax.baseUrl lorsqu’il est configuré, donc les configurations globales utilisant https://api.minimax.io/anthropic interrogent api.minimax.ioOpenClawMiniMax. Les URL de base manquantes ou malformées conservent le repli CN pour la compatibilité.
• OpenClaw normalise l’utilisation du coding-plan MiniMax au même affichage % leftMiniMax que celui utilisé par d’autres providers. Les champs bruts usage_percent / usagePercentOpenClawAPI de MiniMax représentent le quota restant, et non le quota consommé, donc OpenClaw les inverse. Les champs basés sur le nombre priment lorsqu’ils sont présents.
• Lorsque l’API renvoie model_remainsOpenClaw, OpenClaw privilégie l’entrée du chat-model, dérive l’étiquette de la fenêtre à partir de start_time / end_time si nécessaire, et inclut le nom du modèle sélectionné dans l’étiquette du plan pour que les fenêtres du coding-plan soient plus faciles à distinguer.
• Les instantanés d’utilisation traitent minimax, minimax-cn et minimax-portalMiniMaxMiniMaxOAuth comme la même surface de quota MiniMax, et privilégient le OAuth MiniMax stocké avant de revenir aux variables d’environnement de clé de Coding Plan.

Notes

• Les références de modèles suivent le chemin d’authentification :
  • Configuration par clé API : APIminimax/<model>
  • Configuration OAuth : OAuthminimax-portal/<model>
• Modèle de chat par défaut : MiniMax-M3
• Modèles de chat alternatifs : MiniMax-M2.7, MiniMax-M2.7-highspeed
• L’intégration et la configuration directe par clé API écrivent les définitions de modèles pour M3 et les deux variantes M2.7
• La compréhension d’images utilise le provider média MiniMax-VL-01 appartenant au plugin
• Mettez à jour les valeurs de tarification dans models.json si vous avez besoin d’un suivi précis des coûts
• Utilisez openclaw models list pour confirmer l’identifiant du fournisseur actuel, puis basculez avec openclaw models set minimax/MiniMax-M3 ou openclaw models set minimax-portal/MiniMax-M3

Tip

Lien de parrainage pour le plan Coding MiniMax (10% de réduction) :

MiniMax Coding Plan

Note

Voir

Model providers

pour les règles des fournisseurs.

Dépannage

"Unknown model: minimax/MiniMax-M3"

Cela signifie généralement que le fournisseur MiniMax n’est pas configuré (aucune entrée de fournisseur correspondante et aucun profil/clé d’environnement d’authentification MiniMax trouvé). Une correction pour cette détection est prévue dans la version 2026.1.12. Corrigez en :

• Mettant à niveau vers 2026.1.12 (ou en exécutant à partir de la source main), puis en redémarrant la passerelle.
• Exécutant openclaw configureMiniMax et en sélectionnant une option d’authentification MiniMax, ou
• Ajoutant manuellement le bloc models.providers.minimax ou models.providers.minimax-portal correspondant, ou
• Définissant MINIMAX_API_KEY, MINIMAX_OAUTH_TOKENMiniMaxAPI, ou un profil d’authentification MiniMax afin que le fournisseur correspondant puisse être injecté.

Assurez-vous que l’identifiant du modèle est sensible à la casse :

• Chemin de clé API : minimax/MiniMax-M3, minimax/MiniMax-M2.7, ou minimax/MiniMax-M2.7-highspeedOAuth
• Chemin OAuth : minimax-portal/MiniMax-M3, minimax-portal/MiniMax-M2.7, ou minimax-portal/MiniMax-M2.7-highspeed

Vérifiez ensuite avec :

openclaw models list

Note

Plus d’aide :

Troubleshooting

et

FAQ

.

Connexes

Model selection

Choisir les fournisseurs, les références de modèles et le comportement de basculement.

Génération d'images

Paramètres de l’outil d’image partagés et sélection du provider.

Génération de musique

Paramètres de l’outil de musique partagés et sélection du provider.

Génération vidéo

Paramètres de l’outil vidéo partagés et sélection du provider.

Recherche MiniMax

Configuration de la recherche web via le plan de jetons MiniMax.

Dépannage

Dépannage général et FAQ.