Cómo ejecutar Hermes Agent 24/7 en un Mac mini dedicado

1. ¿Por qué ejecutar Hermes Agent en un Mac mini?

Hermes Agent está diseñado para permanecer activo: conserva memorias persistentes, ejecuta tareas programadas con su cron integrado y mejora sus propias skills entre conversaciones. Nada de eso funciona en un portátil que se duerme ni en un VPS compartido que se reinicia. Un Mac mini dedicado de MyRemoteMac te ofrece Apple Silicon (Tier 1 para Hermes), acceso root completo por SSH y VNC, 1 Gbps incluido y un precio mensual fijo, con la opción de ejecutar un modelo local de Ollama en la misma máquina para que la inferencia no cueste nada por token.

2. Requisitos previos

El instalador oficial es deliberadamente ligero. No necesitas Homebrew, Python ni Node.js: Hermes descarga su propio uv fijado y Python 3.14, y Node.js solo se requiere más adelante si activas el puente de WhatsApp. Esto es lo que realmente necesitas:

• Un Mac mini dedicado de MyRemoteMac, M4 desde $85/mes o M6 desde $149/mes. Ambos son Apple Silicon, que es Tier 1 para Hermes.
• Acceso SSH a tu Mac mini (incluido con tu suscripción a MyRemoteMac)
• git y curl en el Mac (además de tar y una herramienta SHA-256, todos preinstalados en macOS, git a través de las Xcode Command Line Tools). El instalador solo falla de forma bloqueante cuando faltan git o curl.
• Un proveedor de LLM: una clave API (Anthropic, OpenRouter, OpenAI y más de 25 proveedores), una suscripción a Nous Portal o un modelo local de Ollama. El modelo debe ofrecer al menos 64.000 tokens de contexto y admitir tool calling.
• Una cuenta de mensajería en Telegram, Discord o WhatsApp (Telegram es la más rápida de configurar)

3. Paso 1: Conectar por SSH y ejecutar el instalador

Conéctate por SSH a tu Mac mini con las credenciales de tu panel de MyRemoteMac. El instalador necesita git y curl (además de tar y una herramienta SHA-256, todos preinstalados en macOS) y luego hace todo lo demás por sí solo: clona el código fuente en ~/.hermes/hermes-agent, descarga un uv fijado y verificado por SHA-256, aprovisiona Python 3.14, instala las dependencias, crea ~/.hermes/config.yaml y ~/.hermes/.env (chmod 600) y lanza una configuración interactiva.

Conectar por SSH y comprobar los requisitos

# Connect to your Mac mini
ssh admin@your-server-ip

# Confirm Apple Silicon (Tier 1 platform for Hermes Agent)
uname -m
# arm64

# The installer requires only git and curl: both ship with macOS
git --version && curl --version

Ejecutar el instalador oficial en una línea

Es el mismo comando que publican el README oficial y la página de instalación. No uses Homebrew: brew install hermes-agent figura como método no soportado en la documentación oficial. Si automatizas la instalación por SSH, añade --non-interactive (alias --skip-setup) y ejecuta el asistente tú mismo después.

# Official one-line installer (Linux / macOS / WSL2)
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

# What it does:
# - clones the source into ~/.hermes/hermes-agent
# - downloads a pinned, sha256-verified uv and provisions Python 3.14
# - creates ~/.hermes/config.yaml and ~/.hermes/.env (chmod 600)
# - launches the interactive setup wizard

# Scripting over SSH? Skip the wizard and run it later with `hermes model`:
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash -s -- --non-interactive

Recargar el shell y verificar

El instalador añade ~/.local/bin a tu PATH en ~/.zshrc y ~/.zprofile. Recarga el shell (o abre una nueva sesión SSH) y ejecuta el diagnóstico integrado:

# Reload the shell so ~/.local/bin/hermes is on PATH
source ~/.zshrc    # or open a new SSH session

# Verify the install
hermes --version

# Built-in diagnostics (add --fix to attempt automatic repairs)
hermes doctor

4. Paso 2: Configurar un proveedor de modelos (API u Ollama local)

