Configurar Hermes Agent: API Key, Base URL y modelos
Instala Hermes Agent, configura la Base URL y la API Key de BetterToken, elige un modelo disponible y corrige los errores habituales. Más.
Para conectar Hermes Agent con BetterToken, prepara una API Key, introduce la Base URL indicada a continuación y elige un ID de modelo vigente en la model plaza.
Ajustes principales
| Campo | Valor |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Modelo | Un ID de modelo vigente de la model plaza |
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
¿Ya tienes una cuenta? Inicia sesión, recarga el saldo y crea una clave en la consola.
Requisitos adicionales
- Copia el Model ID exacto de la model plaza.
- macOS, Linux, Windows 10/11 o WSL2
- Un modelo con una ventana de contexto mínima de 64K para usar herramientas
Instalación
Instala Hermes Agent
Desktop (macOS / Windows)
Hermes recomienda el instalador Desktop para macOS y Windows. Descarga Hermes Desktop y ejecuta el instalador de tu sistema.
Linux / macOS / WSL2
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bashWindows PowerShell
Hermes Agent es compatible de forma nativa con Windows 10 y 11. Ejecuta esto en PowerShell o Windows Terminal:
iex (irm https://hermes-agent.nousresearch.com/install.ps1)No necesitas permisos de administrador. Abre una nueva ventana de PowerShell después de instalar.
hermes --versionhermes doctorReferencia rápida de funciones
| Función | Uso |
|---|---|
| Terminal UI | Conversar directamente con el agente desde la terminal |
| Skills | Guardar workflows reutilizables para tareas repetidas |
| MCP | Conectar capacidades de herramientas locales o remotas |
| Tareas programadas | Ejecutar trabajos temporizados y workflows recurrentes |
| Subagentes | Dividir trabajos complejos entre agentes especializados |
| Gateway de mensajes | Conectar el agente con más puntos de entrada de mensajes |
Configuración manual
Usa como método principal la configuración interactiva de modelos de Hermes Agent. Edita directamente los archivos de configuración solo cuando necesites una configuración manual.
| Campo | Valor |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| Modelo | Un ID de modelo vigente de la model plaza |
Pasos de configuración
Configuración interactiva
Ejecuta el selector de modelos
Si hay un chat de Hermes abierto, sal primero de la sesión. Después, ejecuta:
hermes modelElige Custom endpoint
Selecciona Custom endpoint (self-hosted / VLLM / etc.) en la lista de proveedores.
Completa la configuración de BetterToken
Introduce:
- Base URL:
https://bettertoken.ai/v1 - API Key: tu BetterToken API Key
- Model: un ID de modelo disponible copiado desde la model plaza
Si Hermes pregunta por el modo de API, elige Chat Completions. Para usar las herramientas del agente, selecciona un modelo con al menos 64K de contexto.
Inicia Hermes Agent
hermes --tuiEjecuta hermes si prefieres la interfaz clásica de terminal.
Archivos de configuración
Añade el proveedor custom en ~/.hermes/config.yaml:
model: default: YOUR_MODEL_ID provider: custom base_url: "https://bettertoken.ai/v1"Guarda la BetterToken API Key por separado en ~/.hermes/.env:
OPENAI_API_KEY=YOUR_API_KEYSustituye YOUR_MODEL_ID por un ID de modelo disponible de la model plaza y YOUR_API_KEY por tu BetterToken API Key. En Windows nativo, estos archivos están en %LOCALAPPDATA%\hermes\.
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.
hermes claw migrate --dry-runDespués de confirmar la salida, ejecuta la migración:
hermes claw migrateDespués de migrar, revisa la Base URL, la API Key y el ID del modelo de Hermes Agent. Deben coincidir con https://bettertoken.ai/v1, tu BetterToken API Key y un ID de modelo disponible.
Verifica la conexión
Inicia Hermes Agent y envía este prompt de prueba:
Reply with HERMES_OK only. Do not use tools.Si la respuesta es exactamente HERMES_OK, la conexión funciona.
Cambia de modelo
Fuera de una sesión, ejecuta hermes model. En un chat activo, usa /model para cambiar entre proveedores o modelos ya configurados. Elige el ID de modelo exacto de la model plaza.
Errores habituales
| Error | Qué comprobar |
|---|---|
401 o Unauthorized | Comprueba la BetterToken API Key y elimina los espacios iniciales o finales. |
404 | Comprueba la Base URL y no añadas una ruta específica de endpoint. |
model not found | Copia un ID de modelo vigente desde la model plaza. |
| Los cambios no se aplican | Guarda la configuración y reinicia la herramienta por completo. |
Solución de problemas
- Si las solicitudes fallan o no responden, confirma que Base URL sea exactamente
https://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 disponible de la model plaza.
- Copia el Model ID exacto de la model plaza.
- 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.
Si tu gateway requiere cabeceras de autenticación adicionales, Hermes admite extra_headers dentro de providers.<provider-name> en config.yaml. Sigue la configuración de proveedores con nombre para definir los nombres de cabecera necesarios y mantén privados los valores de las credenciales.
Preguntas relacionadas
Detalles técnicos
Protocolo, endpoint y campos internos del proveedor
Esta configuración usa https://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.
