Agent Hermes
Ces dernières années, le domaine des agents IA s'est développé rapidement, évoluant de simples chatbots à des agents capables de réellement faire des choses, de disposer d'une mémoire persistante et de se développer de manière autonome.
Hermes Agent est un framework d'agent IA autonome rendu open source par Nous Research. En tant qu'agent IA autonome qui interagit en langage naturel, il peut exécuter des commandes terminal, contrôler un navigateur, lire et écrire des fichiers, rechercher sur Internet, générer des images et conserver la mémoire entre les sessions.
- Dépôt GitHub :https://github.com/nousresearch/hermes-agent
- Site officiel de Hermes Agent :https://hermes-agent.nousresearch.com/

La définition officielle est très simple :
The agent that grows with you. 一个会随着使用不断成长的 Agent。C'est un agent autonome qui devient plus capable au fur et à mesure qu'il fonctionne.
La philosophie centrale d'Hermes Agent est :Faire de l'IA un travailleur numérique à long terme et toujours actif, et non un chatbot jetable.
Hermes Agent est l'un des rares du secteurà être un agent IA doté d'une boucle d'apprentissage intégrée nativement, qui peut distiller des compétences à partir de l'expérience d'exécution, optimiser ses capacités de manière autonome, conserver les connaissances, récupérer les conversations historiques et affiner en continu le modèle cognitif de l'utilisateur au fil des sessions.
Différences avec les outils de chat IA classiques :
| Dimension | Chat IA classique (par ex., ChatGPT) | Agent Hermes |
|---|---|---|
| Mémoire | Chaque conversation démarre de zéro | Mémoire persistante entre les sessions ; vous comprend mieux au fur et à mesure que vous l'utilisez |
| Capacité d'exécution | Ne peut générer que du texte | Peut exécuter des commandes terminal, manipuler des fichiers, contrôler le navigateur |
| Emplacement d'exécution | Cloud, les données sont téléversées vers le fournisseur de services | Local ou votre propre serveur, les données ne vous quittent jamais |
| Extensibilité | Écosystème fermé | Standard ouvert de compétences (agentskills.io), écosystème MCP |
| Méthodes d'accès | Web | CLI + Telegram/Discord/Slack/WhatsApp, etc. |
| Liaison au modèle | Modèle fixe | Prend en charge 300+ modèles, changez à tout moment, sans verrouillage |
Fonctionnalités principales :
- Connexion :Telegram, Discord, Slack, WhatsApp, Signal, Email, CLI—un Agent, une mémoire unifiée, toutes les plateformes. Une conversation commencée sur Telegram peut se poursuivre sans interruption dans le terminal.
- Rappel :Hermes apprend vos projets, génère automatiquement des compétences et n'oublie jamais les problèmes qu'il a résolus. Après chaque session, les informations importantes sont écrites dans une mémoire persistante.
- Planification :Définissez des tâches planifiées en langage naturel—rapports quotidiens, sauvegardes, revues de routine, briefings matinaux—s'exécutant sans surveillance en arrière-plan.
- Déléguer :Générez des sous-agents isolés avec des contextes de conversation indépendants, des terminaux indépendants et des scripts RPC Python, permettant des pipelines parallèles avec un coût de contexte nul.
- Recherche et multimodal :Recherche web, automatisation du navigateur, compréhension visuelle, génération d'images, synthèse vocale et raisonnement multi-modèle—tout est intégré.
Hermes Agent prend en charge le basculement libre entre n'importe quel modèle majeur, y comprisNous Portal, OpenRouter (200+ modèles), OpenAI, GLM, Kimi, MiniMaxetc., exécutezhermes modelpour basculer instantanément, sans modification de code, sans dépendance à un fournisseur.
| Provider | Description | Méthode de configuration |
|---|---|---|
| Nous Portal | Basé sur l'abonnement, zéro configuration | viahermes modelConnexion OAuth |
| OpenAI Codex | ChatGPT OAuth, utilise le modèle Codex | viahermes modelAuthentification par code d’appareil |
| Anthropic | Utiliser directement le modèle Claude | Via l’authentification Claude Code ou une clé API Anthropic |
| OpenRouter | Routage multi-fournisseurs | Saisissez votre clé API |
| DeepSeek | Accès direct à l’API DeepSeek | ConfigurationDEEPSEEK_API_KEY |
| Hugging Face | Accéder à plus de 20 modèles ouverts via un routeur unifié | ParamètresHF_TOKEN |
| Point de terminaison personnalisé | VLLM, SGLang, Ollama ou toute API compatible OpenAI | Définir l'URL de base et la clé API |
Bien sûr, acheter quelque chose comme le Coding Plan reste le plus rentable, puisqu'il s'agit d'un abonnement mensuel :
| Fonctionnalités | Description des capacités |
|---|---|
| Interaction native avec le terminal | Interface TUI complète, prenant en charge l'édition multiligne, la complétion de commandes, le rappel de l'historique, la sortie en streaming, etc. |
| Accès multiplateforme | Une passerelle unique connectant CLI, Telegram, Discord, Slack, WhatsApp et d'autres plateformes |
| Système d'apprentissage en boucle fermée | Gestion autonome de la mémoire, génération et optimisation de compétences, rappel entre sessions, modélisation de l'utilisateur |
| Automatisation planifiée | Planificateur Cron intégré, prenant en charge des tâches automatisées 7×24 telles que les rapports quotidiens, les sauvegardes et les audits |
| Traitement parallèle des tâches | Prend en charge l’exécution parallèle de sous-agents, le fractionnement multi-workflow et les appels d’outils RPC |
| Fonctionnement multi-environnement | Prend en charge 6 backends, notamment local, Docker, SSH, Daytona, Modal, etc. |
| Capacités de niveau recherche | Prend en charge la génération de trajectoires, les environnements d’apprentissage par renforcement et la compression des données d’entraînement |
Architecture globale
Flux de travail global :

