MiniMax

OpenClaw's MiniMax provider defaults to MiniMax M2.7.

MiniMax also provides:

• Bundled speech synthesis via T2A v2
• Bundled image understanding via MiniMax-VL-01
• Bundled music generation via music-2.6
• Bundled web_search through the MiniMax Token Plan search API

Provider split:

# Built-in catalog

# Getting started

Choose your preferred auth method and follow the setup steps.

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

# Configure via openclaw configure

Use the interactive config wizard to set MiniMax without editing JSON:

openclaw configure

# Funzionalità

# Generazione di immagini

Il Plugin MiniMax registra il modello image-01 per lo strumento image_generate. Supporta:

• Generazione da testo a immagine con controllo delle proporzioni
• Modifica da immagine a immagine (riferimento del soggetto) con controllo delle proporzioni
• Fino a 9 immagini di output per richiesta
• Fino a 1 immagine di riferimento per richiesta di modifica
• Proporzioni supportate: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9

Per usare MiniMax per la generazione di immagini, impostalo come provider di generazione immagini:

{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}

Il Plugin usa la stessa autenticazione MINIMAX_API_KEY o OAuth dei modelli di testo. Non è necessaria alcuna configurazione aggiuntiva se MiniMax è già configurato.

Sia minimax sia minimax-portal registrano image_generate con lo stesso modello image-01. Le configurazioni con chiave API usano MINIMAX_API_KEY; le configurazioni OAuth possono usare invece il percorso di autenticazione minimax-portal incluso.

La generazione di immagini usa sempre l'endpoint immagine dedicato di MiniMax (/v1/image_generation) e ignora models.providers.minimax.baseUrl, poiché quel campo configura l'URL di base compatibile con chat/Anthropic. Imposta MINIMAX_API_HOST=https://api.minimaxi.com per instradare la generazione di immagini attraverso l'endpoint CN; l'endpoint globale predefinito è https://api.minimax.io.

Quando l'onboarding o la configurazione con chiave API scrive voci esplicite models.providers.minimax, OpenClaw materializza MiniMax-M2.7 e MiniMax-M2.7-highspeed come modelli chat solo testo. La comprensione delle immagini è esposta separatamente tramite il provider multimediale MiniMax-VL-01 di proprietà del Plugin.

# Sintesi vocale

Il Plugin minimax incluso registra MiniMax T2A v2 come provider vocale per messages.tts.

• Modello TTS predefinito: speech-2.8-hd
• Voce predefinita: English_expressive_narrator
• Gli ID modello inclusi supportati comprendono 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 e speech-01-turbo.
• La risoluzione dell'autenticazione è messages.tts.providers.minimax.apiKey, poi i profili di autenticazione OAuth/token minimax-portal, poi le chiavi ambiente Token Plan (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY), poi MINIMAX_API_KEY.
• Se non è configurato alcun host TTS, OpenClaw riusa l'host OAuth minimax-portal configurato e rimuove i suffissi di percorso compatibili con Anthropic, come /anthropic.
• Gli allegati audio normali restano MP3.
• Le destinazioni per note vocali come Feishu e Telegram vengono transcodificate da MP3 MiniMax a Opus 48 kHz con ffmpeg, perché l'API file di Feishu/Lark accetta solo file_type: "opus" per i messaggi audio nativi.
• MiniMax T2A accetta speed e vol frazionari, ma pitch viene inviato come intero; OpenClaw tronca i valori frazionari di pitch prima della richiesta API.

# Generazione di musica

Il Plugin MiniMax incluso registra la generazione di musica tramite lo strumento condiviso music_generate sia per minimax sia per minimax-portal.

• Modello musicale predefinito: minimax/music-2.6
• Modello musicale OAuth: minimax-portal/music-2.6
• Supporta anche minimax/music-2.5 e minimax/music-2.0
• Controlli del prompt: lyrics, instrumental, durationSeconds
• Formato di output: mp3
• Le esecuzioni basate su sessione si scollegano tramite il flusso condiviso di attività/stato, incluso action: "status"

Per usare MiniMax come provider musicale predefinito:

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.6",
      },
    },
  },
}

# Generazione di video

Il Plugin MiniMax incluso registra la generazione di video tramite lo strumento condiviso video_generate sia per minimax sia per minimax-portal.

• Modello video predefinito: minimax/MiniMax-Hailuo-2.3
• Modello video OAuth: minimax-portal/MiniMax-Hailuo-2.3
• Modalità: flussi da testo a video e con riferimento da singola immagine
• Supporta aspectRatio e resolution

Per usare MiniMax come provider video predefinito:

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

# Comprensione delle immagini

Il Plugin MiniMax registra la comprensione delle immagini separatamente dal catalogo di testo:

Per questo il routing automatico dei media può usare la comprensione delle immagini di MiniMax anche quando il catalogo del provider di testo incluso mostra ancora riferimenti chat M2.7 solo testo.

# Ricerca web

Il Plugin MiniMax registra anche web_search tramite l'API di ricerca MiniMax Token Plan.

• ID provider: minimax
• Risultati strutturati: titoli, URL, estratti, query correlate
• Variabile env preferita: MINIMAX_CODE_PLAN_KEY
• Alias env accettati: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
• Ripiego di compatibilità: MINIMAX_API_KEY quando punta già a una credenziale token-plan
• Riuso della regione: plugins.entries.minimax.config.webSearch.region, poi MINIMAX_API_HOST, poi gli URL di base del provider MiniMax
• La ricerca resta sull'ID provider minimax; la configurazione OAuth CN/globale può indirizzare indirettamente la regione tramite models.providers.minimax-portal.baseUrl e può fornire l'autenticazione bearer tramite MINIMAX_OAUTH_TOKEN

La configurazione si trova sotto plugins.entries.minimax.config.webSearch.*.

# Configurazione avanzata

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

# Note

• I riferimenti modello seguono il percorso di autenticazione:
  • Configurazione con chiave API: minimax/<model>
  • Configurazione OAuth: minimax-portal/<model>
• Modello chat predefinito: MiniMax-M2.7
• Modello chat alternativo: MiniMax-M2.7-highspeed
• L'onboarding e la configurazione diretta con chiave API scrivono definizioni di modelli solo testo per entrambe le varianti M2.7
• La comprensione delle immagini usa il provider media MiniMax-VL-01 di proprietà del Plugin
• Aggiorna i valori dei prezzi in models.json se hai bisogno di un tracciamento esatto dei costi
• Usa openclaw models list per confermare l'ID provider corrente, poi passa a un altro modello con openclaw models set minimax/MiniMax-M2.7 o openclaw models set minimax-portal/MiniMax-M2.7

# Risoluzione dei problemi

openclaw models list

# Correlati