Hermes Agent

En los últimos años, el campo de los agentes de IA (AI Agent) se ha desarrollado rápidamente, evolucionando de simples chatbots a agentes capaces de hacer cosas reales, con memoria persistente y crecimiento autónomo.

Hermes Agent es un framework de agente de IA autónomo de código abierto de Nous Research. A través de la interacción en lenguaje natural, el agente de IA autónomo puede ejecutar comandos de terminal, controlar el navegador, leer y escribir archivos, buscar en Internet, generar imágenes y mantener memoria entre sesiones.

• Repositorio de GitHub:https://github.com/nousresearch/hermes-agent
• Sitio web oficial de Hermes Agent:https://hermes-agent.nousresearch.com/

La definición oficial es muy directa:

The agent that grows with you.
一个会随着使用不断成长的 Agent.

Es un agente autónomo que cuanto más tiempo lleva funcionando, más capaz se vuelve.

La idea central de Hermes Agent es:Convertir la IA en un empleado digital en línea a largo plazo, en lugar de un chatbot desechable.

Hermes Agent es un agente de IA poco común en la industriacon bucle de aprendizaje integrado de forma nativa, que puede acumular habilidades a partir de la experiencia de ejecución, optimizar capacidades de forma autónoma, persistir conocimiento, recuperar conversaciones históricas y mejorar continuamente el modelo de comprensión del usuario entre sesiones.

Diferencias con las herramientas de chat de IA comunes:

Dimensión	Chat de IA común (como ChatGPT)	Hermes Agent
Memoria	Cada conversación comienza desde cero	Memoria persistente entre sesiones, te entiende mejor cuanto más lo usas
Capacidad de ejecución	Solo puede generar texto	Puede ejecutar comandos de terminal, manipular archivos y controlar el navegador
Ubicación de ejecución	Nube, los datos se suben al proveedor	Local o en tu servidor, los datos no salen de tu control
Extensibilidad	Ecosistema cerrado	Estándar de habilidades abierto (agentskills.io), ecosistema MCP
Canales de acceso	Web	CLI + Telegram/Discord/Slack/WhatsApp, etc.
Vinculación de modelos	Modelo fijo	Compatible con más de 300 modelos, cambia en cualquier momento, sin bloqueo

Características principales:

• Conectar (Connect):Telegram, Discord, Slack, WhatsApp, Signal, Email, CLI: un solo agente, memoria unificada, todas las plataformas. Una conversación iniciada en Telegram puede continuar sin problemas en la terminal.
• Recordar (Remember):Hermes aprende de tus proyectos, genera habilidades automáticamente y nunca olvida los problemas que ha resuelto. Al final de cada sesión, la información importante se escribe en la memoria persistente.
• Programar (Schedule):Configura tareas programadas con lenguaje natural (informes diarios, copias de seguridad, revisiones rutinarias, resúmenes matutinos) que se ejecutan en segundo plano sin supervisión.
• Delegar (Delegate):Genera subagentes aislados con contexto de conversación independiente, terminal independiente y scripts Python RPC, logrando tuberías paralelas con coste de contexto cero.
• Búsqueda y multimodal (Search):Búsqueda web, automatización del navegador, comprensión visual, generación de imágenes, texto a voz y razonamiento multimodelo, todo integrado.

Hermes Agent permite cambiar libremente entre cualquier modelo grande, incluyendoNous Portal, OpenRouter (más de 200 modelos), OpenAI, GLM, Kimi, MiniMax, etc. Basta con ejecutarhermes modelpara cambiar, sin modificar código y sin bloqueo de proveedor.

Proveedor	Descripción	Método de configuración
Nous Portal	Suscripción, configuración cero	Mediantehermes modeliniciar sesión con OAuth
OpenAI Codex	ChatGPT OAuth, usa el modelo Codex	Mediantehermes modelautenticación con código de dispositivo
Anthropic	Usar directamente el modelo Claude	Mediante autenticación de Claude Code o clave de API de Anthropic
OpenRouter	Enrutamiento de múltiples proveedores	Introduce tu clave de API
DeepSeek	Acceso directo a la API de DeepSeek	ConfiguraciónDEEPSEEK_API_KEY
Hugging Face	Acceso a más de 20 modelos abiertos a través de un enrutador unificado	ConfiguraciónHF_TOKEN
Endpoint personalizado	VLLM, SGLang, Ollama o cualquier API compatible con OpenAI	Configurar la URL base y la clave de API

Por supuesto, comprar el plan Coding es lo más rentable, ya que es de pago mensual:

