Comment faire tourner Hermes Agent 24h/24 sur un Mac mini dédié

1. Pourquoi faire tourner Hermes Agent sur un Mac mini ?

Hermes Agent est conçu pour rester en ligne : il conserve des mémoires persistantes, exécute des tâches planifiées avec son cron intégré et améliore ses propres skills entre deux conversations. Rien de tout cela ne fonctionne sur un portable qui se met en veille ou un VPS partagé qui redémarre. Un Mac mini dédié chez MyRemoteMac vous offre de l'Apple Silicon (Tier 1 pour Hermes), un accès root complet via SSH et VNC, 1 Gbps inclus et un tarif mensuel fixe, avec la possibilité de faire tourner un modèle Ollama local sur la même machine, pour une inférence qui ne coûte rien au token.

2. Prérequis

L'installeur officiel est volontairement léger. Vous n'avez besoin ni de Homebrew, ni de Python, ni de Node.js : Hermes télécharge ses propres uv (version épinglée) et Python 3.14, et Node.js n'est requis que plus tard si vous activez le bridge WhatsApp. Voici ce dont vous avez réellement besoin :

• Un Mac mini dédié chez MyRemoteMac, M4 dès $85/mois ou M6 dès $149/mois. Les deux sont en Apple Silicon, plateforme Tier 1 pour Hermes.
• Un accès SSH à votre Mac mini (fourni avec votre abonnement MyRemoteMac)
• git et curl sur le Mac (plus tar et un outil SHA-256, tous préinstallés sur macOS, git via les Xcode Command Line Tools). L'installeur n'échoue de façon bloquante que si git ou curl manque.
• Un fournisseur de LLM : une clé API (Anthropic, OpenRouter, OpenAI et plus de 25 autres), un abonnement Nous Portal ou un modèle Ollama local. Le modèle doit offrir au moins 64 000 tokens de contexte et prendre en charge l'appel d'outils (tool calling).
• Un compte de messagerie sur Telegram, Discord ou WhatsApp (Telegram est le plus rapide à configurer)

3. Étape 1 : Connexion en SSH et lancement de l'installeur

Connectez-vous en SSH à votre Mac mini avec les identifiants de votre tableau de bord MyRemoteMac. L'installeur a besoin de git et curl (plus tar et un outil SHA-256, tous préinstallés sur macOS), puis fait tout le reste lui-même : il clone les sources dans ~/.hermes/hermes-agent, télécharge un uv épinglé et vérifié par SHA-256, provisionne Python 3.14, installe les dépendances, crée ~/.hermes/config.yaml et ~/.hermes/.env (chmod 600) et lance une configuration interactive.

Connexion en SSH et vérification des prérequis

# 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

Lancement de l'installeur officiel en une ligne

C'est la même commande que celle publiée par le README officiel et la page d'installation. N'utilisez pas Homebrew : brew install hermes-agent figure parmi les méthodes non prises en charge dans la documentation officielle. Si vous scriptez l'installation via SSH, ajoutez --non-interactive (alias --skip-setup) et lancez l'assistant vous-même ensuite.

# 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

Rechargement du shell et vérification

L'installeur ajoute ~/.local/bin à votre PATH dans ~/.zshrc et ~/.zprofile. Rechargez le shell (ou ouvrez une nouvelle session SSH), puis lancez les diagnostics intégrés :

# 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. Étape 2 : Configuration d'un fournisseur de modèle (API ou Ollama local)

Hermes conserve les secrets dans ~/.hermes/.env et tout le reste dans ~/.hermes/config.yaml, et propose trois méthodes officielles pour choisir un modèle. Quel que soit votre choix, le modèle doit offrir au moins 64 000 tokens de contexte. Notez que le modèle de chat Hermes 4 de Nous n'est pas ce que la boucle d'agent attend, la documentation Nous Portal recommande plutôt un modèle de pointe compatible tool calling.

Option A ou B : l'assistant interactif ou Nous Portal

L'assistant vous guide à travers les fournisseurs, les clés API et les connexions OAuth. Nous Portal est un abonnement qui donne à l'agent accès à plus de 300 modèles via une seule connexion OAuth (les tarifs sont sur le site Nous Portal, pas dans la documentation).

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

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

Option C : définir une clé et un modèle sans interaction

Les clés en UPPER_SNAKE comme ANTHROPIC_API_KEY, OPENROUTER_API_KEY ou OPENAI_API_KEY sont dirigées vers .env ; les clés avec des points ou en minuscules vont dans config.yaml. L'identifiant de modèle ci-dessous est l'exemple utilisé dans le quickstart officiel, choisissez n'importe quel modèle actuel de votre fournisseur offrant 64k+ de contexte et le 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

Optionnel : un modèle local gratuit avec Ollama

