1. Descripción General

¡Bienvenido a desplegar Hermes Agent en Lighthouse!

Este artículo está incluido en la columna: Dominando Lighthouse

👋 ¿Aún no tienes un servidor en la nube? Haz clic aquí para disfrutar de las Ofertas Exclusivas de Lighthouse y desplegar rápidamente Hermes Agent~

2. Introducción

En abril de 2026, Nous Research lanzó oficialmente el proyecto de código abierto Hermes Agent, que rápidamente ganó amplia atención en GitHub y en la comunidad de IA. A diferencia de los asistentes de codificación vinculados a IDEs o los chatbots de API única en el mercado, Hermes Agent es un verdadero Agente Autónomo: se ejecuta en tu servidor, tiene memoria persistente y se vuelve más fuerte con el tiempo. Lo más emocionante es que tiene un ciclo de autoaprendizaje completo: crea habilidades de forma autónoma, mejora las habilidades a través del uso y recuerda memorias entre sesiones, verdaderamente convirtiéndose en "más inteligente cuanto más lo usas".

Hermes Agent tiene conexiones profundas con el anteriormente popular proyecto OpenClaw, incluso incluye el comando integrado hermes claw migrate, que soporta la migración con un solo clic de configuraciones, memorias, habilidades y claves API de OpenClaw. Hermes Agent representa una evolución integral en el espacio de los Agentes de IA.

3. ¿Dónde Debería Instalarse Hermes Agent?

Similar a OpenClaw, Hermes Agent también tiene permisos completos de operación del sistema (ejecución de terminal, lectura/escritura de archivos, automatización del navegador, etc.), por lo que la recomendación oficial es desplegarlo en un entorno aislado de tu computadora personal principal para garantizar la seguridad de los datos.

Hermes Agent soporta plataformas Linux, macOS, WSL2 y Android (Termux), siendo Linux el entorno de despliegue más recomendado. Desplegar Hermes Agent en un servidor en la nube no solo logra un aislamiento seguro de tu computadora local, sino que también permite disponibilidad en línea 24/7, permitiéndote interactuar con él en cualquier momento y lugar a través de aplicaciones de chat como Telegram y Discord.

Nota: Hermes Agent actualmente no soporta entornos Windows nativos. Los usuarios de Windows necesitan instalar WSL2 primero y ejecutarlo allí.

4. ¿Por Qué Elegir Tencent Cloud Lighthouse?

Tencent Cloud Lighthouse es un producto de servidor en la nube diseñado para escenarios de aplicaciones ligeras. No requiere entender conceptos complejos de computación en la nube y ofrece paquetes de servidor con buena relación calidad-precio.

Comparado con ejecutar en una computadora local, desplegar Hermes Agent usando el servidor Lighthouse tiene las siguientes ventajas:

Ventaja	Descripción
Inicio Rápido	Completa el despliegue en solo unos minutos
Económico	Comienza a experimentar por solo unas decenas de dólares
24/7 En Línea	Soporte nativo para operación las 24 horas, interactúa con Hermes Agent a través de apps de chat en cualquier momento
Aislamiento Seguro	El entorno en la nube está fuertemente aislado de la computadora local, protegiendo la seguridad de los datos personales

5. Instalación de Hermes Agent en Tencent Cloud Lighthouse

5.1 Método 1: Comprar un Nuevo Servidor Lighthouse

Ve a la página de compra del producto Tencent Cloud Lighthouse para comprar un servidor. Configuración recomendada:

Imagen: Hermes Agent
Región: Elige según tu caso de uso. Para conectarte a plataformas extranjeras como Discord, típicamente elige una región extranjera (como Hong Kong, China); si necesitas llamar a modelos domésticos (como Kimi, MiniMax, Zhipu GLM), se recomienda elegir una región doméstica.
Configuración del Paquete: Se recomienda 2 núcleos y 4GB de memoria o superior, la configuración mínima soporta 2 núcleos y 2GB de memoria (adecuada para prueba simple).

