Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

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_search intégré via l’API de recherche MiniMax Token Plan
Répartition des fournisseurs :
ID du fournisseurAuthentificationFonctionnalités
minimaxClé APITexte, génération d’images, génération musicale, génération vidéo, compréhension d’image, voix, recherche web
minimax-portalOAuthTexte, génération d’images, génération musicale, génération vidéo, compréhension d’image, voix

​
Catalogue intégré

ModèleTypeDescription
MiniMax-M2.7Chat (raisonnement)Modèle de raisonnement hébergé par défaut
MiniMax-M2.7-highspeedChat (raisonnement)Niveau de raisonnement M2.7 plus rapide
MiniMax-VL-01VisionModèle de compréhension d’image
image-01Génération d’imagesÉdition texte-vers-image et image-vers-image
music-2.6Génération musicaleModèle musical par défaut
music-2.5Génération musicaleNiveau précédent de génération musicale
music-2.0Génération musicaleAncien niveau de génération musicale
MiniMax-Hailuo-2.3Génération vidéoFlux 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.
Idéal pour : une configuration rapide avec MiniMax Coding Plan via OAuth, sans clé API requise.
1

Run onboarding

openclaw onboard --auth-choice minimax-global-oauth
Cela authentifie auprès de api.minimax.io.
2

Verify the model is available

openclaw models list --provider minimax-portal
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.
Lien de parrainage pour MiniMax Coding Plan (10 % de réduction) : MiniMax Coding Plan

​
Configurer via openclaw configure

Utilisez l’assistant de configuration interactif pour configurer 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

Choisir une option d’auth MiniMax

Choisissez l’une des options MiniMax disponibles :
Choix d’authDescription
minimax-global-oauthOAuth international (Coding Plan)
minimax-cn-oauthOAuth Chine (Coding Plan)
minimax-global-apiClé d’API internationale
minimax-cn-apiClé d’API Chine
4

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.
Consultez Génération d’images pour les paramètres partagés de l’outil, la sélection du fournisseur et le comportement de basculement.

​
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-hd et speech-01-turbo.
  • La résolution de l’authentification est messages.tts.providers.minimax.apiKey, puis les profils d’auth OAuth/jeton minimax-portal, puis les clés d’environnement Token Plan (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 depuis le MP3 MiniMax vers Opus 48 kHz avec ffmpeg, car l’API de fichiers Feishu/Lark n’accepte que file_type: "opus" pour les messages audio natifs.
  • MiniMax T2A accepte les valeurs fractionnaires speed et vol, mais pitch est envoyé sous forme d’entier ; OpenClaw tronque les valeurs fractionnaires de pitch avant la requête API.
ParamètreVariable d’envPar défautDescription
messages.tts.providers.minimax.baseUrlMINIMAX_API_HOSThttps://api.minimax.ioHôte API MiniMax T2A.
messages.tts.providers.minimax.modelMINIMAX_TTS_MODELspeech-2.8-hdIdentifiant du modèle TTS.
messages.tts.providers.minimax.voiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narratorIdentifiant de voix utilisé pour la sortie vocale.
messages.tts.providers.minimax.speed1.0Vitesse de lecture, 0.5..2.0.
messages.tts.providers.minimax.vol1.0Volume, (0, 10].
messages.tts.providers.minimax.pitch0Dé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.5 et minimax/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",
      },
    },
  },
}
Consultez Génération de musique pour les paramètres partagés de l’outil, la sélection du fournisseur et le comportement de basculement.

​
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 aspectRatio et resolution
Pour utiliser MiniMax comme fournisseur vidéo par défaut : 
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
Consultez 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’images

Le plugin MiniMax enregistre la compréhension d’images séparément du catalogue texte :
ID du fournisseurModèle d’image par défaut
minimaxMiniMax-VL-01
minimax-portalMiniMax-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_KEY lorsqu’elle pointe déjà vers un identifiant Token Plan
  • 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 minimax ; la configuration OAuth CN/global peut orienter la région indirectement 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.*.
Consultez Recherche MiniMax pour la configuration complète et l’utilisation de la recherche web.

​
Configuration avancée

OptionDescription
models.providers.minimax.baseUrlPréférez https://api.minimax.io/anthropic (compatible Anthropic) ; https://api.minimax.io/v1 est optionnel pour les payloads compatibles OpenAI
models.providers.minimax.apiPréférez anthropic-messages ; openai-completions est optionnel pour les payloads compatibles OpenAI
models.providers.minimax.apiKeyClé d’API MiniMax (MINIMAX_API_KEY)
models.providers.minimax.modelsDéfinir id, name, reasoning, contextWindow, maxTokens, cost
agents.defaults.modelsDonner un alias aux modèles à inclure dans l’allowlist
models.modeGardez merge si vous voulez ajouter MiniMax aux éléments intégrés
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.
/fast on ou params.fastMode: true réécrit MiniMax-M2.7 en MiniMax-M2.7-highspeed sur le chemin de streaming compatible Anthropic.
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"],
      },
    },
  },
}
  • 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éduit l’hôte depuis models.providers.minimax-portal.baseUrl ou models.providers.minimax.baseUrl lorsque c’est configuré ; ainsi les configurations globales utilisant https://api.minimax.io/anthropic interrogent api.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 % left que les autres fournisseurs. Les champs bruts usage_percent / usagePercent de 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 depuis start_time / end_time si 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-cn et minimax-portal comme 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>
  • 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-01 détenu par le plugin
  • Mettez à jour les valeurs de tarification dans models.json si vous avez besoin d’un suivi exact des coûts
  • Utilisez openclaw models list pour confirmer l’ID de fournisseur actuel, puis basculez avec openclaw models set minimax/MiniMax-M2.7 ou openclaw models set minimax-portal/MiniMax-M2.7
Lien de parrainage pour MiniMax Coding Plan (10 % de réduction) : MiniMax Coding Plan
Consultez Fournisseurs de modèles pour les règles des fournisseurs.

​
Dépannage

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 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 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.7 ou minimax/MiniMax-M2.7-highspeed
  • Chemin OAuth : minimax-portal/MiniMax-M2.7 ou minimax-portal/MiniMax-M2.7-highspeed
Puis revérifiez avec :
openclaw models list
Aide supplémentaire : Dépannage et FAQ.

​
Connexe

Sélection du modèle

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

Génération d’images

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

Génération de musique

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

Génération vidéo

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

Recherche MiniMax

Configuration de la recherche web via MiniMax Token Plan.

Dépannage

Dépannage général et FAQ.