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, 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)
- Linux / macOS / WSL2
- Windows PowerShell
Hermes recomienda el instalador Desktop para macOS y Windows. Descarga Hermes Desktop y ejecuta el instalador de tu sistema.
WSL2 sigue siendo compatible, pero es opcional. Úsalo si necesitas un entorno Linux o el terminal integrado del Web Dashboard.
Referencia rápida de funciones
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.Pasos de configuración
- Configuración interactiva
- Archivos de configuración
1
Ejecuta el selector de modelos
Si hay un chat de Hermes abierto, sal primero de la sesión. Después, ejecuta:
2
Elige Custom endpoint
Selecciona Custom endpoint (self-hosted / VLLM / etc.) en la lista de proveedores.
3
Completa la configuración de BetterToken
Introduce:
- Base URL:
https://bettertoken.ai/v1 - API Key: tu BetterToken API Key
- Model: un ID de modelo de un proveedor compatible copiado desde la model plaza
4
Inicia Hermes Agent
hermes si prefieres la interfaz clásica de terminal.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://bettertoken.ai/v1, tu BetterToken API Key y un ID de modelo de un proveedor compatible.
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, ejecutahermes 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
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 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://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.