OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

MiniMax

Le plugin minimax fourni enregistre deux fournisseurs ainsi que cinq fonctionnalités : chat, génération d’images, génération de musique, génération de vidéos, compréhension d’images, synthèse vocale (T2A v2) et recherche web.

ID du fournisseur Authentification Fonctionnalités
minimax Clé API Texte, génération d’images, génération de musique, génération de vidéos, 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éos, compréhension d’images, synthèse vocale

Catalogue intégré

Modèle Type Description
MiniMax-M3 Chat (raisonnement) Modèle de raisonnement 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’images
image-01 Génération d’images Génération texte-image et édition image-image
music-2.6 Génération de musique Modèle musical par défaut
MiniMax-Hailuo-2.3 Génération de vidéos Flux texte-vidéo et image-vidéo

Les références de modèles suivent le mode d’authentification : minimax/<model> pour les configurations avec clé API, et minimax-portal/<model> pour les configurations OAuth.

Prise en main

OAuth (Coding Plan)

Idéal pour : une configuration rapide avec MiniMax Coding Plan via OAuth, sans clé API.

International

  • Exécuter l’intégration initiale

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

    URL de base du fournisseur obtenue : api.minimax.io.

  • Vérifier que le modèle est disponible

    bash
    openclaw models list --provider minimax-portal

    • Chine

  • Exécuter l’intégration initiale

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

    URL de base du fournisseur obtenue : api.minimaxi.com.

  • Vérifier que le modèle est disponible

    bash
    openclaw models list --provider minimax-portal

    • Clé API

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

    International

  • Exécuter l’intégration initiale

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

    Cette commande configure api.minimax.io comme URL de base.

  • Vérifier que le modèle est disponible

    bash
    openclaw models list --provider minimax

    • Chine

  • Exécuter l’intégration initiale

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

    Cette commande configure api.minimaxi.com comme URL de base.

  • Vérifier que le modèle est disponible

    bash
    openclaw models list --provider minimax

    • Exemple de configuration

    json5
    {  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 avec openclaw configure

  • Lancer l’assistant

    bash
    openclaw configure

  • Sélectionner le modèle/l’authentification

    Choisissez Modèle/authentification dans le menu.

  • Choisir une option d’authentification MiniMax

    Choix d’authentification Description
    minimax-global-oauth OAuth international (forfait Coding)
    minimax-cn-oauth OAuth Chine (forfait Coding)
    minimax-global-api Clé API internationale
    minimax-cn-api Clé 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 sur minimax et minimax-portal, en réutilisant la même MINIMAX_API_KEY ou la même authentification OAuth que les modèles de texte.

    • Génération de texte en image et retouche d’image en image (référence du sujet), toutes deux avec contrôle du format d’image
    • Jusqu’à 9 images de sortie par requête et 1 image de référence par requête de retouche
    • Formats d’image pris en charge : 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9
    json5
    {  agents: {    defaults: {      imageGenerationModel: { primary: "minimax/image-01" },    },  },}

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

    Synthèse vocale

    Le Plugin minimax intégré enregistre MiniMax T2A v2 comme fournisseur de synthèse vocale pour messages.tts.

    • Modèle TTS par défaut : speech-2.8-hd
    • Voix par défaut : English_expressive_narrator
    • Identifiants des modèles intégrés : 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, speech-01-turbo, speech-01-240228
    • Ordre de résolution de l’authentification : messages.tts.providers.minimax.apiKey, puis les profils d’authentification OAuth/par jeton minimax-portal, puis les clés d’environnement du forfait Token (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 au format MP3. Les destinations de notes vocales (Feishu, Telegram et les autres canaux qui demandent une pièce jointe compatible avec les notes vocales) sont transcodées du MP3 MiniMax vers le format Opus à 48 kHz avec ffmpeg, car, par exemple, l’API de fichiers 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 de pitch avant la requête API
    Paramètre Variable d’environnement Valeur par défaut Description
    messages.tts.providers.minimax.baseUrl MINIMAX_API_HOST https://api.minimax.io Hôte de l’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 la voix utilisée pour la synthèse.
    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 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 musical par défaut : minimax/music-2.6 (OAuth : minimax-portal/music-2.6)
    • Prend également en charge music-2.6-free, music-cover et music-cover-free
    • Paramètres de contrôle de l’invite : lyrics, instrumental
    • Format de sortie : mp3
    • Les exécutions adossées à une session se détachent via le flux partagé de tâche et d’état, notamment action: "status"
    json5
    {  agents: {    defaults: {      musicGenerationModel: { primary: "minimax/music-2.6" },    },  },}

    Génération vidéo

    Le Plugin MiniMax intégré enregistre la génération 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 (OAuth : minimax-portal/MiniMax-Hailuo-2.3)
    • Prend également en charge MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live et I2V-01
    • Modes : conversion de texte en vidéo et flux avec une seule image de référence
    • Prend en charge resolution (768P ou 1080P sur les modèles Hailuo 2.3/02) ; aspectRatio n’est pas pris en charge et est ignoré
    json5
    {  agents: {    defaults: {      videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" },    },  },}

    Compréhension des images

    Le Plugin MiniMax enregistre la compréhension des images séparément du catalogue de texte :

    ID du fournisseur Modèle d’image par défaut Extraction de texte des PDF
    minimax MiniMax-VL-01 MiniMax-M2.7
    minimax-portal MiniMax-VL-01 MiniMax-M2.7

    C’est pourquoi le routage automatique des médias peut utiliser la compréhension des images de MiniMax, même lorsque le catalogue intégré du fournisseur de texte comprend également des références de chat M3 capables de traiter des images. La compréhension des PDF utilise MiniMax-M2.7 uniquement pour l’extraction de texte ; MiniMax n’enregistre aucun chemin de conversion des PDF en images.

    Recherche sur le Web

    Le Plugin MiniMax enregistre également web_search au moyen de l’API de recherche MiniMax Token Plan (/v1/coding_plan/search).

    • ID du fournisseur : minimax
    • Résultats structurés : titres, URL, extraits, requêtes associées
    • Variable d’environnement recommandée : MINIMAX_CODE_PLAN_KEY
    • Alias de variables d’environnement acceptés : MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
    • Solution de repli pour la compatibilité : MINIMAX_API_KEY lorsqu’elle désigne déjà un identifiant d’authentification 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 conserve l’ID de fournisseur minimax ; la configuration OAuth pour la Chine ou le reste du monde peut orienter indirectement la région au moyen de models.providers.minimax-portal.baseUrl et fournir l’authentification par jeton Bearer au moyen de MINIMAX_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 avec Anthropic) ; https://api.minimax.io/v1 est facultatif pour les charges utiles compatibles avec OpenAI
    models.providers.minimax.api Préférez anthropic-messages ; openai-completions est facultatif pour les charges utiles compatibles avec OpenAI
    models.providers.minimax.apiKey Clé API MiniMax (MINIMAX_API_KEY)
    models.providers.minimax.models Définissez id, name, reasoning, contextWindow, maxTokens, cost
    agents.defaults.models Attribuez des alias aux modèles que vous souhaitez ajouter à la liste d’autorisation
    models.mode Conservez merge si vous souhaitez ajouter MiniMax aux modèles intégrés
    Valeurs par défaut de la réflexion

    Avec api: "anthropic-messages", OpenClaw injecte thinking: { type: "disabled" } pour les modèles MiniMax M2.x, sauf si un wrapper antérieur a déjà défini le champ thinking dans la charge utile. Cela empêche le point de terminaison de diffusion en continu de M2.x d’émettre reasoning_content dans des fragments delta de style OpenAI, ce qui exposerait le raisonnement interne dans la sortie visible.

    MiniMax-M3 (et M3.x) fait exception : M3 renvoie un tableau content vide avec stop_reason: "end_turn" lorsque la réflexion est désactivée. OpenClaw supprime donc la valeur implicite désactivée par défaut pour M3 et, lorsqu’un niveau de réflexion est défini, impose à la place thinking: { type: "adaptive" }.

    Niveaux de réflexion disponibles par famille de modèles :

    Famille de modèles Niveaux Valeur par défaut
    MiniMax-M3 off, adaptive adaptive
    MiniMax-M2.x off, minimal, low, medium, high off
    Mode rapide

    /fast on ou params.fastMode: true remplace MiniMax-M2.7 par MiniMax-M2.7-highspeed sur le chemin de diffusion en continu compatible avec Anthropic (api: "anthropic-messages", fournisseur minimax ou minimax-portal).

    Exemple de solution de repli

    Idéal pour : conserver comme modèle principal votre modèle de dernière génération le plus performant et basculer vers MiniMax M2.7 en cas d’échec. 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é.

    json5
    {  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/remains ou https://api.minimax.io/v1/token_plan/remains (nécessite une clé Coding Plan).
    • L’interrogation périodique de l’utilisation déduit l’hôte de models.providers.minimax-portal.baseUrl ou de models.providers.minimax.baseUrl lorsqu’ils sont configurés. Ainsi, les configurations mondiales utilisant https://api.minimax.io/anthropic interrogent api.minimax.io. Les URL de base absentes ou mal formées conservent la solution de repli chinoise pour assurer la compatibilité.
    • OpenClaw normalise l’utilisation du Coding Plan de MiniMax selon le même affichage % left que celui utilisé par les autres fournisseurs. Les champs bruts usage_percent / usagePercent de MiniMax représentent le quota restant, et non le quota consommé ; OpenClaw les inverse donc. Les champs fondés sur un nombre sont prioritaires lorsqu’ils sont présents.
    • Lorsque l’API renvoie model_remains, OpenClaw privilégie l’entrée du modèle de chat, déduit au besoin le libellé de la fenêtre à partir de start_time / end_time et inclut le nom du modèle sélectionné dans le libellé du forfait afin de faciliter la distinction entre les fenêtres du Coding Plan.
    • Les instantanés d’utilisation traitent minimax, minimax-cn, minimax-portal et minimax-portal-cn comme une même surface de quota MiniMax, et privilégient les données OAuth MiniMax enregistrées avant de se rabattre sur les variables d’environnement de clé Coding Plan.

    Remarques

    • Modèle de chat par défaut : MiniMax-M3. Autres modèles de chat : MiniMax-M2.7, MiniMax-M2.7-highspeed
    • L’intégration initiale et la configuration directe par clé API écrivent les définitions de modèles pour M3 et les deux variantes de M2.7
    • La compréhension des images utilise le fournisseur de médias MiniMax-VL-01 appartenant au Plugin
    • Mettez à jour les valeurs tarifaires dans models.json si vous avez besoin d’un suivi exact des coûts
    • Utilisez openclaw models list pour confirmer l’ID actuel du fournisseur, puis changez de modèle avec openclaw models set minimax/MiniMax-M3 ou openclaw models set minimax-portal/MiniMax-M3

    Dépannage

    "Modèle inconnu : 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 d’authentification ni aucune clé de variable d’environnement MiniMax trouvés). Pour corriger le problème :

    • Exécutez openclaw configure et sélectionnez une option d’authentification MiniMax, ou
    • Ajoutez manuellement le bloc models.providers.minimax ou models.providers.minimax-portal correspondant, ou
    • Définissez MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN ou un profil d’authentification MiniMax afin que le fournisseur correspondant puisse être injecté.

    Vérifiez que l’ID du modèle est sensible à la casse :

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

    Vérifiez ensuite à nouveau avec :

    bash
    openclaw models list

    Contenu associé

    Sélection du modèle

    Choix des fournisseurs, des références de modèles et du 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 de vidéos

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

    Configuration de la recherche sur le Web au moyen de MiniMax Token Plan.
    Dépannage

    Dépannage général et FAQ.
    Was this useful?
    On this page

    On this page