Hermes guarda los secretos en ~/.hermes/.env y todo lo demás en ~/.hermes/config.yaml, y ofrece tres formas oficiales de elegir un modelo. Elijas lo que elijas, el modelo necesita al menos 64.000 tokens de contexto. Ten en cuenta que el propio modelo de chat Hermes 4 de Nous no es lo que necesita el bucle del agente, la documentación de Nous Portal recomienda en su lugar un modelo frontier con tool calling.

Opción A o B: el asistente interactivo o Nous Portal

El asistente te guía por proveedores, claves API e inicios de sesión OAuth. Nous Portal es una suscripción que da al agente acceso a más de 300 modelos con un único inicio de sesión OAuth (el precio está en el sitio de Nous Portal, no en la documentación).

# Option A: interactive wizard (providers, API keys, OAuth logins)
hermes model

# Option B: Nous Portal subscription via OAuth (300+ models)
hermes setup --portal

Opción C: definir clave y modelo de forma no interactiva

Las claves en UPPER_SNAKE como ANTHROPIC_API_KEY, OPENROUTER_API_KEY u OPENAI_API_KEY se enrutan a .env; las claves con puntos o en minúsculas van a config.yaml. El id de modelo de abajo es el ejemplo usado en el quickstart oficial, elige el modelo actual que ofrezca tu proveedor con 64k+ de contexto y tool calling.

# Option C: non-interactive, UPPER_SNAKE keys go to ~/.hermes/.env
hermes config set ANTHROPIC_API_KEY sk-ant-YOUR_API_KEY_HERE

# Dotted / lowercase keys go to ~/.hermes/config.yaml
# (model id below is the example from the official quickstart)
hermes config set model anthropic/claude-opus-4.6

# Review the active configuration
hermes config show

Opcional: un modelo local gratuito con Ollama

Tu Mac mini puede alojar el modelo por sí mismo. La guía oficial de Hermes para Ollama usa gemma4:31b (unos 20 GB en disco, 24+ GB de RAM, tool calling soportado), en MyRemoteMac, una configuración de 24 GB (Mac mini M4 24 GB a $129/mes o M6 24 GB a $219/mes) cumple ese mínimo documentado, con poco margen para macOS y la ventana de contexto de 64k, si quieres margen en un Mac mini de 24 GB, elige en su lugar un modelo más pequeño con tool calling. La ventana de contexto por defecto de Ollama está muy por debajo del requisito de 64k de Hermes, así que la documentación te hace crear un Modelfile que aumenta num_ctx. Instala primero Ollama para macOS desde ollama.com/download; Ollama también documenta una ruta guiada con ollama launch hermes.

# 1. Install Ollama for macOS from https://ollama.com/download

# 2. Pull a tool-calling model (~20 GB on disk, 24+ GB RAM)
ollama pull gemma4:31b

# 3. Hermes needs 64k context: build a Modelfile that raises num_ctx
printf 'FROM gemma4:31b\nPARAMETER num_ctx 64000\n' > Modelfile
ollama create gemma4-64k -f Modelfile

# 4. Point Hermes at the local OpenAI-compatible endpoint
hermes setup
# Choose "Custom Endpoint": base URL http://localhost:11434/v1, model gemma4-64k

# Alternative guided path documented by Ollama:
ollama launch hermes

Prueba de humo antes de añadir nada más

El quickstart es explícito: si Hermes no puede completar un chat normal, no añadas todavía el gateway, cron ni skills. Ejecuta primero una conversación limpia:

# Classic CLI chat
hermes

# Or the terminal UI
hermes --tui

5. Paso 3: Conectar canales de mensajería

Un único proceso gateway de Hermes sirve a todas tus plataformas: la documentación oficial cuenta más de 20 desde un solo gateway, incluidos Telegram, Discord, Slack, WhatsApp, Signal, Google Chat, Microsoft Teams, Matrix, Mattermost y puentes de iMessage. A continuación, los tres que hemos verificado contra las páginas de documentación dedicadas. El gateway deniega por defecto, hasta que añadas tu ID de usuario a la lista de permitidos, el bot ignora a todo el mundo.

Telegram (primer canal recomendado)

Crea un bot con @BotFather (/newbot te da el token) y obtén tu ID de usuario numérico con @userinfobot, las listas de permitidos de Telegram usan IDs numéricos, no @usernames. Luego ejecuta el asistente del gateway, que escribe los valores en ~/.hermes/.env. El long polling es el modo por defecto, así que no hace falta ningún puerto entrante ni regla de firewall.

