hermes doctor pour valider la stack ; hermes setup pour brancher votre LLM ; puis hermes gateway install pour recevoir des tâches depuis votre téléphone. Vous y trouverez la distinction avec OpenClaw, les tableaux d'environnement, un runbook en six étapes, le câblage BotFather et le moment où une location Mac Mini M4 devient pertinente pour un agent persistant.
Pourquoi installer Hermes Agent en 2026 — et comment il se distingue d'OpenClaw
En parcourant les tutoriels d'agents IA open source, vous croiserez Hermes Agent, OpenClaw, LangGraph et CrewAI. La ligne de partage est nette : Hermes est un opérateur personnel sur votre machine — USER.md, MEMORY.md et skills vivent sous ~/.hermes, la Gateway gère les canaux. OpenClaw mise davantage sur le hub multi-canal et l'écosystème ClawHub ; LangGraph et CrewAI restent des cadres d'orchestration où vous assemblez mémoire et déploiement vous-même.
Skills auto-évolutifs : Les tâches récurrentes chargent depuis ~/.hermes/skills/. Les retours communautaires montrent le nombre de skills passer de quelques unités à une douzaine en 30 jours, avec une baisse d'environ 38 % des tokens sur des jobs similaires — signal d'efficacité, pas score de qualité.
Indépendant du modèle : Anthropic, OpenAI, OpenRouter, GitHub Copilot, Ollama — clés dans ~/.hermes/.env.
Extensions MCP : Model Context Protocol pour GitHub, automatisation navigateur, et au-delà.
Point de friction : Réussir le CLI une fois n'est pas l'objectif — une Gateway 7×24 l'est. Comparez les hôtes dans notre matrice trois voies ; la mémoire composée dans le guide trois couches.
Prérequis Hermes Agent : macOS, Linux ou VPS ?
| Élément | Minimum | Recommandé (Gateway production) |
|---|---|---|
| OS | macOS 12+, Ubuntu 20.04+, WSL2 | macOS 14+ (Apple Silicon) ou Ubuntu 24.04 LTS |
| Python / Node | Script installe 3.11 / Node 18+ | Node 22 par défaut, sans sudo |
| RAM | 4 Go (API + Gateway seuls) | 16 Go (automatisation navigateur + fallback 7B local) |
| Disque | ~1,5 Go (cache skills inclus) | ≥ 20 Go SSD |
| Réseau | GitHub raw + API LLM accessibles | Sortie stable, faible latence |
| Scénario d'hébergement | Disponibilité 7×24 ressentie | Phase adaptée |
|---|---|---|
| Portable fermé | ≈ 60 %, effet composé interrompu | POC uniquement |
| VPS x86 4 Go | ≈ 99,5 %, pas de chemins skills macOS | Utilisateurs Linux purs |
| Mac Mini M4 loué | SLA datacenter, launchd natif | Telegram production, Camoufox |
Installation Hermes Agent : runbook en six étapes (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash source ~/.zshrc
Serveurs headless : bash -s -- --skip-browser. Le script installe uv, Python 3.11, Node 22, ripgrep, ffmpeg, clone dans ~/.hermes/hermes-agent/ et ajoute hermes au PATH. Ligne de succès : ✅ Hermes Agent installed at ~/.hermes.
Lancer le script : commande curl ci-dessus. Windows propose install.ps1 — la production privilégie WSL2 + script Linux.
Recharger le shell : source ~/.zshrc ou source ~/.bashrc corrige hermes: command not found.
Contrôle santé : hermes doctor valide Python, Node, ripgrep, ffmpeg, PATH, clés API — environ 12 points. hermes --version affiche v0.14.x ou candidat v0.15.
Configurer le LLM : assistant hermes setup, ou hermes model pour OpenRouter / Anthropic / Ollama seul. Clés dans ~/.hermes/.env, ex. hermes config set OPENROUTER_API_KEY sk-or-xxxx.
Test CLI : lancer hermes, essayer « résume l'actu IA du jour » — confirmer appels d'outils et routage modèle.
Mise à jour : au quotidien hermes update ; après upgrade, hermes config check && hermes config migrate.
Hermes Agent sur Telegram : de BotFather à gateway install
Le CLI seul ne couvre que le chat local. Pour déléguer depuis le téléphone, il faut la Gateway. Parcours : @BotFather → /newbot → conserver le token → @userinfobot pour votre ID numérique.
hermes gateway setup hermes gateway install hermes gateway start hermes gateway status
L'assistant écrit TELEGRAM_BOT_TOKEN et TELEGRAM_ALLOWED_USERS. En production Linux : sudo hermes gateway install --system et journalctl -u hermes-gateway -f ; macOS utilise un service utilisateur launchd.
| Erreur / symptôme | Cause | Correction |
|---|---|---|
hermes: command not found | PATH non chargé | Rouvrir le terminal ou sourcer le rc |
API key not set | Pas de LLM configuré | hermes model |
| Groupe silencieux | Mode confidentialité bot | Désactiver Group Privacy dans BotFather, retirer et réinviter |
ModuleNotFoundError: dotenv | Python système utilisé | Utiliser ~/.hermes/hermes-agent/venv/bin/hermes |
À retenir : hermes tools, hermes config check restent utiles. Déclarez mcp_servers dans ~/.hermes/config.yaml ; en headless, hermes mcp login + tunnel SSH pour l'OAuth.
Après l'installation : effet composé des skills et données Mac Mini M4
Échelle GitHub : En juin 2026, hermes-agent affiche environ 174 720 stars. La documentation install et Telegram évolue le plus vite sur le chemin macOS.
Consommation : M4 au repos 4–6 W ; Gateway + automatisation typiquement 15–25 W — adapté au fonctionnement continu.
Mémoire unifiée : Sur 16 Go UMA, la Gateway occupe environ 4 Go, partageant l'espace avec Camoufox et SQLite WAL — moins de swap qu'un petit VPS x86.
Portable fermé, limites I/O du Raspberry Pi ou VPS Linux sans skills navigateur macOS ne sont pas des échecs d'installation — ce sont des choix d'hôte qui cassent le SLA Gateway. Si vous voulez Hermes sur Telegram 7×24 avec des skills qui s'enrichissent, la location Mac Mini M4 bare metal MESHLAUNCH offre le même curl via SSH, la supervision launchd et la possibilité d'archiver ~/.hermes avant résiliation. Consultez les tarifs de location pour un essai journalier ; le périmètre opérationnel figure au centre d'aide.
Non. install.sh utilise uv pour Python 3.11 et Node 22. Si doctor échoue, vérifiez que vous appelez le hermes du venv, pas le Python système.
Après avoir désactivé Group Privacy dans BotFather, retirez le bot du groupe et réinvitez-le. Vérifiez TELEGRAM_ALLOWED_USERS. Vous pouvez commander un M4 dédié pour isoler les tests Gateway.
La mémoire disque persiste, mais une Gateway hors ligne stoppe l'effet composé et les Cron. La production exige hermes gateway install sur un hôte 7×24 — voir le guide architecture mémoire.