Schéma d’architecture :

| Module | Fonction | Exemple |
|---|---|---|
| Couche d’accès (Clients) | Reçoit les requêtes des utilisateurs | Web, App, API, Feishu |
| Couche d'entrée (Input) | Traite diverses données d'entrée | Texte, images, PDF, Excel |
| Ordonnanceur (Agent Orchestrator) | Comprend les tâches et décompose les flux de travail d'exécution | Analyser les exigences → Formuler un plan |
| Couche de capacités (Capabilities) | Fournit des capacités d'exécution | Dialogue, récupération, exécution de code |
| Couche de mémoire (Memory) | Enregistre le contexte et les informations historiques | Mémoire de session, mémoire à long terme |
| Couche de connaissances (Knowledge) | Fournit des capacités de récupération de connaissances | RAG, base de données vectorielle |
| Couche de modèles (Model Layer) | Fournit des capacités de raisonnement | GPT, Claude, modèles locaux |
| Couche d'outils (Tools) | Appelle des outils externes pour accomplir des tâches | Recherche, base de données, API |
| Services externes | Intégration avec les systèmes métiers | ERP, CRM, services cloud |
| Couche d'infrastructure (Infrastructure) | Assurer le fonctionnement du système. | Autorisations, journaux, supervision |
Installation rapide
Les commandes d'installation suivantes s'appliquent aux systèmes Linux, macOS et WSL2 :
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Une fois l'installation terminée, rechargez le Shell :
bashsource ~/.bashrc # 使用 bash # 或 source ~/.zshrc # 使用 zsh
Installation native Windows (PowerShell) :
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
La prise en charge native de Windows est encore expérimentale ; il est recommandé de privilégier l'utilisation de WSL2.
Version macOS / Windows Desktop (Desktop App) :Rendez-vous surhermes-agent.nousresearch.comTéléchargez l'installateur de bureau pour votre plateforme ; la CLI et l'application de bureau seront installées ensemble.


