Providers
MiniMax
Le fournisseur MiniMax d’OpenClaw utilise par défaut MiniMax M2.7.
MiniMax fournit également :
- Synthèse vocale intégrée via T2A v2
- Compréhension d’image intégrée via
MiniMax-VL-01 - Génération musicale intégrée via
music-2.6 web_searchintégré via l’API de recherche MiniMax Token Plan
Répartition des fournisseurs :
| ID du fournisseur | Authentification | Fonctionnalités |
|---|---|---|
minimax |
Clé API | Texte, génération d’images, génération musicale, génération vidéo, compréhension d’image, voix, recherche web |
minimax-portal |
OAuth | Texte, génération d’images, génération musicale, génération vidéo, compréhension d’image, voix |
Catalogue intégré
| Modèle | Type | Description |
|---|---|---|
MiniMax-M2.7 |
Chat (raisonnement) | Modèle de raisonnement hébergé par défaut |
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 musicale | Modèle musical par défaut |
music-2.5 |
Génération musicale | Niveau précédent de génération musicale |
music-2.0 |
Génération musicale | Ancien niveau de génération musicale |
MiniMax-Hailuo-2.3 |
Génération vidéo | Flux texte-vers-vidéo et de référence d’image |
Premiers pas
Choisissez votre méthode d’authentification préférée et suivez les étapes de configuration.
OAuth (Coding Plan)
Idéal pour : une configuration rapide avec MiniMax Coding Plan via OAuth, sans clé API requise.
International
Run onboarding
openclaw onboard --auth-choice minimax-global-oauth
Cela authentifie auprès de api.minimax.io.
Verify the model is available
openclaw models list --provider minimax-portal
China
Run onboarding
openclaw onboard --auth-choice minimax-cn-oauth
Cela authentifie auprès de api.minimaxi.com.
Verify the model is available
openclaw models list --provider minimax-portal
API key
Idéal pour : MiniMax hébergé avec une API compatible Anthropic.
International
Run onboarding
openclaw onboard --auth-choice minimax-global-api
Cela configure api.minimax.io comme URL de base.
Verify the model is available
openclaw models list --provider minimax
China
Run onboarding
openclaw onboard --auth-choice minimax-cn-api
Cela configure api.minimaxi.com comme URL de base.
Verify the model is available
openclaw models list --provider minimax
Exemple de configuration
{
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,
},
],
},
},
},
}
Configurer via openclaw configure
Utilisez l’assistant de configuration interactif pour configurer MiniMax sans modifier le JSON :
Lancer l’assistant
openclaw configure
Sélectionner Modèle/auth
Choisissez Modèle/auth dans le menu.
Choisir une option d’auth MiniMax
Choisissez l’une des options MiniMax disponibles :
| Choix d’auth | Description |
|---|---|
minimax-global-oauth |
OAuth international (Coding Plan) |
minimax-cn-oauth |
OAuth Chine (Coding Plan) |
minimax-global-api |
Clé d’API internationale |
minimax-cn-api |
Clé d’API Chine |
Choisir votre modèle par défaut
Sélectionnez votre modèle par défaut lorsque vous y êtes invité.
Fonctionnalités
Génération d’images
Le Plugin MiniMax enregistre le modèle image-01 pour l’outil image_generate. Il prend en charge :
- La génération texte-vers-image avec contrôle du format d’image
- L’édition image-vers-image (référence de sujet) avec contrôle du format d’image
- Jusqu’à 9 images de sortie par requête
- Jusqu’à 1 image de référence par requête d’édition
- Formats d’image 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 fournisseur de génération d’images :
{
agents: {
defaults: {
imageGenerationModel: { primary: "minimax/image-01" },
},
},
}
Le Plugin utilise le même MINIMAX_API_KEY ou la même authentification OAuth que les modèles 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
modèle image-01. Les configurations par clé d’API utilisent MINIMAX_API_KEY ; 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.
Lorsque l’onboarding ou la configuration par clé d’API écrit des entrées explicites models.providers.minimax,
OpenClaw matérialise MiniMax-M2.7 et
MiniMax-M2.7-highspeed comme modèles de chat texte uniquement. La compréhension d’images est
exposée séparément via le fournisseur de médias MiniMax-VL-01 détenu par le Plugin.
Synthèse vocale
Le Plugin minimax intégré enregistre MiniMax T2A v2 comme 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 intégrés 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-hdetspeech-01-turbo. - La résolution de l’authentification est
messages.tts.providers.minimax.apiKey, puis les profils d’auth OAuth/jetonminimax-portal, puis les clés d’environnement Token Plan (MINIMAX_OAUTH_TOKEN,MINIMAX_CODE_PLAN_KEY,MINIMAX_CODING_API_KEY), puisMINIMAX_API_KEY. - Si aucun hôte TTS n’est configuré, OpenClaw réutilise l’hôte OAuth
minimax-portalconfiguré 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 transcodées depuis le MP3
MiniMax vers Opus 48 kHz avec
ffmpeg, car l’API de fichiers Feishu/Lark n’accepte quefile_type: "opus"pour les messages audio natifs. - MiniMax T2A accepte les valeurs fractionnaires
speedetvol, maispitchest envoyé sous forme d’entier ; OpenClaw tronque les valeurs fractionnaires depitchavant la requête API.
| Paramètre | Variable d’env | Par défaut | Description |
|---|---|---|---|
messages.tts.providers.minimax.baseUrl |
MINIMAX_API_HOST |
https://api.minimax.io |
Hôte API MiniMax T2A. |
messages.tts.providers.minimax.model |
MINIMAX_TTS_MODEL |
speech-2.8-hd |
Identifiant du modèle TTS. |
messages.tts.providers.minimax.voiceId |
MINIMAX_TTS_VOICE_ID |
English_expressive_narrator |
Identifiant de voix utilisé pour la sortie vocale. |
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 intégré 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.5etminimax/music-2.0 - Contrôles du prompt :
lyrics,instrumental,durationSeconds - Format de sortie :
mp3 - Les exécutions adossées à une session se détachent via le flux partagé de tâche/statut, notamment
action: "status"
Pour utiliser MiniMax comme fournisseur de musique par défaut :
{
agents: {
defaults: {
musicGenerationModel: {
primary: "minimax/music-2.6",
},
},
},
}
Génération de vidéos
Le Plugin MiniMax intégré enregistre la génération de vidéos via l’outil partagé
video_generate pour 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 référence à image unique
- Prend en charge
aspectRatioetresolution
Pour utiliser MiniMax comme fournisseur vidéo par défaut :
{
agents: {
defaults: {
videoGenerationModel: {
primary: "minimax/MiniMax-Hailuo-2.3",
},
},
},
}
Compréhension d’images
Le plugin MiniMax enregistre la compréhension d’images séparément du catalogue 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’images MiniMax même lorsque le catalogue groupé du fournisseur de texte affiche encore des références de chat M2.7 uniquement textuelles.
Recherche web
Le plugin MiniMax enregistre aussi web_search via l’API de recherche MiniMax 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 - Repli de compatibilité :
MINIMAX_API_KEYlorsqu’elle pointe déjà vers un identifiant Token Plan - Réutilisation de la région :
plugins.entries.minimax.config.webSearch.region, puisMINIMAX_API_HOST, puis les URL de base du fournisseur MiniMax - La recherche reste sur l’ID de fournisseur
minimax; la configuration OAuth CN/global peut orienter la région indirectement viamodels.providers.minimax-portal.baseUrlet peut fournir l’authentification bearer viaMINIMAX_OAUTH_TOKEN
La configuration se trouve sous plugins.entries.minimax.config.webSearch.*.
Configuration avancée
Options de configuration
| Option | Description |
|---|---|
models.providers.minimax.baseUrl |
Préférez 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érez anthropic-messages ; openai-completions est optionnel pour les payloads compatibles OpenAI |
models.providers.minimax.apiKey |
Clé d’API MiniMax (MINIMAX_API_KEY) |
models.providers.minimax.models |
Définir id, name, reasoning, contextWindow, maxTokens, cost |
agents.defaults.models |
Donner un alias aux modèles à inclure dans l’allowlist |
models.mode |
Gardez merge si vous voulez ajouter MiniMax aux éléments intégrés |
Valeurs par défaut de réflexion
Sur api: "anthropic-messages", OpenClaw injecte thinking: { type: "disabled" }, sauf si la réflexion est déjà explicitement définie dans les paramètres/la configuration.
Cela empêche le endpoint de streaming de MiniMax d’émettre reasoning_content dans des fragments delta de style OpenAI, ce qui exposerait le raisonnement interne dans la sortie visible.
Mode rapide
/fast on ou params.fastMode: true réécrit MiniMax-M2.7 en MiniMax-M2.7-highspeed sur le chemin de streaming compatible Anthropic.
Exemple de repli
Idéal pour : garder votre modèle de dernière génération le plus puissant comme modèle principal, avec basculement vers MiniMax M2.7. L’exemple ci-dessous utilise Opus comme modèle 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 d’utilisation du Coding Plan
- API d’utilisation du Coding Plan :
https://api.minimaxi.com/v1/token_plan/remainsouhttps://api.minimax.io/v1/token_plan/remains(nécessite une clé de coding plan). - L’interrogation de l’utilisation déduit l’hôte depuis
models.providers.minimax-portal.baseUrloumodels.providers.minimax.baseUrllorsque c’est configuré ; ainsi les configurations globales utilisanthttps://api.minimax.io/anthropicinterrogentapi.minimax.io. Les URL de base manquantes ou mal formées conservent le repli CN pour la compatibilité. - OpenClaw normalise l’utilisation du coding plan MiniMax avec le même affichage
% leftque les autres fournisseurs. Les champs brutsusage_percent/usagePercentde MiniMax correspondent au quota restant, pas au quota consommé ; OpenClaw les inverse donc. Les champs basés sur un décompte prévalent lorsqu’ils sont présents. - Lorsque l’API renvoie
model_remains, OpenClaw préfère l’entrée du modèle de chat, déduit le libellé de fenêtre depuisstart_time/end_timesi nécessaire, et inclut le nom du modèle sélectionné dans le libellé du plan pour faciliter la distinction des fenêtres de coding plan. - Les instantanés d’utilisation traitent
minimax,minimax-cnetminimax-portalcomme la même surface de quota MiniMax, et préfèrent l’OAuth MiniMax stocké avant de se rabattre sur les variables d’environnement de clé Coding Plan.
Notes
- Les références de modèle suivent le chemin d’authentification :
- Configuration par clé d’API :
minimax/<model> - Configuration OAuth :
minimax-portal/<model>
- Configuration par clé d’API :
- Modèle de chat par défaut :
MiniMax-M2.7 - Modèle de chat alternatif :
MiniMax-M2.7-highspeed - L’onboarding et la configuration directe par clé d’API écrivent des définitions de modèles uniquement textuels pour les deux variantes M2.7
- La compréhension d’images utilise le fournisseur de médias
MiniMax-VL-01détenu par le plugin - Mettez à jour les valeurs de tarification dans
models.jsonsi vous avez besoin d’un suivi exact des coûts - Utilisez
openclaw models listpour confirmer l’ID de fournisseur actuel, puis basculez avecopenclaw models set minimax/MiniMax-M2.7ouopenclaw models set minimax-portal/MiniMax-M2.7
Dépannage
"Modèle inconnu : minimax/MiniMax-M2.7"
Cela signifie généralement que le fournisseur MiniMax n’est pas configuré (aucune entrée de fournisseur correspondante et aucun profil d’authentification/clé d’environnement MiniMax trouvé). Un correctif pour cette détection est inclus dans 2026.1.12. Corrigez en :
- Passant à 2026.1.12 (ou en exécutant depuis la source
main), puis en redémarrant le gateway. - Exécutant
openclaw configureet en sélectionnant une option d’authentification MiniMax, ou - Ajoutant manuellement le bloc
models.providers.minimaxoumodels.providers.minimax-portalcorrespondant, ou - Définissant
MINIMAX_API_KEY,MINIMAX_OAUTH_TOKENou un profil d’authentification MiniMax afin que le fournisseur correspondant puisse être injecté.
Assurez-vous que l’ID du modèle est sensible à la casse :
- Chemin par clé d’API :
minimax/MiniMax-M2.7ouminimax/MiniMax-M2.7-highspeed - Chemin OAuth :
minimax-portal/MiniMax-M2.7ouminimax-portal/MiniMax-M2.7-highspeed
Puis revérifiez avec :
openclaw models list
Connexe
Choisir les fournisseurs, les références de modèles et le comportement de basculement.
Paramètres partagés de l’outil d’image et sélection du fournisseur.
Paramètres partagés de l’outil de musique et sélection du fournisseur.
Paramètres partagés de l’outil vidéo et sélection du fournisseur.
Configuration de la recherche web via MiniMax Token Plan.
Dépannage général et FAQ.