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

Providers

MiniMax

Il Plugin minimax incluso registra due provider e sette funzionalità: chat, generazione di immagini, generazione musicale, generazione video, comprensione delle immagini, sintesi vocale (T2A v2) e ricerca sul web.

ID provider Autenticazione Funzionalità
minimax Chiave API Testo, generazione di immagini, generazione musicale, generazione video, comprensione delle immagini, sintesi vocale, ricerca sul web
minimax-portal OAuth Testo, generazione di immagini, generazione musicale, generazione video, comprensione delle immagini, sintesi vocale

Catalogo integrato

Modello Tipo Descrizione
MiniMax-M3 Chat (ragionamento) Modello di ragionamento ospitato predefinito
MiniMax-M2.7 Chat (ragionamento) Modello di ragionamento ospitato precedente
MiniMax-M2.7-highspeed Chat (ragionamento) Livello di ragionamento M2.7 più veloce
MiniMax-VL-01 Visione Modello di comprensione delle immagini
image-01 Generazione di immagini Modifica da testo a immagine e da immagine a immagine
music-2.6 Generazione musicale Modello musicale predefinito
MiniMax-Hailuo-2.3 Generazione video Flussi da testo a video e da immagine a video

I riferimenti ai modelli seguono il percorso di autenticazione: minimax/<model> per le configurazioni con chiave API, minimax-portal/<model> per le configurazioni OAuth.

Per iniziare

OAuth (Coding Plan)

Ideale per: configurazione rapida con MiniMax Coding Plan tramite OAuth, senza necessità di una chiave API.

