Integración con MiniMax: serie M3 y Coding Plan
La integración de OpenClaw con MiniMax es la quinta parada de la página dedicada a modelos nacionales. MiniMax es algo especial dentro de OpenClaw: su complemento oficial viene integrado (bundled, se instala junto con OpenClaw y se activa con un solo comando, openclaw plugins enable minimax), pero la autenticación se divide en dos rutas: la API Key de pago por uso va por minimax, y el Coding Plan por suscripción va por el minimax-portal de OAuth. Los tres pasos de las lecciones anteriores——DeepSeek, Qwen, GLM, Kimi——「instalar el complemento → configurar las credenciales → elegir el modelo」se aplican por completo en esta lección; solo que al principio se añade una pregunta de opción: 「elegir la ruta」. Todo el proceso toma unos 8 minutos (el registro en MiniMax se cuenta aparte).
Primero, una tabla resumen; toda la configuración de esta lección parte de ella (propiedades y valores tomados textualmente de la documentación oficial):
| Ruta A: API Key (pago por uso) | Ruta B: OAuth (Coding Plan) | |
|---|---|---|
| Para quién | Usuarios de API de pago por uso (pay-as-you-go) | Suscriptores de MiniMax Coding Plan |
| Provider id | minimax | minimax-portal |
| Método de autenticación | API Key (MINIMAX_API_KEY) | Inicio de sesión OAuth (flujo user-code) |
| Endpoint del sitio internacional | https://api.minimax.io/anthropic (compatible con Anthropic) | api.minimax.io |
| Endpoint del sitio chino | https://api.minimaxi.com/anthropic (compatible con Anthropic) | api.minimaxi.com |
| auth-choice (sitio internacional) | minimax-global-api | minimax-global-oauth |
| auth-choice (sitio chino) | minimax-cn-api | minimax-cn-oauth |
| Prefijo de referencia del modelo | minimax/... | minimax-portal/... |
| Modelo predeterminado | MiniMax-M3 | MiniMax-M3 |
| Capacidades adicionales | Texto + generación de imágenes/música/vídeo + comprensión de imágenes + voz + búsqueda web | Texto + generación de imágenes/música/vídeo + comprensión de imágenes + voz (sin búsqueda web) |
Una cosa que debes recordar primero: las dos rutas tienen provider id distintos, por lo que las referencias a los modelos también difieren——en la ruta de API Key se escribe minimax/MiniMax-M3, en la ruta OAuth se escribe minimax-portal/MiniMax-M3, y además el ID del modelo distingue mayúsculas y minúsculas. Si en la configuración escribes minimax/minimax-m3, una variante en minúsculas, OpenClaw no la reconoce.
Cómo elegir, en tres frases:
| Tu situación | Elige esto |
|---|---|
| Pago por uso, quieres el paquete completo de M3 / M3.1-Flash y además búsqueda web | Ruta de API Key (minimax, las seis capacidades activadas) |
| Suscrito a MiniMax Coding Plan, principalmente para escribir código | Ruta OAuth (minimax-portal, uso dentro de la cuota de la suscripción) |
| Quieres usar ambas rutas | Configura ambas——los provider id son distintos y no se sobrescriben entre sí |
💡 Para quienes llegan buscando 「MiniMax M3」 o 「MiniMax Coding Plan」
M3 es el modelo insignia de razonamiento que MiniMax usa actualmente por defecto, y Coding Plan es su suscripción. Para conectarlo con OpenClaw no hace falta una cuenta de la app de MiniMax, sino un inicio de sesión OAuth (usuarios de suscripción) o una API Key (usuarios de pago por uso); esta página explica con claridad ambos caminos.
Este tutorial se basa en OpenClaw v2026.10.9.
Qué podrás hacer al terminar
- Distinguir las dos rutas de autenticación
minimaxyminimax-portal: la API Key de pago por uso va por la primera, el OAuth del Coding Plan por la segunda, sin mezclarlas - Activar el plugin integrado de MiniMax y completar el onboarding con los cuatro auth-choice (internacional/China × API/OAuth)
- Entender el catálogo de modelos: el posicionamiento, contexto y valores por defecto de
MiniMax-M3,MiniMax-M3.1-FlashyMiniMax-M2.7 - Evitar los obstáculos propios de MiniMax: los ID de modelo distinguen mayúsculas y minúsculas, M3.1-Flash devuelve 400 al desactivar el razonamiento, y M2.x sigue filtrando texto de razonamiento aunque lo desactives
- Aprovechar las seis capacidades en una de MiniMax: generación de imágenes, música, vídeo Hailuo, voz TTS, comprensión de imágenes y búsqueda web
🎒 Preparativos antes de empezar
- Has completado Conexión de modelos: panorama general del sistema de providers y cambio de modelo: tienes claro el proceso de tres pasos «provider → autenticación → elegir modelo» y las reglas de referencia
provider/model - OpenClaw está instalado y el Gateway está en ejecución:
openclaw gateway statusproduce salida - Sabes si vas a pagar por uso (API Key) o a suscribirte al Coding Plan (OAuth); esto determina qué ruta tomar
- Si optas por un despliegue en servidor / demonio, sabes dónde está
~/.openclaw/.env: la Key terminará viviendo ahí
Hazlo conmigo
Paso 1: confirmar la ruta y activar el plugin de MiniMax
Por qué: el plugin de MiniMax es bundled (viene integrado con OpenClaw), así que no hay que hacer plugins install como con DeepSeek o Kimi; basta con habilitarlo con openclaw plugins enable minimax y reiniciar el Gateway.
# 1. 启用内置的 MiniMax 插件
openclaw plugins enable minimax
# 2. 重启 Gateway 让插件生效
openclaw gateway restartDeberías ver: el mensaje de que el plugin se habilitó con éxito y que el Gateway arranca sin errores tras el reinicio.
Una vez habilitado, primero responde la pregunta de la ruta (el criterio recomendado de la documentación oficial):
| Tu situación | Ruta | auth-choice |
|---|---|---|
| API de pago por uso, estás en el extranjero o usas el sitio internacional | A: API Key (internacional) | minimax-global-api |
| API de pago por uso, usas el sitio de China | A: API Key (China) | minimax-cn-api |
| Suscripción al Coding Plan, cuenta del sitio internacional | B: OAuth (internacional) | minimax-global-oauth |
| Suscripción al Coding Plan, cuenta del sitio de China | B: OAuth (China) | minimax-cn-oauth |
Nota para usuarios de China continental: el endpoint del sitio chino es api.minimaxi.com (con una i de más) y el del sitio internacional es api.minimax.io; cada sitio corresponde a un auth-choice distinto, así que elige según el sitio de tu cuenta y no los mezcles.
openclaw plugins enable minimaxse ejecutó con éxito y el Gateway se ha reiniciado
Paso 2: conectar OpenClaw con MiniMax: configurar la autenticación
Por qué: las credenciales de las dos rutas son completamente distintas: la API Key es una cadena de caracteres, mientras que OAuth es un inicio de sesión con user-code en el navegador; el id del provider también depende de la ruta (minimax vs minimax-portal), y si configuras la ruta equivocada la Key no coincidirá.
Ruta A: API Key (pago por uso)
Primero ve a la plataforma abierta de MiniMax, crea una API Key, cópiala y guárdala bien. Luego ejecuta el onboarding:
# 国际站
openclaw onboard --auth-choice minimax-global-api
# 中国站
openclaw onboard --auth-choice minimax-cn-apiDeberías ver: la Key se valida y se guarda; la base URL de la ruta del sitio internacional queda en https://api.minimax.io/anthropic y la del sitio chino en https://api.minimaxi.com/anthropic (ambas, endpoints compatibles con Anthropic).
De paso, verifica el catálogo:
openclaw models list --provider minimaxDeberías ver: la familia de modelos MiniMax-M3, MiniMax-M3.1-Flash y MiniMax-M2.7 en la lista.
Ruta B: OAuth (suscripción Coding Plan)
Quienes tienen suscripción al Coding Plan no usan API Key, sino inicio de sesión OAuth (flujo user-code: te da un código para confirmar en el navegador):
# 国际站
openclaw onboard --auth-choice minimax-global-oauth
# 中国站
openclaw onboard --auth-choice minimax-cn-oauthDeberías ver: la terminal muestra la guía de inicio de sesión, y tras completar la autorización en el navegador las credenciales se guardan; la base URL del provider queda en api.minimax.io (internacional) o api.minimaxi.com (China).
También puedes usar directamente el comando de inicio de sesión auth (la forma que indica el README del plugin oficial; --set-default de paso fija también el modelo por defecto):
openclaw models auth login --provider minimax-portal --set-defaultDe paso, verifica el catálogo:
openclaw models list --provider minimax-portalDeberías ver: el catálogo de modelos con el prefijo minimax-portal/ en la lista.
Un comportamiento propio de OAuth que conviene conocer de antemano: OpenClaw refresca automáticamente el token, al expirar, en el endpoint regional que lo emitió originalmente. Hay dos situaciones en las que se niega a refrescar y te pide volver a iniciar sesión: cuando el inicio de sesión guardado es anterior al soporte de refresco (no se registró la región), o cuando cambiaste models.providers.minimax-portal.baseUrl a otra región. Si aparece el aviso, vuelve a ejecutar openclaw models auth login --provider minimax-portal una vez.
Configuración manual (si no quieres ejecutar el onboarding)
El plugin oficial en principio no necesita que escribas entradas en models.providers: basta con habilitar el plugin, configurar el auth y elegir el modelo; solo se escribe si quieres fijar explícitamente el endpoint o la definición de modelos. Ejemplo oficial de la ruta con API Key (extracto literal):
{
env: { vars: { 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"],
compat: { codeMode: "preferred" },
cost: { input: 0.6, output: 2.4, cacheRead: 0.12, cacheWrite: 0 },
contextWindow: 1000000,
maxTokens: 131072,
},
// ...
],
},
},
},
}Tres puntos clave (la documentación oficial lo indica con claridad):
- Se prefiere
baseUrlcompatible con Anthropic enhttps://api.minimax.io/anthropic, conapiacompañado deanthropic-messages; la opción compatible con OpenAI,https://api.minimax.io/v1+openai-completions, es opcional models.mode: "merge"hace que el catálogo de MiniMax coexista con el catálogo integrado, sin eliminar tus providers existentes- Tanto el onboarding como la configuración directa de la API Key escriben las definiciones de modelos de M3 y de las dos variantes M2.7
Dónde poner la Key: en un shell interactivo con export MINIMAX_API_KEY="<你的 API Key>", o escrita en ~/.openclaw/.env (en un despliegue como demonio hay que pasar por aquí, ver la advertencia de abajo). La familia de variables de entorno de la ruta OAuth / Token Plan es MINIMAX_OAUTH_TOKEN, MINIMAX_CODE_PLAN_KEY, MINIMAX_CODING_API_KEY.
⚠️ ¿El Gateway corre como demonio? No pongas la Key en el shell interactivo
Cuando el Gateway se ejecuta como servicio de launchd / systemd, no ve las variables de entorno que export en tu terminal. Escribe MINIMAX_API_KEY en ~/.openclaw/.env, o provéelo a ese proceso mediante env.shellEnv de la configuración.
- En el resumen de credenciales de
openclaw models statuspuedes ver el origen de las credenciales de tu ruta
Paso 3: elegir un modelo de MiniMax y verificar
Por qué: el modelo predeterminado de ambas rutas es MiniMax-M3, suficiente para uso directo; pero M3.1-Flash tiene contexto de 1M + nivel de razonamiento ajustable, y M2.7 es más barato — echar un vistazo al catálogo antes de decidir no sale caro.
Primero mira el catálogo integrado (documentación oficial + ejemplos de configuración organizados tal cual):
| Referencia de modelo (ruta API Key) | Tipo | Entrada | Contexto | Salida máxima | Notas |
|---|---|---|---|---|---|
minimax/MiniMax-M3 | Razonamiento | Texto, imágenes | 1,000,000 | 131,072 | Predeterminado, hosted reasoning |
minimax/MiniMax-M3.1-Flash | Razonamiento | Texto, imágenes | 1,000,000 | 131,072 | Effort ajustable; $0.15 / $0.60 / $0.015 por M |
minimax/MiniMax-M3.1-Flash-Preview | Razonamiento | Texto, imágenes | 1,000,000 | 131,072 | ID antiguo, conservado solo para configuraciones existentes |
minimax/MiniMax-M2.7 | Razonamiento | Texto | 204,800 | 131,072 | Hosted reasoning de la generación anterior |
minimax/MiniMax-M2.7-highspeed | Razonamiento | Texto | 204,800 | 131,072 | Modo de alta velocidad de M2.7 |
minimax/MiniMax-VL-01 | Comprensión de imágenes | — | — | — | Ver capacidades exclusivas más abajo |
minimax/image-01 | Generación de imágenes | — | — | — | Texto a imagen + edición de imagen a imagen |
minimax/music-2.6 | Generación de música | — | — | — | Modelo de música predeterminado |
minimax/MiniMax-Hailuo-2.3 | Generación de vídeo | — | — | — | Texto a vídeo + imagen a vídeo |
La ruta OAuth cambia el prefijo a minimax-portal/, el catálogo de modelos de chat es el mismo; pero la capacidad de búsqueda web solo está registrada en la ruta API Key (minimax).
Dos comportamientos del catálogo que conviene conocer de antemano:
MiniMax-M3.1-Flashfunciona con API Key de pago por uso, Token Plan y MiniMax Code; el campo cost del Token Plan deMiniMax-M3.1-Flash-Previewes 0, no significa que sea gratis (nunca se publicó un precio Preview por token), y el proveedor puede retirarlo en cualquier momento — para configuraciones nuevas elige siempreMiniMax-M3.1-Flash- M3 y M3.1-Flash son en ambas rutas los modelos preferidos de Code Mode (
compat.codeMode: "preferred"); sin un Code Mode global configurado, el modo automático puede activarlos, y la configuración explícita sigue teniendo prioridad
Cómo elegir, en cuatro frases:
| Tu necesidad | Elige este | Fundamento |
|---|---|---|
| Tareas generales, sin complicarse | MiniMax-M3 | Modelo predeterminado de ambas rutas, 1M de contexto |
| Contexto largo + ajustar tú mismo el nivel de razonamiento | MiniMax-M3.1-Flash | 1M de contexto, /think con cinco niveles ajustables |
| Quieres ahorrar / tener un respaldo | MiniMax-M2.7 | Precio de catálogo $0.3 / $1.2 por M, la mitad que M3 |
| M2.7 pero más rápido | MiniMax-M2.7-highspeed | /fast on cambia a él automáticamente |
Cambiar el modelo predeterminado (ten en cuenta que el prefijo sigue a la ruta):
# API Key 路线
openclaw models set minimax/MiniMax-M3
# OAuth 路线
openclaw models set minimax-portal/MiniMax-M3También puedes cambiarlo temporalmente en el chat: /model minimax/MiniMax-M3.1-Flash solo afecta a la sesión actual; la familia de comandos se detalla en Guía rápida de comandos de chat.
Por último, verifica. Envía un mensaje de prueba:
openclaw dashboardAbre la Control UI y escribe en el cuadro de chat «preséntate en una frase».
Deberías ver: el modelo responde con normalidad, sin errores de credenciales faltantes ni de modelo inexistente. Con esto, la conexión de OpenClaw a MiniMax queda funcionando.
El precio en una frase, según la ruta:
- La ruta API Key se factura por uso, con la estimación del catálogo integrado (por millón de tokens): M3 a $0.6 de entrada / $2.4 de salida / $0.12 de lectura de caché; M3.1-Flash al precio publicado por MiniMax de $0.15 / $0.60 / $0.015; M2.7 a $0.3 / $1.2 / $0.06 / $0.375 de escritura de caché
- La ruta OAuth consume la cuota de la suscripción Coding Plan, sin facturación por token; el precio de la suscripción se rige por el sitio oficial de MiniMax
- El mensaje de prueba recibió respuesta, y el provider y el modelo coinciden (
minimax/...ominimax-portal/...)
Punto de control ✅
- El plugin de MiniMax está habilitado (bundled,
openclaw plugins enable minimax+ reiniciar el Gateway) - La ruta usada va acorde con las credenciales: Key de pago por uso →
minimax; Coding Plan OAuth →minimax-portal openclaw models list --provider minimax(o--provider minimax-portal) lista el catálogo- El prefijo del modelo predeterminado es correcto:
minimax/MiniMax-M3ominimax-portal/MiniMax-M3, sin errores de mayúsculas o minúsculas - El mensaje de prueba recibió respuesta, y no se emparejó la referencia
minimax/con la ruta OAuth (o viceversa)
Recordatorio de errores comunes
❌ Error "Unknown model: minimax/MiniMax-M3"
Síntoma: al cambiar de modelo o enviar un mensaje, se reporta un modelo desconocido.
Causa: según la documentación oficial de resolución de problemas, esto normalmente significa que el provider de MiniMax no está configurado: no hay ninguna entrada de provider que coincida ni se encuentran credenciales de MiniMax.
Solución correcta, una de estas tres opciones:
- Ejecutar
openclaw configurey elegir una opción de MiniMax en Model/auth (están los cuatro auth-choice) - Añadir manualmente el bloque de configuración
models.providers.minimax(omodels.providers.minimax-portal) - Configurar
MINIMAX_API_KEY,MINIMAX_OAUTH_TOKENo un perfil de autenticación de MiniMax, para que el plugin pueda inyectar el provider
Luego verificar con openclaw models list.
❌ ID de modelo escrito con mayúsculas/minúsculas incorrectas
Síntoma: aunque la configuración incluye claramente el modelo, sigue reportando modelo desconocido.
Causa: el ID de modelo de MiniMax distingue mayúsculas de minúsculas. La forma correcta es MiniMax-M3, MiniMax-M2.7, MiniMax-M2.7-highspeed; minimax-m3 y MINIMAX-M3 no funcionan.
Solución correcta: copiar tal cual la escritura de la tabla de directorio de esta página; el prefijo sigue la ruta de autenticación (minimax/ o minimax-portal/).
❌ /think off devuelve HTTP 400 en M3.1-Flash
Causa: MiniMax-M3.1-Flash (incluido el ID antiguo MiniMax-M3.1-Flash-Preview) requiere adaptive thinking: MiniMax rechaza disabled thinking y devuelve directamente HTTP 400. Por eso OpenClaw no ofrece para este modelo el nivel off, y /think solo expone cinco niveles: low / medium / high / xhigh / max, con max por defecto.
Solución correcta: no desactivar el razonamiento en M3.1-Flash; si de verdad se quiere desactivar, cambiar a MiniMax-M3 (dos niveles: off / adaptive) o a la serie M2.x.
❌ Se desactivó el razonamiento en M2.7, pero aún se cuela texto de razonamiento en las respuestas
Causa: el Warning oficial lo deja claro: M2.x en la ruta compatible con Anthropic puede emitir reasoning_content como delta de streaming estilo OpenAI, exponiendo el razonamiento en la salida visible. OpenClaw envía por defecto thinking: { type: "disabled" }, pero la documentación de MiniMax dice que M2.x acepta e ignora este ajuste: el razonamiento se ejecuta igual y se filtra igual.
Solución correcta: si te importa una salida limpia, no uses M2.x con el razonamiento desactivado a la fuerza; cambia a M3 (adaptive por defecto; OpenClaw elimina para M3 el valor implícito disabled por defecto).
❌ El refresh del token OAuth es rechazado y te pide iniciar sesión de nuevo
Causa: dos casos posibles: el inicio de sesión guardado es anterior al soporte de refresh (no se registró la región de emisión), o models.providers.minimax-portal.baseUrl se cambió a otra región (internacional ↔ China), y OpenClaw rechaza el refresh entre regiones.
Solución correcta: volver a ejecutar openclaw models auth login --provider minimax-portal según las instrucciones; no cambiar manualmente el baseUrl a otra región.
❌ Tras instalar el Gateway como daemon, la Key exportada «no surte efecto»
Causa: los servicios de launchd / systemd no ven las variables de entorno del shell interactivo; la documentación de cada provider lo recalca repetidamente.
Solución correcta: escribir MINIMAX_API_KEY en ~/.openclaw/.env, o proporcionarlo mediante env.shellEnv en la configuración; reiniciar el servicio del Gateway tras cambiar la Key.
❌ Se configuró baseUrl, pero la generación de imágenes no lo usa
Causa: la generación de imágenes usa fijamente el endpoint de imágenes exclusivo de MiniMax (/v1/image_generation) e ignora models.providers.minimax.baseUrl; ese campo solo afecta a las rutas de chat / compatibilidad con Anthropic.
Solución correcta: para que la generación de imágenes use el sitio de China, establecer MINIMAX_API_HOST=https://api.minimaxi.com (por defecto es el sitio internacional https://api.minimax.io).
🔧 Capacidades exclusivas de MiniMax (opcional)
El plugin de MiniMax no se limita al chat: en un solo registro incluye dos providers de chat + seis capacidades: generación de imágenes, generación de música, generación de video, comprensión de imágenes, voz (T2A v2) y búsqueda web. Es decir, configurando este único proveedor, las imágenes, la música, la voz, los videos y la búsqueda en línea de Claw pueden pasar por MiniMax.
Resumen de capacidades: imágenes, música, video, voz, comprensión de imágenes, búsqueda web
| Capacidad | Modelo | Referencia por defecto (ruta API Key) | Notas |
|---|---|---|---|
| Generación de imágenes | image-01 | minimax/image-01 | Texto a imagen + edición de imagen a imagen; máximo 9 imágenes por solicitud; relaciones de aspecto 1:1 / 16:9 / 4:3 / 3:2 / 2:3 / 3:4 / 9:16 / 21:9 |
| Generación de música | music-2.6 | minimax/music-2.6 | También hay music-2.6-free, music-cover, music-cover-free; salida en mp3 |
| Generación de video | MiniMax-Hailuo-2.3 | minimax/MiniMax-Hailuo-2.3 | También hay Hailuo-2.3-Fast, Hailuo-02 y las series I2V-01; resolución 768P / 1080P; no admite aspectRatio |
| Voz (TTS) | speech-2.8-hd | — | T2A v2; voz por defecto English_expressive_narrator |
| Comprensión de imágenes | MiniMax-VL-01 | — | La extracción de texto de PDF usa MiniMax-M2.7 |
| Búsqueda web | — | provider minimax | usa la API de búsqueda del Token Plan (/v1/coding_plan/search); solo ruta API Key |
Establecer una capacidad como modelo multimedia por defecto (ejemplo oficial tal cual, tomando imágenes como ejemplo):
{
agents: {
defaults: {
mediaModels: { image: { primary: "minimax/image-01" } },
},
},
}Lo mismo aplica a música y video: mediaModels: { music: { primary: "minimax/music-2.6" } }, mediaModels: { video: { primary: "minimax/MiniMax-Hailuo-2.3" } } (en la ruta OAuth el prefijo cambia a minimax-portal/).
Tres detalles:
- La búsqueda web solo está disponible en
minimax(ruta API Key): elminimax-portalde OAuth no tiene esta capacidad. Para la búsqueda, la variable de entorno preferida esMINIMAX_CODE_PLAN_KEY, y también se aceptanMINIMAX_CODING_API_KEYyMINIMAX_OAUTH_TOKEN; la configuración está enplugins.entries.minimax.config.webSearch.* - La autenticación de TTS tiene un orden de prioridad:
tts.providers.minimax.apiKey→ OAuth/token deminimax-portal→ variable de entorno del Token Plan →MINIMAX_API_KEY; cuando no se configura un host de TTS, se reutiliza el host de OAuth y se eliminan sufijos como/anthropic - Transcodificación de mensajes de voz: en canales que requieren notas de voz (voice note), como Feishu o Telegram, OpenClaw usa
ffmpegpara convertir el MP3 de MiniMax en Opus de 48 kHz (la API de archivos de Feishu solo aceptafile_type: "opus")
Para usos prácticos de imágenes y voz, consulta Imágenes y voz: añadir imágenes al contenido y convertir artículos en voz; para el uso de la herramienta de búsqueda web, consulta Control del navegador: deja que Claw navegue por ti.
Niveles de /think y referencia rápida de /fast
| Familia de modelos | Niveles de /think | Predeterminado |
|---|---|---|
MiniMax-M3 | off / adaptive | adaptive |
MiniMax-M3.1-Flash | low / medium / high / xhigh / max | max (no se ofrece off; si se desactiva, da 400) |
MiniMax-M2.x | off / minimal / low / medium / high | off (pero el upstream acepta disabled y lo ignora) |
/fast on (o params.fastMode: true) reescribe MiniMax-M2.7 como MiniMax-M2.7-highspeed: solo surte efecto en la ruta compatible con Anthropic.
Consulta de uso del Coding Plan
Los usuarios de suscripción que quieran saber cuánta cuota les queda: OpenClaw consulta periódicamente la API de uso de MiniMax (https://api.minimaxi.com/v1/token_plan/remains o https://api.minimax.io/v1/token_plan/remains, requiere la clave del coding plan) y normaliza el uso para mostrarlo como «porcentaje restante», igual que con los demás proveedores.
Dos detalles:
- Los campos originales de MiniMax
usage_percent/usagePercentrepresentan la cuota restante, no la consumida; OpenClaw los invierte antes de mostrarlos; si existe un campo de conteo por usos, este tiene prioridad - La instantánea de uso considera
minimax,minimax-cn,minimax-portalyminimax-portal-cncomo la misma cara de cuota, priorizando el OAuth almacenado y recurriendo a la variable de entorno de la clave del Coding Plan
avanzado: configurar MiniMax como modelo de respaldo
Ejemplo oficial (tal cual): el modelo principal usa el más potente y, en caso de fallo, recurre a M2.7:
{
env: { vars: { 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"],
},
},
},
}El Opus del ejemplo es solo un marcador de posición; sustitúyelo por tu propio modelo principal.
Siguiente paso
Con esto se completa la integración de OpenClaw con MiniMax. Continúa en la página de modelos nacionales:
- Siguiente lección Integrar Doubao/Volcengine: endpoint Ark y Coding Plan: otro proveedor nacional con doble ruta de «pago por uso + Coding Plan»
- Las demás páginas de modelos (Hunyuan/Qianfan, relés y modelos locales) se acceden desde el plan de estudios de Resumen de conexión de modelos
- ¿Modelos configurados? Para el uso diario, empieza en Uso diario: convive eficientemente con tu Claw: Control UI, comandos de chat y sistema de memoria están todos en ese capítulo