Pular para o conteúdo 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.

O provedor MiniMax do OpenClaw usa MiniMax M2.7 como padrão. A MiniMax também fornece:
  • Síntese de fala integrada via T2A v2
  • Compreensão de imagens integrada via MiniMax-VL-01
  • Geração de música integrada via music-2.6
  • web_search integrado pela API de busca do MiniMax Token Plan
Divisão por provedor:
ID do provedorAutenticaçãoCapacidades
minimaxChave de APITexto, geração de imagens, geração de música, geração de vídeo, compreensão de imagens, fala, busca na web
minimax-portalOAuthTexto, geração de imagens, geração de música, geração de vídeo, compreensão de imagens, fala

​
Catálogo integrado

ModeloTipoDescrição
MiniMax-M2.7Chat (raciocínio)Modelo de raciocínio hospedado padrão
MiniMax-M2.7-highspeedChat (raciocínio)Camada de raciocínio M2.7 mais rápida
MiniMax-VL-01VisãoModelo de compreensão de imagens
image-01Geração de imagensEdição de texto para imagem e imagem para imagem
music-2.6Geração de músicaModelo de música padrão
music-2.5Geração de músicaCamada anterior de geração de música
music-2.0Geração de músicaCamada legada de geração de música
MiniMax-Hailuo-2.3Geração de vídeoFluxos de texto para vídeo e referência de imagem

​
Primeiros passos

Escolha seu método de autenticação preferido e siga as etapas de configuração.
Melhor para: configuração rápida com o MiniMax Coding Plan via OAuth, sem necessidade de chave de API.
1

Run onboarding

openclaw onboard --auth-choice minimax-global-oauth
Isso autentica em api.minimax.io.
2

Verify the model is available

openclaw models list --provider minimax-portal
Configurações com OAuth usam o ID de provedor minimax-portal. As referências de modelo seguem o formato minimax-portal/MiniMax-M2.7.
Link de indicação para o MiniMax Coding Plan (10% de desconto): MiniMax Coding Plan

​
Configurar via openclaw configure

Use o assistente interativo de configuração para definir a MiniMax sem editar JSON:
1

Inicie o assistente

openclaw configure
2

Selecione Modelo/autenticação

Escolha Modelo/autenticação no menu.
3

Escolha uma opção de autenticação do MiniMax

Escolha uma das opções disponíveis do MiniMax:
Opção de autenticaçãoDescrição
minimax-global-oauthOAuth internacional (Plano de Codificação)
minimax-cn-oauthOAuth da China (Plano de Codificação)
minimax-global-apiChave de API internacional
minimax-cn-apiChave de API da China
4

Escolha seu modelo padrão

Selecione seu modelo padrão quando solicitado.

​
Recursos

​
Geração de imagens

O Plugin MiniMax registra o modelo image-01 para a ferramenta image_generate. Ele oferece suporte a:
  • Geração de texto para imagem com controle de proporção
  • Edição de imagem para imagem (referência de assunto) com controle de proporção
  • Até 9 imagens de saída por solicitação
  • Até 1 imagem de referência por solicitação de edição
  • Proporções compatíveis: 1:1, 16:9, 4:3, 3:2, 2:3, 3:4, 9:16, 21:9
Para usar o MiniMax na geração de imagens, defina-o como o provedor de geração de imagens: 
{
  agents: {
    defaults: {
      imageGenerationModel: { primary: "minimax/image-01" },
    },
  },
}
O Plugin usa a mesma MINIMAX_API_KEY ou autenticação OAuth dos modelos de texto. Nenhuma configuração adicional é necessária se o MiniMax já estiver configurado. Tanto minimax quanto minimax-portal registram image_generate com o mesmo modelo image-01. Configurações com chave de API usam MINIMAX_API_KEY; configurações OAuth podem usar o caminho de autenticação minimax-portal integrado. A geração de imagens sempre usa o endpoint de imagem dedicado do MiniMax (/v1/image_generation) e ignora models.providers.minimax.baseUrl, pois esse campo configura a URL base compatível com chat/Anthropic. Defina MINIMAX_API_HOST=https://api.minimaxi.com para rotear a geração de imagens pelo endpoint da CN; o endpoint global padrão é https://api.minimax.io. Quando a integração inicial ou a configuração por chave de API grava entradas explícitas em models.providers.minimax, o OpenClaw materializa MiniMax-M2.7 e MiniMax-M2.7-highspeed como modelos de chat somente de texto. A compreensão de imagens é exposta separadamente pelo provedor de mídia MiniMax-VL-01, de propriedade do Plugin.
Consulte Geração de Imagens para parâmetros compartilhados da ferramenta, seleção de provedor e comportamento de failover.

​
Texto para fala