# 1. In Telegram, open @BotFather, send /newbot and copy the token
# 2. Open @userinfobot to get your numeric user ID

# 3. Run the gateway wizard (writes the values to ~/.hermes/.env)
hermes gateway setup

# Equivalent manual entries in ~/.hermes/.env:
# TELEGRAM_BOT_TOKEN=123456789:ABC...
# TELEGRAM_ALLOWED_USERS=123456789
# Optional: chat that receives scheduled-task results (or send /sethome in a chat)
# TELEGRAM_HOME_CHANNEL=123456789

Discord (opcional)

Crea una aplicación en el Discord Developer Portal, copia el token del bot y activa tanto el Message Content Intent como el Server Members Intent en Privileged Gateway Intents, sin el Message Content Intent el bot recibe eventos con texto vacío. Invita al bot con el entero de permisos 274878286912 y luego añade tu ID de usuario a la lista de permitidos.

# In the Discord Developer Portal (https://discord.com/developers/applications):
# 1. New Application > Bot > copy the Bot Token
# 2. Privileged Gateway Intents: enable Message Content Intent + Server Members Intent
# 3. Invite the bot with permission integer 274878286912

hermes gateway setup   # choose Discord

# Equivalent manual entries in ~/.hermes/.env:
# DISCORD_BOT_TOKEN=...
# DISCORD_ALLOWED_USERS=284102345871466496
# DISCORD_REQUIRE_MENTION=true   (default)

WhatsApp (opcional)

WhatsApp usa un puente no oficial (Baileys) que necesita Node.js v18+ y un número de teléfono dedicado vinculado mediante código QR. La documentación oficial advierte de que conlleva un pequeño riesgo de restricciones de cuenta, y el directorio de sesión otorga acceso completo a la cuenta, nunca lo compartas.

# Requires Node.js v18+ on the Mac mini (only needed for WhatsApp)
node --version

# Pair a dedicated phone number via QR code
hermes whatsapp

# ~/.hermes/.env:
# WHATSAPP_ENABLED=true
# WHATSAPP_MODE=bot
# WHATSAPP_ALLOWED_USERS=15551234567   (country code, no +)

# Session is stored in ~/.hermes/platforms/whatsapp/session: never share it
# Meta Business Cloud API alternative: hermes whatsapp-cloud

Probar el gateway en primer plano

Inicia el gateway en tu sesión SSH, envía un mensaje a tu bot, confirma que responde y luego pulsa Ctrl-C. hermes gateway status muestra el estado del servicio; escribe al bot para confirmar de extremo a extremo.

# Run the gateway in the foreground
hermes gateway

# Send your bot a message from Telegram / Discord: it should reply.
# Press Ctrl-C to stop (the persistent service is set up in Step 4)

6. Paso 4: Ejecutar 24/7 con launchd, actualizar, migrar

hermes gateway install registra un LaunchAgent a nivel de usuario en ~/Library/LaunchAgents/ai.hermes.gateway.plist (etiqueta ai.hermes.gateway) para que el gateway arranque al iniciar sesión (RunAtLoad) y quede supervisado por macOS. Un detalle importante de las FAQ oficiales: el plist toma una instantánea de tu PATH completo del shell en el momento de la instalación. Instala Node.js, ffmpeg u Ollama antes de este paso, o vuelve a ejecutar hermes gateway install después.

Instalar e iniciar el servicio

# Register the launchd LaunchAgent
# (writes ~/Library/LaunchAgents/ai.hermes.gateway.plist with your current PATH)
hermes gateway install

# Start it now
hermes gateway start

# Service status
hermes gateway status

# Live logs
tail -f ~/.hermes/logs/gateway.log

# Other commands: hermes gateway stop | restart | list
# Foreground run (no launchd): hermes gateway run

Verificar que launchd lo supervisa (y probar un reinicio)

hermes gateway status muestra el estado del servicio; escribe al bot para confirmar de extremo a extremo y consulta launchctl directamente para confirmar que launchd es realmente el propietario del proceso. Como un LaunchAgent a nivel de usuario solo se carga cuando existe tu sesión de usuario, asegúrate de que el inicio de sesión automático está activado para tu usuario administrador (Ajustes del Sistema > Usuarios y grupos > Inicio de sesión automático) antes de la prueba de reinicio, de lo contrario, el gateway no volverá en un Mac mini headless. Luego reinicia una vez (sudo reboot) y vuelve a escribir al bot.

