Ajustes principales
Requisitos previos
- La versión actual de la herramienta está instalada
- Una BetterToken API Key: regístrate y obtén una
- Un ID de modelo de la model plaza
Requisitos adicionales
- El ID de modelo seleccionado procede del proveedor compatible
- macOS, Linux, or Windows WSL2
Instalación
Instala Hermes Agent
- macOS / Linux / WSL2
- Windows
Referencia rápida de funciones
Configuración manual
Usa como método principal la configuración interactiva de modelos de Hermes Agent. Los comandos y las variables de entorno siguen disponibles como alternativas.Pasos de configuración
- Configuración interactiva
- Configuración por CLI
- Variables de entorno
1
Ejecuta el selector de modelos
2
Elige el proveedor OpenAI u OpenAI Compatible
Selecciona OpenAI u OpenAI Compatible en la lista de proveedores.
3
Completa la configuración de BetterToken
Introduce:
- Base URL:
https://www.bettertoken.ai/v1 - API Key: tu BetterToken API Key
- Model: un ID de modelo de un proveedor compatible copiado desde la model plaza
4
Reinicia Hermes Agent
Después de actualizar la configuración, cierra la sesión actual de Hermes Agent e inicia otra.
5
Inicia Hermes Agent
Migra desde OpenClaw
Si ya usas OpenClaw, comprueba primero si tu versión actual de Hermes Agent incluye el comando de migración. Ejecuta un dry run antes de cambiar nada.https://www.bettertoken.ai/v1, tu BetterToken API Key y un ID de modelo de un proveedor compatible.
Verifica la conexión
Envía un prompt de prueba breve. Si la herramienta responde sin errores de autenticación ni de ID del modelo, la conexión funciona. Reinicia por completo la herramienta después de cambiar la configuración.Cambia de modelo
Abre el selector de modelos o cambia el campoModel de la configuración. Usa el ID de modelo exacto de la model plaza y reinicia la sesión actual.
Errores habituales
Solución de problemas
- Si las solicitudes fallan o no responden, confirma que Base URL sea exactamente
https://www.bettertoken.ai/v1. No añadas/chat/completionsen este campo. - Si Hermes indica que el modelo no existe, confirma que Model sea un ID de modelo de un proveedor compatible de la model plaza.
- Si falla la autenticación, busca espacios copiados y confirma que el ID seleccionado proceda del proveedor compatible.
- Si Hermes sigue usando el modelo antiguo después de un cambio, cierra la sesión actual de Hermes Agent y vuelve a ejecutar
hermes. - BetterToken normalmente no requiere un
User-Agentadicional ni cabeceras personalizadas. Añade cabeceras solo cuando tu gateway personalizado, el enrutamiento por tenant, la observabilidad o la capa de caché las exijan explícitamente.
No incluyas API Keys reales en los commits del repositorio. Para configuraciones compartidas por un equipo, usa preferentemente variables de entorno o configuración local.
Preguntas relacionadas
- MCP frente a API Key y Base URL
- ¿Qué son model_provider, base_url y wire_api?
- Cómo configurar una API compatible con OpenAI en Cline
- Guía para configurar BetterToken en OpenClaw
Configuración avanzada
Proveedores compatibles
Los estados se aplican al método de configuración de BetterToken descrito en esta página.
Qué significa cada método de configuración
Qué significa cada método de configuración
- Configuración manual: introduce la API Key, la Base URL y el Model.
- No compatible: todavía no hay un método de conexión directa verificado.
Detalles técnicos
Protocolo, endpoint y campos internos del proveedor
Protocolo, endpoint y campos internos del proveedor
Esta configuración usa
https://www.bettertoken.ai/v1. La herramienta añade la ruta del endpoint compatible con OpenAI. No añadas /chat/completions ni /responses salvo que un campo concreto lo exija explícitamente.