MiniMax

OpenClaw utilise par défaut MiniMax M3 pour son fournisseur MiniMax.

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 musicale intégrée via music-2.6
• web_search intégré via l’API de recherche MiniMax Token Plan

Répartition des fournisseurs :

Catalogue intégré

Bien démarrer

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

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

openclaw models list --provider minimax-portal

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

openclaw models list --provider minimax-portal

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

openclaw models list --provider minimax

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

openclaw models list --provider minimax

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

Configurer via openclaw configure

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

openclaw configure

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 texte-vers-image avec contrôle du rapport d’aspect
• Édition image-vers-image (référence de sujet) avec contrôle du rapport d’aspect
• Jusqu’à 9 images de sortie par requête
• Jusqu’à 1 image de référence par requête d’édition
• Rapports 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 par 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édié de MiniMax (/v1/image_generation) et ignore models.providers.minimax.baseUrl, car ce champ configure l’URL de base compatible chat/Anthropic. Définissez MINIMAX_API_HOST=https://api.minimaxi.com pour router 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’intégration ou la configuration par clé API écrit des entrées models.providers.minimax explicites, OpenClaw matérialise MiniMax-M3, MiniMax-M2.7 et MiniMax-M2.7-highspeed comme modèles de chat. M3 annonce la saisie texte et image ; la compréhension d’images reste exposée séparément via le fournisseur multimédia MiniMax-VL-01 détenu par le Plugin.

Texte-vers-parole

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 ID 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 d’authentification est messages.tts.providers.minimax.apiKey, puis les profils d’authentification 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 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é comme entier ; OpenClaw tronque les valeurs fractionnaires de pitch avant la requête API.

Génération musicale

Le Plugin MiniMax intégré enregistre la génération musicale 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 aussi en charge minimax/music-2.5 et minimax/music-2.0
• Contrôles du prompt : lyrics, instrumental
• Format de sortie : mp3
• Les exécutions adossées à une session 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",      },    },  },}

Génération de vidéo

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

• Modèle de vidéo par défaut : minimax/MiniMax-Hailuo-2.3
• Modèle de 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 de vidéo par défaut :

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

Compréhension d’image

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

C’est pourquoi le routage automatique des médias peut utiliser la compréhension d’image MiniMax même lorsque le catalogue de fournisseur de texte intégré inclut aussi des références de chat M3 compatibles avec l’image.

Recherche Web

Le Plugin MiniMax enregistre aussi web_search via l’API de recherche MiniMax Token Plan.

• ID de 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 de Token Plan
• Réutilisation de 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/globale 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.*.

Configuration avancée

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

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-M3
• Modèles de chat alternatifs : MiniMax-M2.7, MiniMax-M2.7-highspeed
• L’onboarding et la configuration directe par clé d’API écrivent les définitions de modèle pour M3 et les deux variantes M2.7
• La compréhension d’image utilise le fournisseur média 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 changez avec openclaw models set minimax/MiniMax-M3 ou openclaw models set minimax-portal/MiniMax-M3

Dépannage

openclaw models list

Connexe