# Confirm launchd owns the gateway (state, PID, last exit code)
launchctl print gui/$(id -u)/ai.hermes.gateway

# Check the PATH that was captured in the plist
/usr/libexec/PlistBuddy -c "Print :EnvironmentVariables:PATH" ~/Library/LaunchAgents/ai.hermes.gateway.plist

# LaunchAgents load at login: enable Automatic login first
# (System Settings > Users & Groups > Automatic login)
# Reboot-test once, then message the bot again
sudo reboot

Actualizar Hermes Agent

hermes update descarga el código más reciente en ~/.hermes/hermes-agent, resincroniza las dependencias y reinicia el gateway en modo drenaje: rechaza nuevos turnos y espera a que terminen el chat, el cron y el trabajo de API en curso (hasta 30 minutos por defecto) antes de reiniciar. La salida se duplica en ~/.hermes/logs/update.log. Usa --check para previsualizar, --backup para hacer una instantánea de ~/.hermes primero y --no-gateway-restart para aplazar el reinicio.

# Preview what would change
hermes update --check

# Update (snapshot ~/.hermes first, drain-first gateway restart)
hermes update --backup

# Adopt any new configuration options
hermes config check && hermes config migrate

# Confirm the running version
hermes --version

Opcional: migrar desde OpenClaw en el mismo Mac

¿Ya ejecutas OpenClaw siguiendo nuestra otra guía? El comando oficial de migración importa SOUL.md, memorias y perfiles de usuario (a ~/.hermes/memories/) y skills (a ~/.hermes/skills/openclaw-imports/) desde ~/.openclaw, y antes escribe un punto de restauración pre-migration-*.zip en ~/.hermes/backups/. Los secretos no se importan por defecto: añade --migrate-secrets explícitamente para trasladar las claves API y los tokens de mensajería (Telegram, Discord, Slack, Signal, Matrix, Mattermost). WhatsApp no migra su token, solo se traslada su lista de permitidos, y debe volver a vincularse con hermes whatsapp. Empieza siempre con un dry run.

# Preview the migration from ~/.openclaw
hermes claw migrate --dry-run

# Migrate (writes a pre-migration-*.zip restore point in ~/.hermes/backups/ first)
# --migrate-secrets is required to carry over API keys and messaging tokens
hermes claw migrate --migrate-secrets

# Later, rename leftover OpenClaw directories to .pre-migration/
hermes claw cleanup

7. Resolución de problemas comunes

# Reload the shell profile the installer edited
source ~/.zshrc

# Or call the binary directly
~/.local/bin/hermes --version

# Still broken? Run the diagnostics
~/.local/bin/hermes doctor --fix

# Allowlist resolution order (official security guide):
# per-platform allow-all -> DM-pairing list -> TELEGRAM_ALLOWED_USERS / DISCORD_ALLOWED_USERS
# -> GATEWAY_ALLOWED_USERS -> GATEWAY_ALLOW_ALL_USERS=true -> deny

# Check what is stored (Telegram IDs are numeric, from @userinfobot)
grep TELEGRAM_ALLOWED_USERS ~/.hermes/.env

# Fix it, then watch the gateway in the foreground while you message the bot
hermes config set TELEGRAM_ALLOWED_USERS 123456789
hermes gateway

# Discord only: confirm Message Content Intent is enabled in the Developer Portal

# See the PATH launchd is using
/usr/libexec/PlistBuddy -c "Print :EnvironmentVariables:PATH" ~/Library/LaunchAgents/ai.hermes.gateway.plist

# Re-capture your current shell PATH and reload the service
hermes gateway install
hermes gateway start

# Check the logs
tail -50 ~/.hermes/logs/gateway.log

# Rebuild the model with a 64k context window
printf 'FROM gemma4:31b\nPARAMETER num_ctx 64000\n' > Modelfile
ollama create gemma4-64k -f Modelfile

# Make sure Hermes targets the 64k variant on the local endpoint
hermes setup   # Custom Endpoint: http://localhost:11434/v1, model gemma4-64k