Internazionale

  • Esegui la configurazione iniziale

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

    URL di base del provider risultante: api.minimax.io.

  • Verifica che il modello sia disponibile

    bash
    openclaw models list --provider minimax-portal

    • Cina

  • Esegui la configurazione iniziale

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

    URL di base del provider risultante: api.minimaxi.com.

  • Verifica che il modello sia disponibile

    bash
    openclaw models list --provider minimax-portal

    • Chiave API

    Ideale per: MiniMax ospitato con API compatibile con Anthropic.

    Internazionale

  • Esegui la configurazione iniziale

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

    Questa operazione configura api.minimax.io come URL di base.

  • Verifica che il modello sia disponibile

    bash
    openclaw models list --provider minimax

    • Cina

  • Esegui la configurazione iniziale

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

    Questa operazione configura api.minimaxi.com come URL di base.

  • Verifica che il modello sia disponibile

    bash
    openclaw models list --provider minimax

    • Esempio di configurazione

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

    Configurazione tramite openclaw configure

  • Avvia la procedura guidata

    bash
    openclaw configure

  • Seleziona modello/autenticazione

    Scegli Modello/autenticazione dal menu.

  • Scegli un'opzione di autenticazione MiniMax

    Opzione di autenticazione Descrizione
    minimax-global-oauth OAuth internazionale (piano Coding)
    minimax-cn-oauth OAuth Cina (piano Coding)
    minimax-global-api Chiave API internazionale
    minimax-cn-api Chiave API per la Cina

  • Scegli il modello predefinito

    Quando richiesto, seleziona il modello predefinito.

    • Funzionalità

    Generazione di immagini

    Il plugin MiniMax registra il modello image-01 per lo strumento image_generate sia su minimax sia su minimax-portal, riutilizzando la stessa MINIMAX_API_KEY o la stessa autenticazione OAuth dei modelli di testo.

    • Generazione da testo a immagine e modifica da immagine a immagine (riferimento del soggetto), entrambe con controllo delle proporzioni
    • Fino a 9 immagini di output per richiesta e 1 immagine di riferimento per ogni richiesta di modifica
    • Proporzioni supportate: 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 generazione di immagini usa sempre l'endpoint dedicato alle immagini di MiniMax (/v1/image_generation) e ignora models.providers.minimax.baseUrl, poiché tale campo configura invece l'URL di base compatibile con chat/Anthropic. Imposta MINIMAX_API_HOST=https://api.minimaxi.com per instradare la generazione di immagini tramite l'endpoint cinese; l'endpoint globale predefinito è https://api.minimax.io.

    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
    • ID dei modelli inclusi: 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
    • Ordine di risoluzione dell'autenticazione: messages.tts.providers.minimax.apiKey, quindi i profili di autenticazione OAuth/token di minimax-portal, poi le chiavi di ambiente del piano Token (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY) e infine MINIMAX_API_KEY
    • Se non è configurato alcun host TTS, OpenClaw riutilizza l'host OAuth configurato per minimax-portal e rimuove i suffissi di percorso compatibili con Anthropic, come /anthropic
    • I normali allegati audio rimangono in formato MP3. Le destinazioni per note vocali (Feishu, Telegram e altri canali che richiedono un allegato compatibile con le note vocali) vengono transcodificate da MP3 MiniMax a Opus a 48 kHz con ffmpeg, poiché, ad esempio, l'API dei file di Feishu/Lark accetta solo file_type: "opus" per i messaggi audio nativi
    • MiniMax T2A accetta valori frazionari per speed e vol, ma pitch viene inviato come numero intero; OpenClaw tronca i valori frazionari di pitch prima della richiesta API
    Impostazione Variabile di ambiente Valore predefinito Descrizione
    messages.tts.providers.minimax.baseUrl MINIMAX_API_HOST https://api.minimax.io Host dell'API MiniMax T2A.
    messages.tts.providers.minimax.model MINIMAX_TTS_MODEL speech-2.8-hd ID del modello TTS.
    messages.tts.providers.minimax.voiceId MINIMAX_TTS_VOICE_ID English_expressive_narrator ID della voce usata per l'output vocale.
    messages.tts.providers.minimax.speed 1.0 Velocità di riproduzione, 0.5..2.0.
    messages.tts.providers.minimax.vol 1.0 Volume, (0, 10].
    messages.tts.providers.minimax.pitch 0 Variazione intera dell'intonazione, -12..12.

    Generazione musicale

    Il plugin MiniMax incluso registra la generazione musicale tramite lo strumento condiviso music_generate sia per minimax sia per minimax-portal.

    • Modello musicale predefinito: minimax/music-2.6 (OAuth: minimax-portal/music-2.6)
    • Supporta anche music-2.6-free, music-cover e music-cover-free
    • Controlli del prompt: lyrics, instrumental
    • Formato di output: mp3
    • Le esecuzioni basate su sessione vengono separate tramite il flusso condiviso di attività/stato, incluso action: "status"
    json5
    {  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 (OAuth: minimax-portal/MiniMax-Hailuo-2.3)
    • Supporta anche MiniMax-Hailuo-2.3-Fast, MiniMax-Hailuo-02, I2V-01-Director, I2V-01-live e I2V-01
    • Modalità: flussi da testo a video e con riferimento a una singola immagine
    • Supporta resolution (768P o 1080P sui modelli Hailuo 2.3/02); aspectRatio non è supportato e viene ignorato
    json5
    {  agents: {    defaults: {      videoGenerationModel: { primary: "minimax/MiniMax-Hailuo-2.3" },    },  },}

    Comprensione delle immagini

    Il plugin MiniMax registra la comprensione delle immagini separatamente dal catalogo testuale:

    ID provider Modello di immagini predefinito Estrazione del testo dai PDF
    minimax MiniMax-VL-01 MiniMax-M2.7
    minimax-portal MiniMax-VL-01 MiniMax-M2.7

    Per questo motivo, l'instradamento automatico dei contenuti multimediali può usare la comprensione delle immagini di MiniMax anche quando il catalogo incluso del provider testuale contiene anche riferimenti di chat M3 con capacità di elaborazione delle immagini. La comprensione dei PDF usa MiniMax-M2.7 esclusivamente per l'estrazione del testo; MiniMax non registra un percorso di conversione da PDF a immagine.

    Ricerca web

    Il plugin MiniMax registra anche web_search tramite l'API di ricerca MiniMax Token Plan (/v1/coding_plan/search).

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

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

    Configurazione avanzata

    Opzioni di configurazione
    Opzione Descrizione
    models.providers.minimax.baseUrl Preferisci https://api.minimax.io/anthropic (compatibile con Anthropic); https://api.minimax.io/v1 è facoltativo per i payload compatibili con OpenAI
    models.providers.minimax.api Preferisci anthropic-messages; openai-completions è facoltativo per i payload compatibili con OpenAI
    models.providers.minimax.apiKey Chiave API MiniMax (MINIMAX_API_KEY)
    models.providers.minimax.models Definisci id, name, reasoning, contextWindow, maxTokens, cost
    agents.defaults.models Assegna alias ai modelli che desideri inserire nell'elenco consentito
    models.mode Mantieni merge se vuoi aggiungere MiniMax insieme ai modelli integrati
    Impostazioni predefinite del ragionamento

    Con api: "anthropic-messages", OpenClaw inserisce thinking: { type: "disabled" } per i modelli MiniMax M2.x, a meno che un wrapper precedente non abbia già impostato il campo thinking nel payload. Ciò impedisce all'endpoint di streaming di M2.x di emettere reasoning_content in frammenti delta in stile OpenAI, evitando che il ragionamento interno venga esposto nell'output visibile.

    MiniMax-M3 (e M3.x) è escluso: quando il ragionamento è disabilitato, M3 restituisce un array content vuoto con stop_reason: "end_turn", quindi OpenClaw rimuove l'impostazione predefinita implicita di disabilitazione per M3 e, quando è impostato un livello di ragionamento, forza invece thinking: { type: "adaptive" }.

    Livelli di ragionamento disponibili per famiglia di modelli:

    Famiglia di modelli Livelli Predefinito
    MiniMax-M3 off, adaptive adaptive
    MiniMax-M2.x off, minimal, low, medium, high off
    Modalità veloce

    /fast on o params.fastMode: true sostituisce MiniMax-M2.7 con MiniMax-M2.7-highspeed nel percorso di streaming compatibile con Anthropic (api: "anthropic-messages", provider minimax o minimax-portal).

    Esempio di fallback

    Ideale per: mantenere come primario il modello più potente di ultima generazione ed eseguire il failover su MiniMax M2.7. L'esempio seguente usa Opus come modello primario concreto; sostituiscilo con il modello primario di ultima generazione che preferisci.

    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"],      },    },  },}
    Dettagli sull'utilizzo del Coding Plan
    • API di utilizzo del Coding Plan: https://api.minimaxi.com/v1/token_plan/remains o https://api.minimax.io/v1/token_plan/remains (richiede una chiave del Coding Plan).
    • Il polling dell'utilizzo ricava l'host da models.providers.minimax-portal.baseUrl o models.providers.minimax.baseUrl, se configurati; pertanto, le configurazioni globali che usano https://api.minimax.io/anthropic interrogano api.minimax.io. Gli URL di base mancanti o non validi mantengono il fallback CN per compatibilità.
    • OpenClaw normalizza l'utilizzo del Coding Plan MiniMax usando la stessa visualizzazione % rimanente impiegata dagli altri provider. I campi non elaborati usage_percent / usagePercent di MiniMax rappresentano la quota rimanente, non quella consumata, quindi OpenClaw li inverte. I campi basati sul conteggio hanno la precedenza quando presenti.
    • Quando l'API restituisce model_remains, OpenClaw preferisce la voce del modello di chat, ricava l'etichetta della finestra da start_time / end_time quando necessario e include il nome del modello selezionato nell'etichetta del piano, così da distinguere più facilmente le finestre del Coding Plan.
    • Le istantanee di utilizzo trattano minimax, minimax-cn, minimax-portal e minimax-portal-cn come la stessa superficie di quota MiniMax e preferiscono le credenziali OAuth MiniMax archiviate prima di ricorrere alle variabili d'ambiente della chiave del Coding Plan.

    Note

    • Modello di chat predefinito: MiniMax-M3. Modelli di chat alternativi: MiniMax-M2.7, MiniMax-M2.7-highspeed
    • L'onboarding e la configurazione diretta tramite chiave API scrivono le definizioni dei modelli per M3 e per entrambe le varianti M2.7
    • La comprensione delle immagini usa il provider multimediale MiniMax-VL-01 gestito dal plugin
    • Aggiorna i valori dei prezzi in models.json se ti serve un monitoraggio preciso dei costi
    • Usa openclaw models list per confermare l'ID provider corrente, quindi passa a un altro modello con openclaw models set minimax/MiniMax-M3 o openclaw models set minimax-portal/MiniMax-M3

    Risoluzione dei problemi

    "Modello sconosciuto: minimax/MiniMax-M3"

    In genere, questo significa che il provider MiniMax non è configurato (non sono stati trovati né una voce provider corrispondente né un profilo di autenticazione o una chiave d'ambiente MiniMax). Per risolvere:

    • Esegui openclaw configure e seleziona un'opzione di autenticazione MiniMax, oppure
    • Aggiungi manualmente il blocco models.providers.minimax o models.providers.minimax-portal corrispondente, oppure
    • Imposta MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN o un profilo di autenticazione MiniMax, affinché possa essere inserito il provider corrispondente.

    Assicurati che l'ID del modello distingua tra maiuscole e minuscole:

    • Percorso con chiave API: minimax/MiniMax-M3, minimax/MiniMax-M2.7 o minimax/MiniMax-M2.7-highspeed
    • Percorso OAuth: minimax-portal/MiniMax-M3, minimax-portal/MiniMax-M2.7 o minimax-portal/MiniMax-M2.7-highspeed

    Quindi verifica nuovamente con:

    bash
    openclaw models list

    Argomenti correlati

    Selezione del modello

    Scelta dei provider, dei riferimenti ai modelli e del comportamento di failover.
    Generazione di immagini

    Parametri condivisi dello strumento per le immagini e selezione del provider.
    Generazione musicale

    Parametri condivisi dello strumento per la musica e selezione del provider.
    Generazione video

    Parametri condivisi dello strumento per i video e selezione del provider.
    Ricerca MiniMax

    Configurazione della ricerca web tramite MiniMax Token Plan.
    Risoluzione dei problemi

    Risoluzione generale dei problemi e domande frequenti.
    Was this useful?
    On this page

    On this page