Vérifier l'installation
hermes --version
L'affichage du numéro de version indique que l'installation a réussi.
L'installateur gérera automatiquement toutes les dépendances :
- uvGestionnaire de paquets Python rapide
- Python 3.11— Installation via uv, aucun sudo requis.
- Node.js v22— Pour l'automatisation du navigateur et le pontage WhatsApp.
- ripgrepRecherche rapide de fichiers
- ffmpegConversion du format audio TTS

Instructions système Windows: : L'environnement Windows natif n'est pas pris en charge. Veuillez d'abord installer WSL2, puis exécuter la commande ci-dessus dans le terminal WSL2.
Si vous avez installé OpenClaw, vous pouvez également importer directement la configuration :

Définissez le nom du modèle, par exemple MiniMax-M2.5.Ici, choisissez de ne pas importer ; saisie.n, entrez les paramètres du modèle, sélectionnez le premier réglage rapide :

Ensuite, nous sélectionnons l'avant-dernier élément, Plus de fournisseurs :

Ici, vous pouvez choisir davantage de grands modèles nationaux ou internationaux :

Ensuite, nous utilisons.Byte Ark Coding Plan, donc ce qui a été choisi estpoint de terminaison personnaliséC'est-à-dire l'adresse API personnalisée et la clé API.
Base URL configure l'outil ByteDance Ark compatible avec le protocole d'interface OpenAI :https://ark.cn-beijing.volces.com/api/coding/v3
Définissez la clé API et les grands modèles pris en charge, par exempleark-code-latest。
Après l'installation, exécutez la commande suivante :
source ~/.bashrc # 重载shell配置(若使用zsh,执行:source ~/.zshrc) hermes # 开启智能体对话!