Votre Mac mini peut héberger le modèle lui-même. Le guide Ollama officiel d'Hermes utilise gemma4:31b (environ 20 Go sur disque, 24 Go de RAM ou plus, tool calling pris en charge), chez MyRemoteMac, une configuration 24 Go (Mac mini M4 24 Go à $129/mois ou M6 24 Go à $219/mois) atteint ce minimum documenté, avec peu de marge restante pour macOS et la fenêtre de contexte de 64k, si vous voulez de la marge sur un Mac mini 24 Go, choisissez plutôt un modèle tool calling plus petit. La fenêtre de contexte par défaut d'Ollama est très inférieure aux 64k exigés par Hermes, donc la documentation vous fait créer un Modelfile qui augmente num_ctx. Installez d'abord Ollama pour macOS depuis ollama.com/download ; Ollama documente aussi un parcours guidé avec 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

Test rapide avant d'ajouter quoi que ce soit d'autre

Le quickstart est explicite : si Hermes ne parvient pas à mener une conversation normale, n'ajoutez pas encore la gateway, le cron ni les skills. Faites d'abord une conversation propre :

# Classic CLI chat
hermes

# Or the terminal UI
hermes --tui

5. Étape 3 : Connexion des canaux de messagerie

Un seul processus gateway Hermes dessert toutes vos plateformes : la documentation officielle en compte plus de 20 depuis une seule gateway, dont Telegram, Discord, Slack, WhatsApp, Signal, Google Chat, Microsoft Teams, Matrix, Mattermost et des bridges iMessage. Voici les trois que nous avons vérifiées sur les pages de documentation dédiées. La gateway refuse tout par défaut, tant que vous n'avez pas ajouté votre identifiant utilisateur à l'allowlist, le bot ignore tout le monde.

Telegram (premier canal recommandé)

Créez un bot avec @BotFather (/newbot vous donne le token) et récupérez votre identifiant utilisateur numérique auprès de @userinfobot, les allowlists Telegram utilisent des identifiants numériques, pas des @usernames. Lancez ensuite l'assistant de la gateway, qui écrit les valeurs dans ~/.hermes/.env. Le long polling est le mode par défaut : aucun port entrant ni règle de pare-feu n'est nécessaire.

# 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 (optionnel)

Créez une application dans le Portail développeur Discord, copiez le token du bot et activez à la fois Message Content Intent et Server Members Intent sous Privileged Gateway Intents, sans Message Content Intent, le bot reçoit des événements au texte vide. Invitez le bot avec l'entier de permissions 274878286912, puis ajoutez votre identifiant utilisateur à l'allowlist.

# 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 (optionnel)

WhatsApp utilise un bridge non officiel (Baileys) qui nécessite Node.js v18+ et un numéro de téléphone dédié appairé via QR code. La documentation officielle avertit qu'il comporte un faible risque de restrictions de compte, et le répertoire de session donne un accès complet au compte, ne le partagez jamais.

# 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

Test de la gateway au premier plan

Lancez la gateway dans votre session SSH, envoyez un message à votre bot, vérifiez qu'il répond, puis appuyez sur Ctrl-C. hermes gateway status affiche l'état du service ; envoyez un message au bot pour valider de bout en bout.

# 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. Étape 4 : Fonctionnement 24h/24 avec launchd, mise à jour, migration

hermes gateway install enregistre un LaunchAgent au niveau utilisateur dans ~/Library/LaunchAgents/ai.hermes.gateway.plist (label ai.hermes.gateway) pour que la gateway démarre à l'ouverture de session (RunAtLoad) et soit supervisée par macOS. Un détail important tiré de la FAQ officielle : le plist capture l'intégralité du PATH de votre shell au moment de l'installation. Installez Node.js, ffmpeg ou Ollama avant cette étape, ou relancez hermes gateway install ensuite.

Installation et démarrage du service

# 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

Vérification de la supervision par launchd (et un test de redémarrage)

hermes gateway status affiche l'état du service ; envoyez un message au bot pour valider de bout en bout, et interrogez directement launchctl pour confirmer que launchd possède bien le processus. Comme un LaunchAgent au niveau utilisateur ne se charge qu'une fois votre session utilisateur ouverte, assurez-vous que l'ouverture de session automatique est activée pour votre utilisateur admin (Réglages Système > Utilisateurs et groupes > Ouverture de session automatique) avant le test de redémarrage, sinon la gateway ne reviendra pas sur un Mac mini sans écran (headless). Redémarrez ensuite une fois (sudo reboot) et envoyez à nouveau un message au 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

Mise à jour d'Hermes Agent

