Hermes Agent sur Mac : installation et passerelle (2026)
Hermes Agent est l'agent IA open source auto-améliorant de Nous Research (GitHub, MIT). Boucle d'apprentissage, mémoire, skills, cron et passerelles Telegram/Discord/Slack/etc. Ce guide couvre l'installation sur Mac (MacBook ou Mac mini headless), sans cloud obligatoire.
Pourquoi Hermes sur Mac
- Installateur
install.shnatif macOS. - Apple Silicon +
uv(Python 3.11, Node, ffmpeg, ripgrep). hermes gatewaypour chatter depuis Telegram — veille Mac = coupure.- Migration depuis OpenClaw via
hermes claw migrate.
Obra Superpowers structure le processus ; Hermes fournit runtime et canaux.
Architecture macOS
| Composant | Chemin | Rôle |
|---|---|---|
| CLI | ~/.local/bin/hermes | TUI |
| Config | ~/.hermes/ | Clés, outils, gateway |
| Gateway | hermes gateway start | Messagerie |
| Agent | venv uv | Outils, sous-agents |
Documentation · Specs Mac mini.
Installation en 8 étapes
Étape 1 — Prérequis
macOS 13+, 16 Go RAM si Docker et gateway tournent ensemble. Installez les outils Xcode : xcode-select --install.
Étape 2 — Installateur officiel
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
Puis source ~/.zshrc. L'installateur ajoute uv, Python 3.11, Node, ripgrep, ffmpeg.
Étape 3 — Vérification
hermes doctor et hermes --version — corrigez PATH si command not found.
Étape 4 — Configuration initiale
hermes setup configure fournisseur LLM et clés. Raccourci Nous : hermes setup --portal (OAuth + Tool Gateway optionnel).
Étape 5 — Modèle et outils
hermes model puis hermes tools — n'activez que les toolsets nécessaires pour limiter le contexte.
Étape 6 — Test TUI
Lancez hermes, testez /model, /skills, /new, /usage sur une petite tâche.
Étape 7 — Passerelle (optionnel)
hermes gateway setup puis hermes gateway start. Consultez la doc messagerie.
Étape 8 — Migration OpenClaw
hermes claw migrate --dry-run puis hermes claw migrate si vous avez déjà OpenClaw.
Backends terminal
| Backend | Usage | Mac |
|---|---|---|
| local | Dev quotidien | Portable |
| docker | Sandbox | Docker Desktop |
| ssh | Exécution distante | Contrôle Mac mini/VPS |
| modal/daytona | Coût idle faible | Minimal |
Dépannage
hermes: command not found
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
Si le binaire manque, relancez l'installateur curl officiel.
hermes doctor signale Python/uv
curl -LsSf https://astral.sh/uv/install.sh | sh puis hermes update et hermes doctor.
Gateway connectée mais pas de réponse
Vérifiez le token bot, la liste blanche DM, les logs gateway. hermes gateway stop puis hermes gateway start.
Définition citable : Hermes Agent est un framework MIT avec mémoire persistante, skills agentskills.io, passerelles multi-plateformes et six backends terminal (local, Docker, SSH, Singularity, Modal, Daytona).
Mettez Docker Desktop à jour avec le backend docker. Centralisez cron et gateway dans ~/.hermes/ pour éviter des chemins dispersés.
Utilisez /usage dans le TUI avant d'activer tous les outils coûteux sur Telegram — les sessions longues consomment des tokens même sans location Mac dédiée.
Après l'étape 8, envoyez un message test sur Telegram et vérifiez que les outils streament dans les logs gateway. N'ouvrez Discord ou Slack qu'après ce test.
Le backend ssh convient si votre MacBook dort : le gateway peut rester local tandis que l'exécution se fait sur un Mac mini ou VPS toujours allumé — sans changer de fournisseur cloud.
hermes claw migrate --dry-run liste SOUL.md, MEMORY.md, skills et clés API importées depuis ~/.openclaw ; validez avant --overwrite.
Pour plusieurs projets, séparez les clés API et les répertoires de travail ; Hermes stocke l'index FTS5 sous ~/.hermes/ — désactivez iCloud Desktop pour cet utilisateur macOS.
La première semaine, limitez-vous au backend local pour comprendre skills et mémoire, puis passez à Docker ou SSH. hermes update puis hermes doctor après chaque mise à jour upstream.
Comparez Hermes avec OpenClaw et Superpowers comme couches complémentaires : canaux/runtime, puis discipline de code — pas des remplacements mutuels.
Fournisseurs, cron et skills
hermes model bascule entre Nous Portal, OpenRouter (200+ modèles), OpenAI, Anthropic, NVIDIA NIM et endpoints personnalisés — sans modifier le code. Documentez le modèle par défaut dans votre wiki d'équipe pour éviter les surprises de facturation.
Le planificateur cron intégré accepte des tâches en langage naturel avec livraison sur Telegram ou d'autres plateformes — idéal pour des rapports quotidiens ou des sauvegardes nocturnes sur un Mac qui ne dort pas.
Les skills suivent le standard agentskills.io. Après une tâche complexe, Hermes peut créer ou améliorer un skill ; l'index FTS5 permet de retrouver d'anciennes sessions. Honcho (modélisation utilisateur) s'active selon la configuration upstream.
Les sous-agents et scripts Python RPC permettent de paralléliser des flux sans exploser le contexte — utile sur Mac avec 16 Go de RAM si vous limitez le nombre de workers simultanés.
Pour la sécurité, consultez la doc approbation de commandes et appariement DM avant d'exposer le bot Telegram à un groupe large.
En migration OpenClaw, vérifiez que les skills importés dans ~/.hermes/skills/openclaw-imports/ ne dupliquent pas les skills Hermes natifs — renommez en cas de conflit.
Modal et Daytona offrent une mise en veille serveur entre les sessions ; sur un MacBook seul, le backend local reste le plus simple pour déboguer avant de déléguer à SSH ou au cloud.
Conservez la sortie de hermes doctor après chaque installation : c'est la référence la plus rapide quand un collègue reproduit le même Mac.
FAQ
hermes claw migrate.hermes gateway 24/7.hermes update puis hermes doctor.Lecture associée
Besoin d'un Mac toujours allumé ?
Mac mini ou SSH distant pour une passerelle 24/7—voir l'aide pour veille ou Mac cloud.