Característica	Descripción de la capacidad
Interacción nativa con la terminal	Interfaz TUI completa, con edición multilínea, autocompletado de comandos, historial, salida en streaming, etc.
Acceso en todas las plataformas	Una sola puerta de enlace se conecta a CLI, Telegram, Discord, Slack, WhatsApp, entre otros.
Sistema de aprendizaje de bucle cerrado	Gestión autónoma de memoria, generación y optimización de habilidades, recuperación entre sesiones, modelado de usuario
Automatización programada	Programador Cron integrado, compatible con tareas automáticas 7×24 como informes diarios, copias de seguridad, auditorías, etc.
Procesamiento de tareas en paralelo	Admite ejecución paralela de subagentes, división de múltiples flujos de trabajo y llamadas a herramientas RPC
Ejecución en múltiples entornos	Compatible con 6 backends: local, Docker, SSH, Daytona, Modal, etc.
Capacidades de nivel de investigación	Compatible con generación de trayectorias, entornos de aprendizaje por refuerzo y compresión de datos de entrenamiento

Arquitectura general

Flujo general:

Diagrama de arquitectura:

Módulo	Función	Ejemplo
Capa de acceso (Clients)	Recibe solicitudes de usuario	Web, App, API, Feishu
Capa de entrada (Input)	Procesa varios datos de entrada	Texto, imágenes, PDF, Excel
Orquestador de agentes (Agent Orchestrator)	Entiende la tarea y divide el flujo de ejecución	Analizar requisitos → elaborar un plan
Capa de capacidades (Capabilities)	Proporciona capacidades de ejecución	Diálogo, recuperación, ejecución de código
Capa de memoria (Memory)	Guarda contexto e información histórica	Memoria de sesión, memoria a largo plazo
Capa de conocimiento (Knowledge)	Proporciona capacidades de recuperación de conocimiento	RAG, base de datos vectorial
Capa de modelos (Model Layer)	Proporciona capacidades de razonamiento	GPT, Claude, modelos locales
Capa de herramientas (Tools)	Llama a herramientas externas para completar tareas	Búsqueda, bases de datos, API
Capa de servicios externos (External Services)	Se conecta con sistemas de negocio	ERP, CRM, servicios en la nube
Capa de infraestructura (Infrastructure)	Soporta la operación del sistema	Permisos, registros, monitoreo

---

Instalación rápida

Los siguientes comandos de instalación son para sistemas Linux, macOS y WSL2:

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Después de la instalación, recarga el Shell:

bashsource ~/.bashrc   # 使用 bash
# o 
source ~/.zshrc    # 使用 zsh

Instalación nativa en Windows (PowerShell):

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

El soporte nativo de Windows sigue siendo experimental; se recomienda usar WSL2 preferentemente.

Versión de escritorio para macOS / Windows (Desktop App):Ir ahermes-agent.nousresearch.comDescargue el paquete de instalación de escritorio para su plataforma; la CLI y la aplicación de escritorio se instalarán simultáneamente.

Después de la descarga, haga doble clic para instalar:

Verificar la instalación:

hermes --version

Si muestra el número de versión, la instalación se realizó correctamente.

El instalador se encargará automáticamente de todas las dependencias:

• uv— Gestor de paquetes de Python rápido
• Python 3.11— Instalación mediante uv, sin necesidad de sudo
• Node.js v22— Para automatización de navegador y puente de WhatsApp
• ripgrep— Búsqueda rápida de archivos
• ffmpeg— Conversión de formato de audio TTS

Notas para Windows: No se admite el entorno nativo de Windows. Instale WSL2 primero y luego ejecute los comandos anteriores en la terminal de WSL2.

Si ya ha instalado OpenClaw, también puede importar la configuración directamente:

Luego configure el proveedor; puede establecer su clave de API existente. Aquí seleccione el Coding Plan de Bailian:

Establezca el nombre del modelo, por ejemplo MiniMax-M2.5.

Aquí elija no importar, escriban, entre en la configuración del modelo y seleccione la primera configuración rápida:

A continuación, seleccionamos "More providers" (penúltimo elemento):

Aquí puede elegir más modelos grandes nacionales o internacionales:

A continuación utilizamosel Coding Plan de ByteDance Ark (Volcengine), por lo que seleccionamosCustomer endpoint, es decir, la dirección de API personalizada y la clave de API.

La URL base configura la herramienta compatible con el protocolo de interfaz OpenAI de ByteDance Ark:https://ark.cn-beijing.volces.com/api/coding/v3

Configure la clave de API y el modelo grande compatible, por ejemploark-code-latest。

Después de completar la instalación, ejecute el siguiente comando:

source ~/.bashrc    # 重载shell配置（若使用zsh，执行：source ~/.zshrc）
hermes              # 开启智能体对话！