Haz clic en Comprar Ahora, sigue la guía de la página para completar el pago y espera aproximadamente 30 segundos para completar la creación del servidor.

5.2 Método 2: Reinstalar un Servidor Lighthouse Existente

Nota: Reinstalar el sistema borrará todos los datos en el servidor. ¡Por favor procede con precaución!

Si tienes una instancia Lighthouse existente inactiva, puedes seleccionar la imagen Hermes Agent a través de "Reinstalar Sistema", luego configurar Hermes Agent siguiendo los pasos subsiguientes.

Guía de Configuración de Modelo y Canales para Hermes Agent

Obtener Clave API de MiniMax

Antes de configurar el modelo, primero necesitas obtener una clave API (API Key) de la plataforma MiniMax. La clave API funciona como una "llave" que permite a Hermes Agent llamar a los modelos de lenguaje grande de MiniMax.

Abre Plataforma Abierta de MiniMax - Página de Clave API en tu navegador.

Regístrate o inicia sesión en tu cuenta de MiniMax (si aún no has iniciado sesión, la página se redirigirá automáticamente a la interfaz de inicio de sesión).

Después de ingresar a la página, haz clic en "Crear Clave API" e ingresa un nombre de clave en la ventana emergente:

El sistema generará una cadena de clave que comienza con sk-api-, similar a sk-api-YyVAdYTmxxxxxxxxxxxxxxxxxxxx.

Importante: Copia y guarda esta clave de inmediato de forma segura. Una vez que cierres la página, no podrás ver la clave completa nuevamente.

Importante: Asegúrate de que el saldo de tu cuenta de MiniMax no sea cero. Si el saldo de la cuenta es cero, incluso con la configuración correcta de la clave API, Hermes Agent no podrá llamar al modelo para conversaciones normalmente. Puedes verificar y recargar tu saldo en Centro de Costos de MiniMax - Página de Saldo.

Paso 3: Ejecutar `hermes setup` para Configurar el Modelo

Ahora regresa al terminal del servidor y ejecuta el siguiente comando para iniciar el asistente de configuración interactivo de Hermes Agent:

hermes setup

Después de la ejecución, el terminal mostrará una interfaz de asistente de configuración como la siguiente:

Como esta es la primera instalación, el asistente te pedirá que elijas un modo de configuración. Usa las teclas de flecha arriba/abajo del teclado para seleccionar Quick setup — provider, model & messaging (recommended) (Configuración rápida, recomendada), luego presiona Enter para confirmar.

3.1 Seleccionar Proveedor de Modelo (Provider)

A continuación, el asistente mostrará una lista de proveedores de modelos (Provider) que incluye todos los proveedores de servicios de modelos compatibles con Hermes Agent.

Usa las teclas de flecha arriba/abajo para desplazarte por la lista, selecciona More providers... y presiona Enter.

Encuentra y selecciona MiniMax (China), luego presiona Enter para confirmar la selección.

Explicación: MiniMax y MiniMax (China) son dos opciones diferentes. MiniMax (China) corresponde al sitio doméstico de MiniMax. Si estás usándolo dentro de China y obtuviste la clave API del sitio de MiniMax China, por favor selecciona esta opción.

3.2 Ingresar Clave API

Después de seleccionar el proveedor, el asistente te pedirá que ingreses la clave API de MiniMax China:

MiniMax CN API key:

Pega la clave API que copiaste en el paso dos aquí (para pegar en terminal: haz clic derecho, o presiona Ctrl+Shift+V), luego presiona Enter para confirmar.

Nota: Por seguridad, no se mostrarán caracteres (incluyendo asteriscos) en la pantalla al ingresar la clave. Esto es normal. Simplemente pega y presiona Enter.

Después de una entrada exitosa, el terminal mostrará información de confirmación similar a la siguiente:

API Key Saved.

