🤖HermesBlog
Guías Prácticas de Hermes · Parte 298/9/2026

Integración OAuth de MiniMax

Integración OAuth de MiniMax — guía fácil de entender basada en la documentación oficial

Piensa en las claves de API como en una llave de casa: funcionan, pero tienes que llevarlas contigo, y si pierdes una, te quedas fuera. OAuth es más como una tarjeta magnética de hotel: es temporal, está vinculada a tu identidad y se puede reemitir en cualquier momento. Para los usuarios de MiniMax, eso es exactamente lo que Hermes Agent ofrece ahora.

guide-minimax-oauth

¿Qué hay de nuevo?

Hermes Agent ha añadido soporte OAuth para MiniMax, lo que significa que ahora puedes iniciar sesión con tu cuenta de MiniMax en lugar de tener que gestionar una clave de API. Esto es especialmente útil si eres un usuario habitual de MiniMax que busca una conexión más segura y basada en sesiones. ¿La mejor parte? Funciona tanto con el endpoint global como con el endpoint de China.

¿Por qué usar OAuth en lugar de una clave de API?

  • Sin gestión de claves – Se acabó copiar, pegar o preocuparse por fugas de claves en archivos .env.
  • Renovación automática – Los tokens de OAuth caducan y se renuevan automáticamente, así que no tienes que rotar las claves manualmente.
  • Las mismas herramientas, el mismo poder – Sigues teniendo acceso a todos los modelos de MiniMax, como MiniMax-M2.7, con la misma calidad.

Cómo configurarlo

Primero, asegúrate de tener Hermes Agent instalado y actualizado. Luego, añade tus credenciales OAuth de MiniMax:

hermes auth add minimax-oauth

Esto abrirá una ventana del navegador donde iniciarás sesión en tu cuenta de MiniMax y concederás el acceso. Una vez hecho esto, ya estás listo para chatear.

Usar MiniMax con OAuth

Ahora, en lugar de configurar MINIMAX_API_KEY en ~/.hermes/.env, simplemente puedes ejecutar:

hermes chat --provider minimax --model MiniMax-M2.7

Para usuarios en China, usa el endpoint dedicado:

hermes chat --provider minimax-cn --model MiniMax-M2.7

Hermes detecta automáticamente que estás usando OAuth y se salta la verificación de la clave de API.

¿Y el endpoint de China?

Si estás en el endpoint de China, el flujo de OAuth es el mismo. Solo asegúrate de seleccionar MiniMax (China) al añadir la autenticación:

hermes auth add minimax-cn-oauth

Luego usa --provider minimax-cn como siempre.

Algunas cosas a tener en cuenta

  • Los tokens de OAuth se almacenan de forma segura en tu configuración de Hermes, no en archivos .env en texto plano.
  • Si tu token caduca, Hermes te pedirá que te vuelvas a autenticar—sin necesidad de entrar en pánico.
  • Puedes seguir usando claves de API si lo prefieres; OAuth es solo una opción adicional.

Resumen

La integración de OAuth de MiniMax en Hermes Agent es como pasar de una llave física a una cerradura inteligente. Es más segura, más cómoda y elimina la molestia de gestionar claves. Ya sea que estés en el endpoint global o en el de China, ahora puedes chatear con los modelos de MiniMax en cuestión de segundos.

Consejo práctico: Si estás probando varios modelos de MiniMax, configura tu proveedor de forma permanente en config.yaml:

model:
  provider: "minimax"
  default: "MiniMax-M2.7"

Luego puedes simplemente ejecutar hermes chat sin ninguna bandera. ¡Feliz creación!


📖 Documentación oficial

Este artículo se basa en la documentación oficial de Hermes Agent :Docs oficiales › guides/minimax-oauth