MiniMax

Le fournisseur OpenClaw de MiniMax utilise par défaut MiniMax M2.7.

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-M2.7	Chat (raisonnement)	Modèle de raisnement hébergé par défaut
MiniMax-M2.7-highspeed	Chat (raisonnement)	Niveau de raisnement M2.7 plus rapide
MiniMax-VL-01	Vision	Modèle de compréhension d’images
image-01	Génération d’images	Texte vers image et édition 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 de musique précédent
music-2.0	Génération de musique	Niveau de génération de musique hérité
MiniMax-Hailuo-2.3	Génération de vidéo	Flux texte vers vidéo et références d’images

Getting started

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

OAuth (Coding Plan)Clé API

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

InternationalChina

1. Run onboarding

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

   Cela authentifie contre 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

   Cela authentifie contre api.minimaxi.com.

2. Verify the model is available

   openclaw models list --provider minimax-portal

Note

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

Tip

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

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

InternationalChine

1. Exécuter l'intégration

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

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

2. Vérifier que le model est disponible

   openclaw models list --provider minimax

1. Exécuter l'intégration

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

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

2. Vérifier que le model est disponible

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

Warning

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

Note

Les configurations avec clé API utilisent l’ID de fournisseur minimax. Les références de model suivent la forme minimax/MiniMax-M2.7.

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 Modèle/auth

   Choisissez Modèle/auth dans le menu.

3. Choisissez une option d'authentification MiniMax

   Choisissez l’une des options MiniMax disponibles :

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

4. Choisissez votre modèle par défaut

   Sélectionnez votre modèle par défaut lorsque vous y êtes invité.

Capacités

Génération d’images

Le plugin MiniMax enregistre le modèle image-01 pour l’outil image_generate. Il prend en charge :

• Génération de texte vers image avec contrôle du ratio d’aspect
• Modification d’image vers image (référence de sujet) avec contrôle du ratio d’aspect
• Jusqu’à 9 images de sortie par demande
• Jusqu’à 1 image de référence par demande de modification
• Ratios d’aspect 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 la même authentification MINIMAX_API_KEY ou 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 avec clé API utilisent MINIMAX_API_KEY ; les configurations OAuth peuvent utiliser le chemin d’authentification 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 du chat/compatible avec 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 explicites models.providers.minimax, OpenClaw matérialise MiniMax-M2.7 et MiniMax-M2.7-highspeed en tant que modèles de chat texte uniquement. La compréhension d’image est exposée séparément via le MiniMax-VL-01 fournisseur de média appartenant au plugin.

Note

Voir

Génération d’images

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èle 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’auth est messages.tts.providers.minimax.apiKey, puis les profils d’auth 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 transcodées du MP3 MiniMax en Opus 48kHz avec ffmpeg, car l’API de fichier Feishu/Lark n’accepte que file_type: "opus" pour les messages audio natifs.
• MiniMax T2A accepte des valeurs fractionnaires pour speed et vol, 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’API T2A MiniMax.
messages.tts.providers.minimax.model	MINIMAX_TTS_MODEL	speech-2.8-hd	ID du modèle TTS.
messages.tts.providers.minimax.voiceId	MINIMAX_TTS_VOICE_ID	English_expressive_narrator	ID de la voix utilisée 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 (pitch) 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, durationSeconds
• Format de sortie : mp3
• Les exécutions soutenues par session se détachent via le flux partagé de tâches/état, 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 de vidéo

Le plugin MiniMax inclus enregistre la génération de vidéo 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 de référence texte-vidéo et 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’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 de fournisseur de texte groupé affiche encore des références de chat M2.7 texte uniquement.

Recherche Web

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

• 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 type token-plan
• Réutilisation de la région : plugins.entries.minimax.config.webSearch.region, puis MINIMAX_API_HOST, puis les URL de base du provider MiniMax
• La recherche reste sur l’id de provider minimax ; la configuration OAuth CN/mondiale peut orienter indirectement la région via models.providers.minimax-portal.baseUrl et peut fournir une authentification bearer via MINIMAX_OAUTH_TOKEN

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

Note

Voir

Recherche MiniMax

pour la configuration et l’utilisation complètes 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é MiniMax de l’API MiniMax (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	Conserver merge si vous souhaitez ajouter MiniMax aux modèles intégrés

Thinking defaults

Sur api: "anthropic-messages"OpenClaw, OpenClaw injecte thinking: { type: "disabled" }MiniMax sauf si la réflexion (thinking) est déjà explicitement définie dans les paramètres/la configuration.

Cela empêche le point de terminaison de streaming de MiniMax d’émettre reasoning_contentOpenAI dans les chunks delta de style OpenAI, ce qui divulguerait le raisonnement interne dans la sortie visible.

Fast mode

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

Fallback example

Idéal pour : conserver votre modèle le plus puissant de dernière génération comme principal, basculer vers MiniMax M2.7 en cas de défaillance. 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 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 (nécessite 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 lorsque 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é, OpenClaw les inverse donc. Les champs basés sur le nombre ont priorité 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 afin de distinguer plus facilement les fenêtres du coding-plan.
• Les instantanés d’utilisation traitent minimax, minimax-cn et minimax-portalMiniMaxMiniMaxOAuth comme la même surface de quota MiniMax, et préfèrent le OAuth MiniMax stocké avant de revenir aux variables d’environnement de clé Coding Plan.

Notes

• Les références de modèle suivent le chemin d’authentification :
  • Configuration de la clé API : APIminimax/<model>
  • Configuration OAuth : OAuthminimax-portal/<model>
• Modèle de chat par défaut : MiniMax-M2.7
• Modèle de chat alternatif : MiniMax-M2.7-highspeed
• L’intégration et la configuration directe par clé API écrivent des définitions de modèle texte uniquement pour les deux variantes M2.7
• La compréhension d’image utilise le fournisseur de 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 actuel du fournisseur, puis basculez avec openclaw models set minimax/MiniMax-M2.7 ou openclaw models set minimax-portal/MiniMax-M2.7

Tip

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

MiniMax Coding Plan

Note

Voir

Model providers

pour les règles du provider.

Dépannage

"Unknown model: minimax/MiniMax-M2.7"

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

• Mettant à niveau vers le 2026.1.12 (ou en exécutant à partir de la source main), puis en redémarrant la passerelle.
• Exécutant openclaw configure 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_TOKEN, ou un profil d’authentification MiniMax pour que le provider correspondant puisse être injecté.

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

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

Vérifiez ensuite avec :

openclaw models list

Note

Plus d’aide :

Dépannage

et

FAQ

.

Connexes

Model selection

Choix des providers, références de modèle et comportement de basculement.

Image generation

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

Music generation

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

Video generation

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

MiniMax Search

Configuration de la recherche web via le MiniMax Token Plan.

Résolution des problèmes

Dépannage général et FAQ.