hermes update récupère le dernier code dans ~/.hermes/hermes-agent, resynchronise les dépendances et redémarre la gateway en mode drain-first : elle refuse les nouveaux tours et attend la fin des conversations, tâches cron et appels API en cours (jusqu'à 30 minutes par défaut) avant de redémarrer. La sortie est recopiée dans ~/.hermes/logs/update.log. Utilisez --check pour prévisualiser, --backup pour sauvegarder ~/.hermes au préalable et --no-gateway-restart pour différer le redémarrage.

# 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

Optionnel : migrer depuis OpenClaw sur le même Mac

Vous faites déjà tourner OpenClaw grâce à notre autre guide ? La commande de migration officielle importe SOUL.md, les mémoires et les profils utilisateur (vers ~/.hermes/memories/), les skills (vers ~/.hermes/skills/openclaw-imports/) depuis ~/.openclaw, et écrit d'abord un point de restauration pre-migration-*.zip dans ~/.hermes/backups/. Les secrets ne sont pas importés par défaut : ajoutez explicitement --migrate-secrets pour reprendre les clés API et les tokens de messagerie (Telegram, Discord, Slack, Signal, Matrix, Mattermost). WhatsApp n'est pas migré au niveau du token, seule son allowlist est reprise, et doit être réappairé avec hermes whatsapp. Commencez toujours par une simulation (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. Résolution des problèmes courants

# 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. Analyse des coûts vs VPS cloud

Hermes Agent lui-même est gratuit (MIT). Ce que vous payez, c'est l'hôte et la consommation LLM. La comparaison d'hôtes ci-dessous reprend les chiffres de VPS cloud de notre guide OpenClaw ; la consommation d'API LLM est facturée séparément par votre fournisseur dans les deux colonnes et est identique quel que soit l'hôte, sauf si vous faites tourner un modèle Ollama local sur le Mac mini, auquel cas l'inférence coûte $0.

Hypothèses : les prix VPS sont les mêmes fourchettes utilisées dans l'ensemble de nos guides pour des instances tier IA avec GPU et ne sont pas des devis d'un fournisseur précis ; les prix MyRemoteMac sont les tarifs mensuels actuels en USD (1 Gbps inclus). Le tarif de l'abonnement Nous Portal n'est pas publié dans la documentation Hermes, il n'est donc pas inclus.

9. Hermes Agent vs OpenClaw

Les deux sont des agents IA personnels open-source (MIT), auto-hébergés et toujours en ligne, pilotés depuis vos applications de messagerie ; les deux s'installent avec une commande curl en une ligne, les deux font tourner une gateway persistante et les deux enregistrent leur propre LaunchAgent launchd (ai.hermes.gateway vs ai.openclaw.gateway). Les différences tiennent à la stack et au positionnement. OpenClaw est en TypeScript sur Node.js (26.1+ ou 24.16+ via Homebrew), installé avec npm, avec sa propre commande openclaw gateway install service. Hermes est en Python amorcé par un uv épinglé, vit entièrement dans ~/.hermes, n'a besoin que de git et curl (Node.js uniquement pour le bridge WhatsApp) et utilise hermes gateway install. Le positionnement d'Hermes, c'est l'auto-amélioration : skills créés par l'agent, mémoires persistantes et SOUL.md, cron intégré et sept backends de terminal (local, Docker, SSH, Modal, Daytona, Vercel Sandbox, Singularity). Celui d'OpenClaw, c'est l'étendue et une communauté plus large, au 28 septembre 2026, GitHub affichait environ 391 000 étoiles pour OpenClaw contre 250 000 pour Hermes.

Si vous utilisez déjà OpenClaw, la migration est de premier ordre : hermes claw migrate (voir Étape 4) est une migration en avant qui écrit d'abord un point de restauration pre-migration-*.zip dans ~/.hermes/backups/. Si vous partez de zéro, lisez aussi notre guide OpenClaw sur Mac mini et choisissez le harness dont le workflow vous convient le mieux, le Mac mini, le service launchd et l'option Ollama locale sont identiques pour les deux.

10. FAQ

11. Sources et lectures complémentaires

Chaque commande et chaque prérequis de ce guide a été vérifié le 28 septembre 2026 par rapport à la documentation et au dépôt officiels d'Hermes Agent (dernière version v2026.9.24). Hermes publie des versions datées et évolue vite : consultez ces pages pour la liste actuelle des options :

• Dépôt GitHub d'Hermes Agent (NousResearch/hermes-agent)
• Guide d'installation officiel
• Quickstart (fournisseurs, exigence de contexte 64k, test rapide)
• Plateformes prises en charge (Tier 1 macOS Apple Silicon, méthodes non prises en charge)
• Mise à jour d'Hermes Agent
• Référence de configuration (config.yaml, .env, priorité)
• Guide de sécurité (allowlists, approbations, backend Docker)
• Vue d'ensemble de la messagerie (liste des plateformes, gateway install/start/stop)
• Configuration Telegram
• Configuration Discord
• Configuration WhatsApp
• Référence des commandes CLI
• FAQ (PATH launchd sous macOS, gateway.log)
• Guide de configuration Ollama local (gemma4:31b, num_ctx 64000)
• Migrer depuis OpenClaw
• Intégration Nous Portal
• Page d'intégration Ollama (ollama launch hermes)

Guides associés