Démarrage rapide
hermes # 交互式命令行界面 — 开启对话 hermes model # 选择大语言模型服务商与对应模型 hermes tools # 配置启用的工具集 hermes config set # 设置单项配置项 hermes gateway # 启动消息网关(支持Telegram、Discord等平台) hermes setup # 运行全量配置向导(一站式完成所有配置) hermes claw migrate # 从OpenClaw迁移数据(适用于原OpenClaw用户) hermes update # 更新至最新版本 hermes doctor # 诊断运行环境与配置问题
Installation manuelle
Si vous préférez un contrôle total sur le processus d'installation, suivez ces étapes.
Étape 1 : Cloner le dépôt
Utiliser--recurse-submodulespour cloner et récupérer les sous-modules requis :
git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git cd hermes-agent
Si vous avez déjà cloné mais sans les sous-modules :
git submodule update --init --recursive
Étape 2 : Installer uv et créer un environnement virtuel
# 安装 uv(如果尚未安装) curl -LsSf https://astral.sh/uv/install.sh | sh # 创建 Python 3.11 的虚拟环境(uv 会在需要时下载,无需 sudo) uv venv venv --python 3.11
hermes. Le point d'entrée a un shebang codé en dur pointant vers le Python de l'environnement virtuel, il peut donc être utilisé après un lien global.Étape 3 : Installer les dépendances Python
# 告诉 uv 要安装到哪个虚拟环境 export VIRTUAL_ENV="$(pwd)/venv" # 安装所有扩展 uv pip install -e ".[all]"
Si vous ne voulez que l'agent principal (sans prise en charge de Telegram/Discord/cron) :
uv pip install -e "."
Remarques sur les extensions facultatives :
| Extension | Fonctionnalité | Commande d'installation |
|---|---|---|
all |
Inclut toutes les fonctionnalités suivantes | uv pip install -e ".[all]" |
messaging |
Passerelles Telegram et Discord | uv pip install -e ".[messaging]" |
cron |
Analyse des expressions Cron pour les tâches planifiées | uv pip install -e ".[cron]" |
voice |
Entrée microphone en CLI et lecture audio | uv pip install -e ".[voice]" |
mcp |
Prise en charge du Model Context Protocol | uv pip install -e ".[mcp]" |
honcho |
Mémoire native IA (intégration Honcho) | uv pip install -e ".[honcho]" |
Nous pouvons les utiliser en combinaison :uv pip install -e ".[messaging,cron]"
Étape 4 : Créer le répertoire de configuration
# 创建目录结构
mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}
# 复制示例配置文件
cp cli-config.yaml.example ~/.hermes/config.yaml
# 创建空的 .env 文件用于存储 API 密钥
touch ~/.hermes/.env
Étape 5 : Ajouter des clés API
Open~/.hermes/.envet ajoutez au moins une clé de fournisseur LLM :
# 必需 — 至少一个 LLM 提供商: OPENROUTER_API_KEY=sk-or-v1-your-key-here # 可选 — 启用其他工具: FIRECRAWL_API_KEY=fc-your-key # 网页搜索和抓取 FAL_KEY=your-fal-key # 图像生成(FLUX)
Ou définissez-la via la CLI :
hermes config set OPENROUTER_API_KEY sk-or-v1-your-key-here
Étape 6 : Ajouter hermes au PATH
mkdir -p ~/.local/bin ln -sf "$(pwd)/venv/bin/hermes" ~/.local/bin/hermes
Si~/.local/binn'est pas dans le PATH, veuillez l'ajouter à la configuration de votre shell :
# Bash echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc # Zsh echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
Étape 7 : Configurer votre fournisseur
hermes model # 选择您的 LLM 提供商和模型
Étape 8 : Vérifier l'installation
hermes version # 检查命令是否可用 hermes doctor # 运行诊断以验证一切正常 hermes status # 检查您的配置 hermes chat -q "Hello! What tools do you have available?"
Dépannage
| Problème | Solution |
|---|---|
hermes: command not found |
Rechargez le shell (source ~/.bashrc) ou vérifiez PATH |
| Clé API non définie | Exécutezhermes modelpour configurer le fournisseur, ouhermes config set OPENROUTER_API_KEY your_key |
| Configuration perdue après mise à jour | Exécutezhermes config checkpuishermes config migrate |
Pour plus d'informations de diagnostic, exécutezhermes doctor— il vous dira ce qui manque et comment le corriger.
Remarque :Vous pouvez toujours, via
hermes modelChangez de fournisseur—aucune modification de code, aucune dépendance.
Passerelle de messagerie
La passerelle de messagerie de l'agent Hermes vous permet d'interagir avec l'agent sur plusieurs plateformes—Telegram, Discord, Slack, WhatsApp, Signal, Email, Home Assistant, et plus encore.
Envoyez des messages vers 15+ plateformes depuis une seule passerelle. Restez connecté à Hermes où que vous soyez.
Plateformes prises en charge
| Plateforme | Description | Status |
|---|---|---|
| Telegram | L'intégration de plateforme de messagerie la plus complète | ✅ Pris en charge |
| Discord | Prend en charge les serveurs et les salons vocaux | ✅ Pris en charge |
| Slack | Intégration à l'espace de travail | ✅ Pris en charge |
| Via WhatsApp Web | ✅ Pris en charge | |
| Signal | Application de messagerie privée | ✅ Pris en charge |
| Matrix | Communication décentralisée | ✅ Pris en charge |
| Mattermost | Messagerie auto-hébergée | ✅ Pris en charge |
| E-mail SMTP | ✅ Pris en charge | |
| SMS | Envoi de SMS | ✅ Pris en charge |
| DingTalk | DingTalk | ✅ Pris en charge |
| Feishu | Feishu | ✅ Pris en charge |
| WeCom | WeCom | ✅ Pris en charge |
| BlueBubbles | iMessage sur macOS | ✅ Pris en charge |
| Home Assistant | Maison connectée | ✅ Pris en charge |
| Webhooks | Callback HTTP personnalisé | ✅ Pris en charge |
Configuration de la plateforme de messagerie
Configuration interactive :
hermes gateway setup
Cela lance un assistant de configuration interactif qui vous guide à travers la configuration de chaque plateforme.
Configuration manuelle :
Ou modifiez directement~/.hermes/config.yaml:
Telegram :
# 在 ~/.hermes/.env 中
TELEGRAM_BOT_TOKEN=your-bot-token
# config.yaml
gateway:
adapters:
telegram:
enabled: true
Discord :
# 在 ~/.hermes/.env 中
DISCORD_BOT_TOKEN=your-discord-token
# config.yaml
gateway:
adapters:
discord:
enabled: true
allowed_channels:
- "123456789"
Slack :
# 在 ~/.hermes/.env 中
SLACK_BOT_TOKEN=xoxb-your-token
SLACK_SIGNING_SECRET=your-signing-secret
# config.yaml
gateway:
adapters:
slack:
enabled: true
WhatsApp :
# WhatsApp 需要浏览器自动化
# 首次设置需要扫描二维码
# config.yaml
gateway:
adapters:
whatsapp:
enabled: true
session_dir: ~/.hermes/whatsapp/session
E-mail (SMTP) :
# 在 ~/.hermes/.env 中
SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USERNAME=your-email@gmail.com
SMTP_PASSWORD=your-app-password
# config.yaml
gateway:
adapters:
email:
enabled: true
from_email: your-email@gmail.com
Home Assistant :
# 在 ~/.hermes/.env 中
HA_URL=http://homeassistant.local:8123
HA_TOKEN=your-long-lived-access-token
# config.yaml
gateway:
adapters:
homeassistant:
enabled: true
Démarrage de la passerelle
Exécuter au premier plan :
hermes gateway
Exécuter en arrière-plan (recommandé) :
hermes gateway & # 或使用 systemd systemctl enable hermes-agent systemctl start hermes-agent
Exécuter avec Docker :
docker run -d \ --name hermes-gateway \ -v ~/.hermes:/home/hermes/.hermes \ ghcr.io/nousresearch/hermes-agent:latest \ hermes gateway
Configuration spécifique à la plateforme
Telegram :
- Créer un nouveau bot via @BotFather
- Obtenir le token du bot
- Configurer et exécuter Hermes
- Envoyer un message à votre bot dans Telegram
/start
Discord :
- Créer une application dans le portail des développeurs Discord
- Ajouter le bot à un serveur
- Obtenir le token du bot
- Configurer et exécuter Hermes
Slack :
- Créer une nouvelle application dans le portail des applications Slack
- Ajouter des portées de jeton de bot
- Installer dans l'espace de travail
- Configurer et exécuter Hermes
Envoyer des messages:
Utilisersend_messageoutil pour envoyer des messages via n'importe quel canal configuré:
send_message( platform="telegram", chat_id="123456789", message="Hello from Hermes!" )
Ou planifiez des messages automatisés via cron:
# 设置每日简报 hermes ❯ 每天早上9点检查 Hacker News 上的 AI 新闻,并通过 Telegram 给我发送摘要
Prise en charge vocale
Certaines plateformes prennent en charge l'interaction vocale:
- Telegram: messages vocaux et appels vocaux
- Discord: salons vocaux et messages vocaux
- CLI: entrée microphone et TTS
Pour plus de détails sur les modes vocaux, consultez le Guide des modes vocaux.
Considérations de sécurité
- Ne committez pas les clés API dans le contrôle de source
- Utilisez des variables d'environnement ou un stockage sécurisé des identifiants
- Limitez les utilisateurs/canaux autorisés à interagir avec l'agent
- Renouvelez régulièrement les clés API
- Activez l'approbation des commandes sur les plateformes publiques
Dépannage
| Problème | Solution |
|---|---|
| Le bot ne répond pas | Vérifiez si la passerelle est en cours d'exécution |
| Erreurs de permission | Vérifiez le jeton du bot et les permissions |
| Messages non envoyés | Vérifier l’ID du canal et la configuration |
| Expiration du délai de connexion | Vérifier les paramètres réseau et de pare-feu |
Autres extensionsAstuce :Utilisez
hermes gateway --verbosepour afficher les journaux détaillés afin de déboguer les problèmes.