O Plugin minimax integrado registra o MiniMax T2A v2 como provedor de fala para messages.tts.
  • Modelo TTS padrão: speech-2.8-hd
  • Voz padrão: English_expressive_narrator
  • IDs de modelos integrados compatíveis incluem 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.
  • A resolução de autenticação é messages.tts.providers.minimax.apiKey, depois perfis de autenticação OAuth/token minimax-portal, depois chaves de ambiente do Plano de Token (MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY) e, por fim, MINIMAX_API_KEY.
  • Se nenhum host TTS estiver configurado, o OpenClaw reutiliza o host OAuth minimax-portal configurado e remove sufixos de caminho compatíveis com Anthropic, como /anthropic.
  • Anexos de áudio normais permanecem em MP3.
  • Destinos de notas de voz, como Feishu e Telegram, são transcodificados de MP3 do MiniMax para Opus a 48 kHz com ffmpeg, porque a API de arquivos do Feishu/Lark só aceita file_type: "opus" para mensagens de áudio nativas.
  • O MiniMax T2A aceita speed e vol fracionários, mas pitch é enviado como um inteiro; o OpenClaw trunca valores fracionários de pitch antes da solicitação à API.
ConfiguraçãoVar de ambientePadrãoDescrição
messages.tts.providers.minimax.baseUrlMINIMAX_API_HOSThttps://api.minimax.ioHost da API MiniMax T2A.
messages.tts.providers.minimax.modelMINIMAX_TTS_MODELspeech-2.8-hdID do modelo TTS.
messages.tts.providers.minimax.voiceIdMINIMAX_TTS_VOICE_IDEnglish_expressive_narratorID da voz usada na saída de fala.
messages.tts.providers.minimax.speed1.0Velocidade de reprodução, 0.5..2.0.
messages.tts.providers.minimax.vol1.0Volume, (0, 10].
messages.tts.providers.minimax.pitch0Deslocamento inteiro de tom, -12..12.

​
Geração de música

O Plugin MiniMax integrado registra a geração de música por meio da ferramenta compartilhada music_generate para minimax e minimax-portal.
  • Modelo de música padrão: minimax/music-2.6
  • Modelo de música OAuth: minimax-portal/music-2.6
  • Também oferece suporte a minimax/music-2.5 e minimax/music-2.0
  • Controles de prompt: lyrics, instrumental, durationSeconds
  • Formato de saída: mp3
  • Execuções apoiadas por sessão são desanexadas pelo fluxo compartilhado de tarefa/status, incluindo action: "status"
Para usar o MiniMax como provedor de música padrão: 
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "minimax/music-2.6",
      },
    },
  },
}
Consulte Geração de Música para parâmetros compartilhados da ferramenta, seleção de provedor e comportamento de failover.

​
Geração de vídeo

O Plugin MiniMax integrado registra a geração de vídeo por meio da ferramenta compartilhada video_generate para minimax e minimax-portal.
  • Modelo de vídeo padrão: minimax/MiniMax-Hailuo-2.3
  • Modelo de vídeo OAuth: minimax-portal/MiniMax-Hailuo-2.3
  • Modos: fluxos de texto para vídeo e referência de imagem única
  • Compatível com aspectRatio e resolution
Para usar o MiniMax como provedor de vídeo padrão: 
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "minimax/MiniMax-Hailuo-2.3",
      },
    },
  },
}
Consulte Geração de vídeo para parâmetros de ferramenta compartilhados, seleção de provedor e comportamento de failover.

​
Compreensão de imagem

O Plugin MiniMax registra a compreensão de imagem separadamente do catálogo de texto:
ID do provedorModelo de imagem padrão
minimaxMiniMax-VL-01
minimax-portalMiniMax-VL-01
É por isso que o roteamento automático de mídia pode usar a compreensão de imagem do MiniMax mesmo quando o catálogo de provedor de texto incluído ainda mostra refs de chat M2.7 somente texto.

​
Pesquisa na web

O Plugin MiniMax também registra web_search por meio da API de pesquisa do MiniMax Token Plan.
  • ID do provedor: minimax
  • Resultados estruturados: títulos, URLs, trechos, consultas relacionadas
  • Variável de ambiente preferida: MINIMAX_CODE_PLAN_KEY
  • Aliases de ambiente aceitos: MINIMAX_CODING_API_KEY, MINIMAX_OAUTH_TOKEN
  • Fallback de compatibilidade: MINIMAX_API_KEY quando ela já aponta para uma credencial token-plan
  • Reutilização de região: plugins.entries.minimax.config.webSearch.region, depois MINIMAX_API_HOST, depois URLs base do provedor MiniMax
  • A pesquisa permanece no ID de provedor minimax; a configuração OAuth CN/global pode direcionar a região indiretamente por meio de models.providers.minimax-portal.baseUrl e pode fornecer autenticação bearer por meio de MINIMAX_OAUTH_TOKEN
A configuração fica em plugins.entries.minimax.config.webSearch.*.
Consulte Pesquisa MiniMax para configuração e uso completos da pesquisa na web.

​
Configuração avançada