En este punto, también se mostrará información de Base URL. Simplemente presiona Enter:

3.3 Seleccionar Modelo

Después de guardar exitosamente la clave API, el asistente mostrará la lista de modelos compatibles con MiniMax China:

->   MiniMax-M2
     MiniMax-M2.5
     MiniMax-M2.7
     MiniMax-M2.7-highspeed
     MiniMax-M2.1
     MiniMax-M2.5-highspeed
     Enter custom model name
     Skip (keep current)

Usa las teclas de flecha arriba/abajo para seleccionar el modelo que deseas usar. Se recomienda seleccionar MiniMax-M2.7 (última versión, capacidades más fuertes), luego presiona Enter para confirmar.

Después de la confirmación, el asistente mostrará información de confirmación similar a:

✓ Default model set to: MiniMax-M2.7

3.4 Omitir Configuración de Canal de Chat

Después de completar la configuración del modelo, el asistente preguntará si deseas conectar una plataforma de mensajería:

Connect a messaging platform? (Telegram, Discord, etc.)
  ● Set up messaging now (recommended)
  ○ Skip — set up later with 'hermes setup gateway'

Aquí seleccionamos Skip — set up later with 'hermes setup gateway' (configurar más tarde), y presionamos Enter para omitir.

PS: Configuraremos WeChat Work a través de la línea de comandos en pasos posteriores.

El asistente mostrará un resumen de la finalización de la configuración y preguntará si deseas conectar Hermes para conversación inmediatamente:

Continuamos con los siguientes pasos.

Paso 4: Verificar Configuración del Modelo a través de TUI de Línea de Comandos

Antes de continuar configurando WeChat Work, podemos primero verificar si el modelo está configurado correctamente a través de la línea de comandos. Hermes Agent proporciona una interfaz de chat de línea de comandos integrada (TUI) que permite conversar directamente con el Agent en el terminal.

Aquí ingresamos Y en la línea de comandos, luego presionamos Enter.

O más tarde puedes ejecutar directamente en el terminal:

hermes

Si el modelo está configurado correctamente, verás la interfaz de bienvenida de Hermes Agent, y la parte inferior mostrará la información del modelo actualmente en uso (por ejemplo, MiniMax-M2.7 via minimax-cn).

Ingresa un mensaje simple en el cuadro de entrada para probar, por ejemplo:

Hola, por favor preséntate

Presiona Enter para enviar. Si todo es normal, Hermes Agent generará una respuesta a través del modelo MiniMax y la mostrará en el terminal.

Si encuentras mensajes de error (como API key invalid o tiempo de espera de conexión), por favor verifica:

Si la clave API se pegó correctamente (puedes ejecutar hermes doctor para diagnóstico)
Si el servidor puede acceder al servicio API de MiniMax (generalmente no hay problema con Lighthouse doméstico)

Después de una verificación exitosa, ingresa /quit y presiona Enter para salir de la interfaz TUI y volver a la línea de comandos.

/quit

Configurar Puertas de Enlace (Gateways)

El sistema de puertas de enlace de Hermes Agent admite la integración con 15+ plataformas de mensajería principales, incluyendo WeCom (WeChat Work), DingTalk, Feishu (Lark) comúnmente utilizadas en el país, así como plataformas internacionales como Telegram, Discord, Slack, WhatsApp, etc. Un solo proceso en segundo plano puede conectarse simultáneamente a todas las plataformas configuradas. La comparación de características de cada plataforma es la siguiente:

Plataforma	Voz	Imágenes	Archivos	Hilos	Salida en Streaming
CLI (Línea de Comandos)	✅	✅	✅	—	✅
WeCom (WeChat Work)	✅	✅	✅	✅	✅
DingTalk	✅	✅	✅	—	✅
Feishu/Lark	✅	✅	✅	✅	✅
Telegram	✅	✅	✅	✅	✅
Discord	✅	✅	✅	✅	✅
Slack	✅	✅	✅	✅	✅
WhatsApp	—	✅	✅	—	✅
Signal	—	✅	—	—	✅
Email	—	✅	✅	✅	—