Inicio rápido

hermes              # 交互式命令行界面 — 开启对话
hermes model        # 选择大语言模型服务商与对应模型
hermes tools        # 配置启用的工具集
hermes config set   # 设置单项配置项
hermes gateway      # 启动消息网关（支持Telegram、Discord等平台）
hermes setup        # 运行全量配置向导（一站式完成所有配置）
hermes claw migrate # 从OpenClaw迁移数据（适用于原OpenClaw用户）
hermes update       # 更新至最新版本
hermes doctor       # 诊断运行环境与配置问题

---

Instalación manual

Si prefiere tener control total sobre el proceso de instalación, siga estos pasos.

Paso 1: Clonar el repositorio

Use--recurse-submodulesclone para obtener los submódulos necesarios:

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

Si ya ha clonado pero no tiene los submódulos:

git submodule update --init --recursive

Paso 2: Instalar uv y crear un entorno virtual

# 安装 uv（如果尚未安装）
curl -LsSf https://astral.sh/uv/install.sh | sh

# 创建 Python 3.11 的虚拟环境（uv 会在需要时下载，无需 sudo）
uv venv venv --python 3.11

Paso 3: Instalar dependencias de Python

# 告诉 uv 要安装到哪个虚拟环境
export VIRTUAL_ENV="$(pwd)/venv"

# 安装所有扩展
uv pip install -e ".[all]"

Si solo desea el agente principal (sin soporte para Telegram/Discord/cron):

uv pip install -e "."

Descripción de extensiones opcionales:

Extensión	Función	Comando de instalación
all	Incluye todas las siguientes funciones	uv pip install -e ".[all]"
messaging	Puerta de enlace de Telegram y Discord	uv pip install -e ".[messaging]"
cron	Análisis de expresiones Cron para tareas programadas	uv pip install -e ".[cron]"
voice	Entrada de micrófono y reproducción de audio en CLI	uv pip install -e ".[voice]"
mcp	Soporte de protocolo de contexto de modelo	uv pip install -e ".[mcp]"
honcho	Memoria nativa de IA (integración con Honcho)	uv pip install -e ".[honcho]"

Podemos combinarlos:uv pip install -e ".[messaging,cron]"

Paso 4: Crear el directorio de configuración

# 创建目录结构
mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}

# 复制示例配置文件
cp cli-config.yaml.example ~/.hermes/config.yaml

# 创建空的 .env 文件用于存储 API 密钥
touch ~/.hermes/.env

Paso 5: Añadir la clave de API

Abra~/.hermes/.envy añada al menos una clave de proveedor de LLM:

# 必需 — 至少一个 LLM 提供商：
OPENROUTER_API_KEY=sk-or-v1-your-key-here

# 可选 — 启用其他工具：
FIRECRAWL_API_KEY=fc-your-key          # 网页搜索和抓取
FAL_KEY=your-fal-key                   # 图像生成（FLUX）

O configúrelo mediante la CLI:

hermes config set OPENROUTER_API_KEY sk-or-v1-your-key-here

Paso 6: Añadir hermes al PATH

mkdir -p ~/.local/bin
ln -sf "$(pwd)/venv/bin/hermes" ~/.local/bin/hermes

Si~/.local/binno está en el PATH, añádalo a la configuración del shell:

# Bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc

# Zsh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

Paso 7: Configurar su proveedor

hermes model       # 选择您的 LLM 提供商和模型

Paso 8: Verificar la instalación

hermes version    # 检查命令是否可用
hermes doctor     # 运行诊断以验证一切正常
hermes status     # 检查您的配置
hermes chat -q "Hello! What tools do you have available?"

Solución de problemas

Problema	Solución
hermes: command not found	Recargue el shell (source ~/.bashrc) o verifique el PATH
La clave de API no está configurada	Ejecutehermes modelconfigure el proveedor, ohermes config set OPENROUTER_API_KEY your_key
La configuración se pierde después de actualizar	Ejecutehermes config checky luegohermes config migrate

Para obtener más información de diagnóstico, ejecutehermes doctor— le indicará qué falta y cómo solucionarlo.

Sugerencia:Puede cambiar de proveedor en cualquier momento mediantehermes model— sin necesidad de cambiar código, sin bloqueos.

---

Puerta de enlace de mensajes

La puerta de enlace de mensajes de Hermes Agent le permite interactuar con el agente a través de múltiples plataformas: Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant, etc.

Plataformas compatibles