# Note: the model must also support tool calling (gemma4:31b does, per the official guide)

# Is the LaunchAgent registered and running?
launchctl print gui/$(id -u)/ai.hermes.gateway

# Not listed? Re-register and start it (and check Automatic login is on)
hermes gateway install
hermes gateway start
hermes gateway status

# Then reboot-test again
sudo reboot

8. Análisis de costes vs. VPS cloud

Hermes Agent en sí es gratuito (MIT). Lo que pagas es el host y el uso del LLM. La comparativa de hosts de abajo reutiliza las cifras de VPS cloud de nuestra guía de OpenClaw; el uso de la API del LLM lo factura aparte tu proveedor en ambas columnas y es idéntico en cualquiera de los dos hosts, salvo que ejecutes un modelo local de Ollama en el Mac mini, en cuyo caso la inferencia cuesta $0.

Supuestos: los precios de VPS son los mismos rangos usados en todas nuestras guías para instancias de tier IA con GPU y no son presupuestos de un proveedor concreto; los precios de MyRemoteMac son las tarifas mensuales actuales en USD (1 Gbps incluido). El precio de la suscripción a Nous Portal no está publicado en la documentación de Hermes, por lo que no se incluye.

9. Hermes Agent vs. OpenClaw

Ambos son agentes IA personales de código abierto (MIT), autoalojados y always-on, controlados desde tus apps de mensajería; ambos se instalan con un comando curl de una línea, ambos ejecutan un gateway de larga duración y ambos registran su propio LaunchAgent de launchd (ai.hermes.gateway vs ai.openclaw.gateway). Las diferencias están en el stack y en el enfoque. OpenClaw es TypeScript sobre Node.js (26.1+ o 24.16+ vía Homebrew), se instala con npm y tiene su propio comando openclaw gateway install service. Hermes es Python arrancado por un uv fijado, vive por completo en ~/.hermes, solo necesita git y curl (Node.js únicamente para el puente de WhatsApp) y usa hermes gateway install. La propuesta de Hermes es la automejora: skills creadas por el agente, memorias persistentes y SOUL.md, cron integrado y siete backends de terminal (local, Docker, SSH, Modal, Daytona, Vercel Sandbox, Singularity). La propuesta de OpenClaw es la amplitud y una comunidad mayor, el 28 de septiembre de 2026 GitHub mostraba unas 391k estrellas para OpenClaw frente a 250k para Hermes.

Si ya ejecutas OpenClaw, la migración es de primera clase: hermes claw migrate (ver Paso 4) es una migración hacia delante que antes escribe un punto de restauración pre-migration-*.zip en ~/.hermes/backups/. Si empiezas desde cero, lee también nuestra guía de OpenClaw en Mac mini y elige el harness cuyo flujo de trabajo prefieras, el Mac mini, el servicio launchd y la opción de Ollama local son idénticos para ambos.

10. Preguntas frecuentes

11. Fuentes y lecturas adicionales

Todos los comandos y requisitos de esta guía se verificaron el 28 de septiembre de 2026 contra la documentación y el repositorio oficiales de Hermes Agent (última versión v2026.9.24). Hermes publica versiones etiquetadas por fecha y evoluciona rápido, así que consulta estas páginas para ver la lista actual de flags:

• Repositorio GitHub de Hermes Agent (NousResearch/hermes-agent)
• Guía de instalación oficial
• Quickstart (proveedores, requisito de contexto de 64k, prueba de humo)
• Plataformas soportadas (Tier 1 macOS Apple Silicon, métodos no soportados)
• Actualizar Hermes Agent
• Referencia de configuración (config.yaml, .env, precedencia)
• Guía de seguridad (listas de permitidos, aprobaciones, backend Docker)
• Visión general de mensajería (lista de plataformas, gateway install/start/stop)
• Configuración de Telegram
• Configuración de Discord
• Configuración de WhatsApp
• Referencia de comandos de la CLI
• FAQ (PATH de launchd en macOS, gateway.log)
• Guía de configuración de Ollama local (gemma4:31b, num_ctx 64000)
• Migrar desde OpenClaw
• Integración con Nous Portal
• Página de integración de Ollama (ollama launch hermes)

Guías relacionadas