OpçãoDescrição
models.providers.minimax.baseUrlPrefira https://api.minimax.io/anthropic (compatível com Anthropic); https://api.minimax.io/v1 é opcional para payloads compatíveis com OpenAI
models.providers.minimax.apiPrefira anthropic-messages; openai-completions é opcional para payloads compatíveis com OpenAI
models.providers.minimax.apiKeyChave de API do MiniMax (MINIMAX_API_KEY)
models.providers.minimax.modelsDefina id, name, reasoning, contextWindow, maxTokens, cost
agents.defaults.modelsCrie aliases para modelos que você quer na allowlist
models.modeMantenha merge se quiser adicionar MiniMax junto aos integrados
Em api: "anthropic-messages", o OpenClaw injeta thinking: { type: "disabled" }, a menos que thinking já esteja explicitamente definido em params/config.Isso impede que o endpoint de streaming do MiniMax emita reasoning_content em chunks delta no estilo OpenAI, o que vazaria raciocínio interno para a saída visível.
/fast on ou params.fastMode: true reescreve MiniMax-M2.7 para MiniMax-M2.7-highspeed no caminho de stream compatível com Anthropic.
Melhor para: manter seu modelo de última geração mais forte como primário e fazer failover para MiniMax M2.7. O exemplo abaixo usa Opus como primário concreto; troque pelo seu modelo primário de última geração preferido.
{
  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 de uso do Coding Plan: https://api.minimaxi.com/v1/token_plan/remains ou https://api.minimax.io/v1/token_plan/remains (requer uma chave de coding plan).
  • A sondagem de uso deriva o host de models.providers.minimax-portal.baseUrl ou models.providers.minimax.baseUrl quando configurado, então configurações globais usando https://api.minimax.io/anthropic sondam api.minimax.io. URLs base ausentes ou malformadas mantêm o fallback CN para compatibilidade.
  • O OpenClaw normaliza o uso do coding-plan do MiniMax para a mesma exibição de % restante usada por outros provedores. Os campos brutos usage_percent / usagePercent do MiniMax são cota restante, não cota consumida, então o OpenClaw os inverte. Campos baseados em contagem vencem quando presentes.
  • Quando a API retorna model_remains, o OpenClaw prefere a entrada de modelo de chat, deriva o rótulo da janela de start_time / end_time quando necessário e inclui o nome do modelo selecionado no rótulo do plano para que as janelas de coding-plan fiquem mais fáceis de distinguir.
  • Snapshots de uso tratam minimax, minimax-cn e minimax-portal como a mesma superfície de cota do MiniMax, e preferem OAuth MiniMax armazenado antes de recorrer a variáveis de ambiente de chave do Coding Plan.

​
Observações

  • Refs de modelo seguem o caminho de autenticação:
    • Configuração por chave de API: minimax/<model>
    • Configuração OAuth: minimax-portal/<model>
  • Modelo de chat padrão: MiniMax-M2.7
  • Modelo de chat alternativo: MiniMax-M2.7-highspeed
  • Onboarding e configuração direta por chave de API gravam definições de modelo somente texto para ambas as variantes M2.7
  • A compreensão de imagem usa o provedor de mídia MiniMax-VL-01 pertencente ao Plugin
  • Atualize os valores de preço em models.json se precisar de rastreamento de custo exato
  • Use openclaw models list para confirmar o ID de provedor atual, depois alterne com openclaw models set minimax/MiniMax-M2.7 ou openclaw models set minimax-portal/MiniMax-M2.7
Link de indicação para o MiniMax Coding Plan (10% de desconto): MiniMax Coding Plan
Consulte Provedores de modelo para regras de provedor.

​
Solução de problemas

Isso geralmente significa que o provedor MiniMax não está configurado (nenhuma entrada de provedor correspondente e nenhum perfil de autenticação/chave de ambiente do MiniMax encontrado). Uma correção para essa detecção está em 2026.1.12. Corrija assim:
  • Atualize para 2026.1.12 (ou execute a partir do código-fonte main) e reinicie o Gateway.
  • Execute openclaw configure e selecione uma opção de autenticação MiniMax, ou
  • Adicione manualmente o bloco models.providers.minimax ou models.providers.minimax-portal correspondente, ou
  • Defina MINIMAX_API_KEY, MINIMAX_OAUTH_TOKEN ou um perfil de autenticação MiniMax para que o provedor correspondente possa ser injetado.
Garanta que o ID do modelo diferencie maiúsculas de minúsculas:
  • Caminho por chave de API: minimax/MiniMax-M2.7 ou minimax/MiniMax-M2.7-highspeed
  • Caminho OAuth: minimax-portal/MiniMax-M2.7 ou minimax-portal/MiniMax-M2.7-highspeed
Depois verifique novamente com:
openclaw models list
Mais ajuda: Solução de problemas e FAQ.

​
Relacionados

Seleção de modelo

Escolher provedores, refs de modelo e comportamento de failover.

Geração de imagem

Parâmetros compartilhados de ferramenta de imagem e seleção de provedor.

Geração de música

Parâmetros compartilhados de ferramenta de música e seleção de provedor.

Geração de vídeo

Parâmetros compartilhados de ferramenta de vídeo e seleção de provedor.

Pesquisa MiniMax

Configuração de pesquisa na web via MiniMax Token Plan.

Solução de problemas

Solução de problemas geral e FAQ.