Ce guide de configuration fournit une procédure détaillée pour installer Hermes Agent sur un serveur Linux et le connecter à un bot IA d'Enterprise WeChat. Il couvre l'ensemble du processus, depuis la préparation de l'environnement jusqu'au démarrage du service.

Présentation de Hermes Agent

Hermes Agent est un agent open-source développé par Nous Research. Il dispose de fonctionnalités telles qu'une boucle d'apprentissage automatique, une prise en charge de multiples plateformes de messagerie, et la compatibilité avec divers fournisseurs de modèles de langage. Ce guide se concentre sur son intégration via WebSocket avec le bot IA d'Enterprise WeChat, une méthode qui ne nécessite pas d'adresse IP publique.

Prérequis du système

Un système d'exploitation Linux (Ubuntu 20.04 ou supérieur recommandé), macOS ou WSL2 est requis. Python 3.11 ou une version ultérieure doit être installé. Vous aurez également besoin d'un accès réseau à PyPI et GitHub, ainsi que des droits d'administrateur dans le back-office d'Enterprise WeChat pour créer un bot IA.

Pour vérifier votre environnement, exécutez :

python3 --version
which uv

Si le gestionnaire de paquets uv n'est pas présent, installez-le avec :

curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc

Obtention du code source

La méthode recommandée est une copie superficielle du dépôt pour économiser du temps et de l'espace :

cd ~
git clone --depth 1 https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

Une alternative consiste à utiliser le script d'installation officiel :

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Configuration de l'environnement Python

Créez et activez un environnement virtuel, puis installez les dépendances requises. L'utilisation d'un miroir PyPI local peut accélérer le processus :

cd ~/hermes-agent
uv venv .venv
source .venv/bin/activate

uv pip install -e ".[messaging,cron,cli,pty,mcp,dev]" \
  -i https://pypi.tuna.tsinghua.edu.cn/simple/ \
  --trusted-host pypi.tuna.tsinghua.edu.cn

Pour vérifier l'installation du support d'Enterprise WeChat :

python -c "from gateway.platforms.wecom import check_wecom_requirements; print('OK:', check_wecom_requirements())"

Configuration du fournisseur de modèle de langage

Hermes Agent nécessite un fournisseur de LLM. Éditez le fichier .env à la racine du projet pour définir la clé API. Par exemple, pour utiliser Zhipu AI :

# .env
GLM_API_KEY=votre_cle_api_zhipu

Ensuite, configurez le modèle par défaut dans ~/.hermes/config.yaml :

model:
  default: glm-5-turbo
  provider: zai

D'autres fournisseurs comme OpenRouter, Anthropic, OpenAI ou Minimax sont également supportés en configurant leurs variables d'environnement respectives dans le fichier .env.

Configuration du bot IA d'Enterprise WeChat

Tout d'abord, créez un bot dans le back-office d'Enterprise WeChat sous la secsion "Applications" ou "AI Assistant". Notez son ID et son Secret.

Ajoutez ensuite ces informations de connexion dans le fichier .env :

# .env
WECOM_BOT_ID=votre_bot_id
WECOM_SECRET=votre_secret
WECOM_HOME_CHANNEL=votre_id_utilisateur    # Optionnel

L'URL du WebSocket par défaut (wss://openws.work.weixin.qq.com) convient pour une connexion directe en Chine. Vous pouvez aussi définir ces paramètres dans ~/.hermes/config.yaml sous la clé platforms.wecom.

Vérifiez la configuration avec la commande de diagnostic :

hermes doctor

Démarrage de la passerelle

Avec l'environnement virtuel activé, lancez la passerelle qui gère les connexions aux plateformes de messagerie :

source .venv/bin/activate
hermes gateway

Un menu interactif proposera de lancer le service au premier plan. Une fois connecté, le journal afficehra un message de succès de connexion WebSocket. Vous pourrez alors démarrer une conversation avec votre bot dans l'application Enterprise WeChat.

Pour un lancement simplifié, vous pouvez créer un script launch.sh :

#!/bin/bash
cd ~/hermes-agent
source .venv/bin/activate
hermes gateway

Résolution des problèmes courants

Clonage du dépôt lent : Utilisez l'option --depth 1 pour une copie superficielle beaucoup plus rapide.

Dépassement du délai sur PyPI : Spécifiez un miroir fiable comme celui de Tsinghua lors de l'installation des paquets.

Commande de démarrage système : L'utilisation de hermes gateway start nécessite que l'unité de service soit préalablement installée. Pour un premier démarrage, hermes gateway est suffisant.

Commandes utiles

Comparaison des modes d'intégration avec Enterprise WeChat

Hermes Agent supporte deux modes de connexion à Enterprise WeChat :

Pour configurer le mode callback, définissez les variables d'environnement correspondantes dans .env, notamment l'ID de votre entreprise, le Secret de l'application, l'ID de l'agent, ainsi que le Token et la clé de chiffrement pour la validation des messages.