Plataforma	Descripción	Estado
Telegram	La integración de plataforma de mensajería más completa	✅ Compatible
Discord	Compatible con servidores y canales de voz	✅ Compatible
Slack	Integración de espacio de trabajo	✅ Compatible
WhatsApp	A través de WhatsApp Web	✅ Compatible
Signal	Aplicación de mensajería privada	✅ Compatible
Matrix	Comunicación descentralizada	✅ Compatible
Mattermost	Mensajería autohospedada	✅ Compatible
Email	Correo SMTP	✅ Compatible
SMS	Envío de SMS	✅ Compatible
DingTalk	DingTalk	✅ Compatible
Feishu	Feishu (Lark)	✅ Compatible
WeCom	WeCom (WeChat Work)	✅ Compatible
BlueBubbles	macOS iMessage	✅ Compatible
Home Assistant	Hogar inteligente	✅ Compatible
Webhooks	Devolución de llamada HTTP personalizada	✅ Compatible

Configurar la plataforma de mensajería

Configuración interactiva:

hermes gateway setup

Esto iniciará un asistente de configuración interactivo que le guiará en la configuración de cada plataforma.

Configuración manual:

O edite directamente~/.hermes/config.yaml：

Telegram:

# 在 ~/.hermes/.env 中
TELEGRAM_BOT_TOKEN=your-bot-token

# config.yaml
gateway:
  adapters:
    telegram:
      enabled: true

Discord:

# 在 ~/.hermes/.env 中
DISCORD_BOT_TOKEN=your-discord-token

# config.yaml
gateway:
  adapters:
    discord:
      enabled: true
      allowed_channels:
        - "123456789"

Slack:

# 在 ~/.hermes/.env 中
SLACK_BOT_TOKEN=xoxb-your-token
SLACK_SIGNING_SECRET=your-signing-secret

# config.yaml
gateway:
  adapters:
    slack:
      enabled: true

WhatsApp:

# WhatsApp 需要浏览器自动化
# 首次设置需要扫描二维码

# config.yaml
gateway:
  adapters:
    whatsapp:
      enabled: true
      session_dir: ~/.hermes/whatsapp/session

Email (SMTP):

# 在 ~/.hermes/.env 中
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
[email protected]
SMTP_PASSWORD=your-app-password

# config.yaml
gateway:
  adapters:
    email:
      enabled: true
      from_email: [email protected]

Home Assistant:

# 在 ~/.hermes/.env 中
HA_URL=http://homeassistant.local:8123
HA_TOKEN=your-long-lived-access-token

# config.yaml
gateway:
  adapters:
    homeassistant:
      enabled: true

Iniciar la puerta de enlace

Ejecutar en primer plano:

hermes gateway

Ejecutar en segundo plano (recomendado):

hermes gateway &
# 或使用 systemd
systemctl enable hermes-agent
systemctl start hermes-agent

Ejecutar con Docker:

docker run -d \
  --name hermes-gateway \
  -v ~/.hermes:/home/hermes/.hermes \
  ghcr.io/nousresearch/hermes-agent:latest \
  hermes gateway

Configuración específica de la plataforma

Telegram:

1. Cree un nuevo bot a través de @BotFather
2. Obtenga el token del bot
3. Configure y ejecute Hermes
4. En Telegram, envíe a su bot/start

Discord:

1. Cree una aplicación en el portal de desarrolladores de Discord
2. Añada el bot al servidor
3. Obtenga el token del bot
4. Configure y ejecute Hermes

Slack:

1. Cree una nueva aplicación en el portal de aplicaciones de Slack
2. Añada el ámbito del token del bot
3. Instale en el espacio de trabajo
4. Configure y ejecute Hermes

Enviar mensajes:

Use lasend_messageherramienta para enviar mensajes a través de cualquier canal configurado:

send_message(
  platform="telegram",
  chat_id="123456789",
  message="Hello from Hermes!"
)

O programe mensajes automáticos mediante cron:

# 设置每日简报
hermes
❯ 每天早上9点检查 Hacker News 上的 AI 新闻，并通过 Telegram 给我发送摘要

Soporte de voz

Algunas plataformas admiten interacción por voz:

• Telegram: mensajes de voz y llamadas de voz
• Discord: canales de voz y mensajes de voz
• CLI: entrada de micrófono y TTS

Para obtener más información sobre el modo de voz, consulte la guía de modo de voz.

Consideraciones de seguridad

Solución de problemas

Problema	Solución
El bot no responde	Compruebe si la puerta de enlace está en ejecución
Error de permisos	Verifique el token del bot y los permisos
El mensaje no se envía	Compruebe el ID del canal y la configuración
Tiempo de espera de conexión agotado	Compruebe la red y la configuración del firewall

Sugerencia:Usehermes gateway --verbosepara ver los registros detallados y depurar problemas.

Otras extensiones