Configuración de Hermes Agent
Aprende a configurar Hermes Agent, incluyendo archivos de configuración, ajustes del proveedor de LLM, configuración de herramientas y todas las opciones de configuración disponibles.
Seleccionar proveedor de modelos
Hermes admite más de 300 modelos y más de una docena de proveedores.
Nous Portal es la pasarela de suscripción propia de Nous Research. Con un solo inicio de sesión OAuth, cubre la invocación de modelos y la pasarela de herramientas (búsqueda web, generación de imágenes, TTS, automatización del navegador):
hermes setup --portal

El comando anterior abrirá el navegador para completar la autorización OAuth, configurará Nous como proveedor de inferencia y activará todas las pasarelas de herramientas al mismo tiempo.

Asistente de configuración completo (con API Key incorporada):
hermes setup
El asistente ofrece tres modos:
| Modo | Descripción | Para quién |
|---|---|---|
| Quick Setup (Nous Portal) | Inicio de sesión OAuth con un clic, sin necesidad de API Key | Nuevos usuarios que quieren empezar rápidamente |
| Full Setup | Configura cada proveedor y herramienta paso a paso | Usuarios que quieren personalizar todo |
| Blank Slate | Habilita solo el núcleo mínimo (operaciones de archivos + terminal), todo lo demás desactivado | Usuarios avanzados que necesitan un control preciso |
Seleccionar proveedor manualmente
Usa el siguiente comando para ver los proveedores disponibles:
hermes model
Usa las teclas de flecha arriba y abajo para seleccionar y Enter para confirmar la configuración:

Formas de configuración de proveedores comunes:
| Proveedor | Forma de configuración |
|---|---|
| Nous Portal | hermes setup --portal(OAuth) |
| Anthropic(Claude) | Inicio de sesión OAuth (requiere plan Max + cuota de uso adicional), o configuraANTHROPIC_API_KEY |
| OpenRouter | ConfigurarOPENROUTER_API_KEY |
| OpenAI | ConfigurarOPENAI_API_KEY |
| Google AI Studio | ConfigurarGOOGLE_API_KEY |
| xAI(Grok OAuth) | hermes model → xAI Grok OAuth |
| Modelo local (LM Studio) | ConfigurarLM_API_KEYyLM_BASE_URL |
Principio: Primero haz que funcione la conversación básica, luego activa gradualmente funciones avanzadas como pasarelas, tareas programadas, voz, etc.
Usar CC Switch para configuración con un clic
A continuación usaremos CC Switch para que Hermes utilice grandes modelos como Qwen, GLM, Kimi, DeepSeek, etc. CC Switch es una herramienta de escritorio de código abierto y multiplataforma que gestiona de forma unificada asistentes de programación de IA como Claude Code, Codex, Gemini CLI, y admite cambiar con un clic el proveedor de API, el modelo y la configuración.
Puedes descargarlo desde el sitio web oficial:https://ccswitch.io/zh/。
También puedes ir a GitHub Releases: https://github.com/farion1231/cc-switch/releases/latestDescarga el paquete de instalación correspondiente a tu plataforma.
Desplázate hasta la parte inferior de la página, en la sección de paquetes de recursos, descarga el paquete de instalación para tu plataforma:

Después de descargar e instalar CC Switch, seleccionamos Hermes y hacemos clic en el botón «Crear» en la esquina superior derecha.

Luego, en la configuración, elige Personalizado:

Podemos usar el Coding Plan, que sigue siendo el más rentable, después de todo es de pago mensual:
Aquí elegimos Ark de ByteDance, ingresamos la API Key y la dirección de solicitud, que es compatible con OpenAI:https://ark.cn-beijing.volces.com/api/coding/v3, configura tu API key y el modelo que desees; aquí se seleccionódeepseek-v4-pro:

Después de la configuración, haz clic en el botón Guardar en la esquina inferior derecha. Al volver a la interfaz principal podremos ver la información configurada, probar si la configuración fue exitosa y luego activarla:
Una vez activado, vamos a la interfaz de línea de comandos y usamoshermesel comando para iniciar Hermes:
hermes
Se puede ver que el modelo se ha configurado correctamente y ya está listo para usar.
Para más detalles sobre CC Switch, consulta:https://www.example.com/ai-agent/cc-switch.html
Ubicación del archivo de configuración
Hermes Agent utiliza los siguientes archivos de configuración:
| Archivo | Descripción |
|---|---|
~/.hermes/config.yaml |
Archivo de configuración principal |
~/.hermes/.env |
Variables de entorno (claves API, etc.) |
~/.hermes/state.db |
Base de datos de sesiones SQLite |
~/.hermes/skills/ |
Directorio de habilidades instalado |
~/.hermes/sessions/ |
Directorio de almacenamiento de sesiones |
~/.hermes/memories/ |
Almacenamiento de memoria persistente |