A continuación, usaremos Telegram como ejemplo para demostrar paso a paso cómo configurar una puerta de enlace.

Conectar Telegram

Basado en todos los materiales buscados y el contenido de capturas de pantalla anteriores, aquí está el contenido del tutorial Markdown preparado para la sección Conectar Telegram:

Guía Completa de Integración de WeCom para Hermes Agent

Conectar WeCom (WeChat Work)

WeCom es una de las herramientas de mensajería instantánea a nivel empresarial más comúnmente utilizadas en China. Hermes Agent admite de forma nativa la conexión a WeCom a través de WebSocket, sin necesidad de dirección IP pública, sin necesidad de dirección de devolución de llamada Webhook, con configuración simple.

Paso 1: Crear Bot de IA en la Consola de Administración de WeCom

Después de que la verificación del modelo sea exitosa, necesitamos configurar WeCom como un canal de chat, para que puedas hablar con Hermes Agent como enviar mensajes de WeChat.

5.1 Iniciar Sesión en la Consola de Administración de WeCom

Abre Consola de Administración de WeCom en tu navegador.

Inicia sesión usando el escaneo de código QR de WeCom (necesitas tener permisos de administrador para una organización de WeCom).

Consejo: Si aún no tienes una organización de WeCom, puedes registrar una gratis. Visita Sitio Web Oficial de WeCom, haz clic en "Registrarse Ahora" y sigue el proceso para crear una organización.

5.2 Crear Aplicación de Bot de IA

Después de iniciar sesión en la consola de administración, encuentra y haz clic en Seguridad y Administración en la barra de menú izquierda.

Haz clic en Herramientas de Administración, luego selecciona Robot Inteligente en la Zona Inteligente.

En la página de creación, haz clic en el botón Crear Robot.

En la ventana emergente, selecciona Creación Manual.

En la página Crear Robot Inteligente, haz clic en el botón de edición, y en la ventana emergente posterior, completa el avatar del robot, nombre (por ejemplo, "Hermes") e información de descripción secuencialmente.

Desplázate hacia la parte inferior derecha de la página, selecciona Creación en Modo API.

Usar Método de Conexión Larga para Conectar Robot de WeCom

En la siguiente página, configura el alcance visible según sea necesario.

En la configuración de API, encuentra Secret, y haz clic en el botón Haz clic para Obtener detrás de él:

En los permisos disponibles, selecciona Mensajes (otros permisos se pueden otorgar según sea necesario):

Después de completar la autorización, regresa a la página y haz clic en el botón Guardar.

5.3 Obtener ID de Bot y Secret

Después de completar la creación, ingresa a la página de detalles de ese robot, verás las siguientes dos piezas clave de información:

ID de Bot: Identificador único del robot
Secret: Clave secreta del robot

Por favor copia y guarda estos dos valores de forma segura, ya que se necesitarán más adelante al configurar Hermes Agent.

Consejo de Seguridad: Secret es equivalente a la contraseña del robot. Por favor no lo reveles a otros.

Paso 2: Configurar Credenciales de WeCom en el Servidor

Regresa al terminal del servidor. Necesitamos configurar el ID de Bot y Secret de WeCom que acabamos de obtener en Hermes Agent.

Toda la información sensible para Hermes Agent (como claves API, credenciales de Bot, etc.) se guarda en el archivo ~/.hermes/.env. Podemos usar los siguientes comandos para escribir las credenciales de WeCom una por una.

6.1 Escribir ID de Bot y Secret

Ejecuta el siguiente comando en el terminal (reemplaza your-bot-id con el ID de Bot real que copiaste en el paso 5.3):

hermes config set WECOM_BOT_ID your-bot-id

Por ejemplo, si tu ID de Bot es bot_abc123xyz, el comando sería:

hermes config set WECOM_BOT_ID bot_abc123xyz

Ejecuta el siguiente comando (reemplaza your-secret con el Secret real que copiaste en el paso 5.3):

hermes config set WECOM_SECRET your-secret

6.2 Configuración de Permisos de Mensajes Privados

Puedes restringir qué usuarios pueden enviar mensajes privados a Hermes Agent configurando WECOM_DM_POLICY. Aquí, configúralo como pairing.

De esta manera, cuando un usuario no autorizado envía un mensaje privado a tu Bot, no abrirá directamente una conversación, sino que activará un proceso de verificación de código de emparejamiento: el Bot enviará un código de emparejamiento de un solo uso a la otra parte, y necesitas confirmarlo en el lado del servidor antes de que pueda pasar.

hermes config set WECOM_DM_POLICY pairing

6.3 Configurar Restricciones de Acceso (Opcional)

Puedes restringir qué usuarios de WeCom pueden conversar con Hermes Agent configurando WECOM_ALLOWED_USERS:

hermes config set WECOM_ALLOWED_USERS your_user_id

Si permites múltiples usuarios, sepáralos con comas en inglés:

hermes config set WECOM_ALLOWED_USERS user_id_1,user_id_2

Cómo obtener el ID de usuario de WeCom: En la Consola de Administración de WeCom → Contactos → Haz clic en miembro → Ver el campo "Cuenta", que es el ID de usuario.

Si no necesitas restricciones de acceso temporalmente (solo para pruebas personales), puedes omitir este paso. Por defecto, todos los miembros de WeCom que puedan contactar a este Bot pueden conversar con él (requiere emparejamiento).

Consejo: Si deseas que todos los usuarios de WeCom puedan interactuar con el Bot, puedes ejecutar hermes config set GATEWAY_ALLOW_ALL_USERS true. Si solo deseas permitir el acceso a usuarios específicos, puedes configurar una lista blanca a través de hermes config set WECOM_ALLOWED_USERS user_id_1,user_id_2.

Paso 3: Iniciar la Puerta de Enlace

Después de completar todas las configuraciones, necesitamos iniciar la puerta de enlace de mensajes de Hermes Agent, que es responsable de recibir y enviar mensajes de WeCom.

Para que Hermes Agent se ejecute continuamente en segundo plano y se inicie automáticamente después del reinicio del servidor, se recomienda instalar la puerta de enlace como un servicio del sistema:

hermes gateway install

Después de completar la instalación, inicia el servicio:

hermes gateway start

Puedes verificar el estado de ejecución del servicio de puerta de enlace en cualquier momento con el siguiente comando:

hermes gateway status

En este punto, tu Hermes Agent está completamente configurado y ejecutándose en segundo plano.

Ahora volvemos al backend de WeCom. Podemos obtener y escanear el código QR del robot para agregarlo al cuadro de diálogo de chat:

Después de enviar cualquier mensaje en WeCom, verás un mensaje de emparejamiento:

Copia el último comando del mensaje de emparejamiento, regresa a la línea de comandos del servidor, pégalo y presiona Enter. Después de ver la siguiente información, indica que el emparejamiento está completo.

¡Ahora regresa a WeCom y puedes comenzar a conversar con Hermes Agent!

Si encuentras un mensaje similar a 📬 No home channel is set for Wecom. A home channel is where Hermes delivers cron job results and cross-platform messages., puedes enviar directamente /sethome en el cuadro de diálogo de chat para completarlo.

Consejo de Seguridad: La WebUI de Hermes Agent no proporciona capacidades de autenticación. Cualquier persona que conozca la dirección de acceso puede operar directamente tu Agent. No recomendamos encarecidamente habilitar WebUI por ti mismo y acceder a través de la red pública.

Configuración Avanzada de WeCom

Puedes configurar aún más las políticas de acceso de WeCom en ~/.hermes/config.yaml, como restringir qué grupos pueden usar el Bot, configurar listas blancas de usuarios dentro del grupo, etc.:

platforms:
  wecom:
    enabled: true
    extra:
      dm_policy: "open"           # Política de chat privado: open/allowlist/disabled
      group_policy: "allowlist"    # Política de chat grupal: open/allowlist
      group_allow_from:            # Lista de ID de grupos permitidos
        - "group_id_1"

Problemas Comunes

Mensaje "Code not found or expired" después de ingresar el comando de emparejamiento

Síntoma: Después de ejecutar el comando de emparejamiento proporcionado en el mensaje de WeCom en el terminal del servidor, aparece el mensaje:

Code 'XXXXXXXX' not found or expired for platform 'wecom'.
Run 'hermes pairing list' to see pending codes.

Causa: El código de emparejamiento tiene un período de validez (1 hora). Puede haber expirado o cambiado mientras copiabas el comando.

Solución:

Ejecuta el siguiente comando para ver las solicitudes de emparejamiento pendientes actuales:

hermes pairing list

Encuentra el código de emparejamiento correspondiente a la columna Código en la lista devuelta (por ejemplo, XXXXXXXX):

Pending Pairing Requests (1):
Platform    Code        User ID        Name           Age
--------    ----        -------        ----           ---
wecom       XXXXXXXX    JIAYU          JIAYU    1m ago

Copia este código de emparejamiento y vuelve a ejecutar el comando de aprobación:

hermes pairing approve wecom XXXXXXXX

Reemplaza XXXXXXXX con el código de emparejamiento real que ves en la lista.

Referencia Rápida de Comandos de Gestión Comunes

Después de completar las configuraciones anteriores, es posible que necesites los siguientes comandos para administrar tu Hermes Agent:

Comando	Descripción
`hermes`	Chatear directamente con Hermes Agent en terminal (interfaz TUI)
`hermes gateway`	Iniciar puerta de enlace de mensajes en primer plano
`hermes gateway start`	Iniciar servicio de puerta de enlace en segundo plano
`hermes gateway stop`	Detener servicio de puerta de enlace en segundo plano
`hermes gateway status`	Verificar estado del servicio de puerta de enlace
`hermes setup`	Volver a ejecutar el asistente de configuración
`hermes setup model`	Solo reconfigurar modelo/proveedor
`hermes setup gateway`	Solo reconfigurar plataforma de chat
`hermes model`	Cambiar modelo
`hermes doctor`	Diagnosticar problemas de configuración
`hermes update`	Actualizar a la última versión
`hermes config`	Ver configuración actual

Iniciar y Gestionar la Puerta de Enlace

Después de completar la configuración, usa los siguientes comandos para gestionar el servicio de puerta de enlace:

# Ejecutar en primer plano (adecuado para depuración)
hermes gateway

# Iniciar en segundo plano
hermes gateway start

# Verificar estado de ejecución
hermes gateway status

# Detener puerta de enlace
hermes gateway stop

Consejo: Un proceso de puerta de enlace puede conectarse simultáneamente a todas las plataformas configuradas (WeCom, Telegram, Discord, etc.), no es necesario iniciar servicios separados para cada plataforma.

¡Bienvenido a Unirte a la Discusión!

Se ha creado un Discord, ¡y todos son bienvenidos a unirse y explorar formas avanzadas de usar Hermes Agent juntos!

🚀 Comunidad de Desarrolladores y Soporte

Comunidad de Desarrolladores

Desbloquea consejos avanzados en Discord

Clic para unirse a la comunidad
Nota: Después de unirte, puedes obtener las últimas plantillas de plugins y playbooks de despliegue

Soporte Dedicado

Únete a WhatsApp / WeCom para soporte técnico dedicado

Canal	Escanear / Clic para unirse
Canal de WhatsApp
WeCom (WeChat Empresarial)

Guía de Despliegue de Hermes en la Nube con Un Solo Clic