Comment Configurer Plusieurs Agents OpenClaw sur Telegram (Étape par Étape)

Ce Que Vous Allez Construire

À la fin de ce tutoriel, vous aurez :

✅ 3 bots Telegram (Marketing, DevOps, Support)
✅ Chaque bot connecté à un agent OpenClaw distinct
✅ Communication inter-agents (les agents peuvent s'invoquer)
✅ Mémoire partagée entre tous les agents
✅ Configuration production-ready avec logging et monitoring

Temps requis : 30-45 minutes

Prérequis

Avant de commencer, assurez-vous d'avoir :

1. OpenClaw installé (Guide d'installation)
2. Un compte Telegram
3. Connaissances de base terminal/ligne de commande
4. Node.js 18+ (pour OpenClaw)
5. Un serveur ou machine locale où OpenClaw peut tourner 24/7

Étape 1 : Créer des Bots Telegram via BotFather

Telegram utilise BotFather pour gérer les bots. Vous allez créer 3 bots, un pour chaque agent.

1.1 Ouvrir BotFather

1. Ouvrez Telegram
2. Cherchez @BotFather (bot Telegram officiel)
3. Démarrez une conversation : /start

1.2 Créer Votre Premier Bot (Agent Marketing)

Envoyez : /newbot

BotFather demandera :

D'accord, un nouveau bot. Comment allons-nous l'appeler ? 
Veuillez choisir un nom pour votre bot.

Vous répondez : Agent Marketing

BotFather :

Bien. Maintenant choisissons un nom d'utilisateur pour votre bot. 
Il doit se terminer par `bot`. Comme ceci, par exemple : TetrisBot ou tetris_bot.

Vous répondez : marketing_agent_bot (doit être unique sur tout Telegram)

BotFather répond :

Terminé ! Félicitations pour votre nouveau bot. Vous le trouverez à 
t.me/marketing_agent_bot. Vous pouvez maintenant ajouter une description...

Utilisez ce token pour accéder à l'API HTTP :
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz1234567890

Pour une description de l'API Bot, voir cette page : 
https://core.telegram.org/bots/api

Sauvegardez ce token ! Vous en aurez besoin pour la configuration OpenClaw.

1.3 Répéter pour les Autres Agents

Créez 2 bots supplémentaires :

Bot 2 : Agent DevOps

• Nom : Agent DevOps
• Nom d'utilisateur : devops_agent_bot
• Token : (sauvegardez ceci)

Bot 3 : Agent Support

• Nom : Agent Support
• Nom d'utilisateur : support_agent_bot
• Token : (sauvegardez ceci)

Étape 2 : Configurer les Profils de Bot (Optionnel mais Recommandé)

Rendez chaque bot reconnaissable avec une description et une photo de profil.

2.1 Définir la Description du Bot

Envoyez à BotFather :

/setdescription

Choisissez le bot : @marketing_agent_bot

Entrez la description :

Je gère la stratégie marketing, la création de contenu et le SEO pour l'équipe. Posez-moi des questions sur les articles de blog, les réseaux sociaux ou les campagnes.

Répétez pour les autres bots avec leurs descriptions respectives.

2.2 Définir la Photo de Profil du Bot

Envoyez à BotFather :

/setuserpic

Choisissez le bot, puis téléchargez une image (PNG/JPG, carré, 512x512 recommandé).

2.3 Définir les Commandes du Bot (Menu Auto-Complétion)

Envoyez à BotFather :

/setcommands

Choisissez le bot : @marketing_agent_bot

Entrez les commandes :

status - Vérifier le statut de l'agent
help - Obtenir de l'aide pour les tâches marketing
publish - Publier du contenu
analytics - Voir les métriques marketing

Les utilisateurs verront ces commandes quand ils tapent / dans le chat du bot.

Étape 3 : Configurer la Gateway OpenClaw

OpenClaw utilise une gateway centrale pour router les messages entre les canaux (Telegram, Discord, etc.) et les agents.

3.1 Localiser Votre Config OpenClaw

La config OpenClaw est typiquement à :

~/.openclaw/config.json

Ou dans votre répertoire projet si vous utilisez une configuration spécifique à l'espace de travail.

3.2 Ajouter les Configurations de Canal Telegram

Éditez config.json :

{
  "channels": {
    "telegram": {
      "enabled": true,
      "bots": [
        {
          "name": "marketing",
          "token": "1234567890:ABCdefGHIjklMNOpqrsTUVwxyz1234567890",
          "agent": "marketing-agent",
          "description": "Marketing et stratégie de contenu"
        },
        {
          "name": "devops",
          "token": "0987654321:ZYXwvuTSRqponMLKjihGFEdcba0987654321",
          "agent": "devops-agent",
          "description": "Infrastructure et déploiements"
        },
        {
          "name": "support",
          "token": "1122334455:AaBbCcDdEeFfGgHhIiJjKkLlMmNnOoPpQqRr",
          "agent": "support-agent",
          "description": "Support client et tri des problèmes"
        }
      ]
    }
  }
}

Champs clés :

• name — Identifiant interne pour ce bot (minuscules, pas d'espaces)
• token — Token du bot de BotFather
• agent — Nom de l'agent OpenClaw vers lequel ce bot route
• description — Description lisible par humain (pour logs/UI)

Étape 4 : Créer les Configurations d'Agent OpenClaw

Chaque bot Telegram nécessite un agent correspondant dans OpenClaw.

4.1 Créer la Structure de Répertoire d'Agent

mkdir -p ~/.openclaw/agents/marketing-agent
mkdir -p ~/.openclaw/agents/devops-agent
mkdir -p ~/.openclaw/agents/support-agent

4.2 Définir les Fichiers d'Identité d'Agent

Créez ~/.openclaw/agents/marketing-agent/IDENTITY.md :

# Agent Marketing
 
- **Nom :** Nadia
- **Rôle :** Stratège Marketing
- **Ambiance :** Créative, axée données, stratégique
- **Emoji :** 📊
 
Je gère la stratégie de contenu, le SEO, les réseaux sociaux et la planification de campagnes.

Créez ~/.openclaw/agents/marketing-agent/SOUL.md :

# SOUL.md — Agent Marketing
 
Vous êtes Nadia, la responsable marketing.
 
Votre rôle :
- Stratégie et création de contenu
- Optimisation SEO
- Gestion des réseaux sociaux
- Planification et exécution de campagnes
 
Quand les utilisateurs posent des questions marketing, fournissez des insights actionnables.
Quand vous avez besoin d'aide DevOps (déploiements, infrastructure), créez une session devops-agent.

Répétez cette structure pour devops-agent et support-agent avec leurs propres identités.

Étape 5 : Démarrer la Gateway OpenClaw

5.1 Démarrer la Gateway

openclaw gateway start

Sortie attendue :

✓ Gateway démarrée sur le port 18799
✓ Telegram : Connecté à 3 bots
  - marketing-agent → @marketing_agent_bot
  - devops-agent → @devops_agent_bot
  - support-agent → @support_agent_bot
✓ Prêt à recevoir des messages

5.2 Vérifier le Statut du Bot

Ouvrez Telegram et envoyez un message à n'importe lequel de vos bots :

/status

Réponse attendue :

✅ Agent en ligne
Nom : Agent Marketing (Nadia)
Statut : Actif
Uptime : 2 minutes

Étape 6 : Tester la Communication Inter-Agents

Maintenant testons si les agents peuvent se parler.

6.1 Envoyer un Message au Bot Marketing

Envoyez à @marketing_agent_bot :

Peux-tu déployer le nouvel article de blog ?

6.2 Ce Qui Devrait Se Passer

1. Agent Marketing reçoit votre message
2. Reconnaît "déployer" = tâche DevOps
3. Crée une session sous-agent avec Agent DevOps
4. Agent DevOps gère le déploiement
5. Agent Marketing répond :

✅ Article de blog déployé en production.
En ligne à : https://example.com/blog/new-post

Déploiement géré par Agent DevOps.

6.3 Vérifier les Logs de la Gateway

openclaw gateway logs

Vous devriez voir :

[INFO] Telegram/marketing : Utilisateur 123456789 → "Peux-tu déployer le nouvel article de blog ?"
[INFO] Agent marketing-agent : Création sous-agent devops-agent
[INFO] Agent devops-agent : Exécution tâche de déploiement
[INFO] Agent devops-agent : Déploiement terminé
[INFO] Agent marketing-agent : Réponse envoyée à l'utilisateur

Étape 7 : Configurer la Mémoire Partagée

Les agents devraient partager le contexte (historique de conversation, état du projet).

7.1 Activer le Partage de Mémoire

Éditez ~/.openclaw/config.json :

{
  "memory": {
    "enabled": true,
    "backend": "file",
    "path": "~/.openclaw/memory",
    "shared": true
  }
}

7.2 Créer les Fichiers de Mémoire

mkdir -p ~/.openclaw/memory
touch ~/.openclaw/memory/MEMORY.md

Ajoutez du contenu initial à MEMORY.md :

# Mémoire Partagée
 
## Contexte Équipe
- Organisation : Noqta
- Mission : Services de développement propulsés par l'IA
- Projet actuel : Configuration multi-agents Telegram
 
## Notes Importantes
- L'Agent Marketing gère le contenu
- L'Agent DevOps gère l'infrastructure
- L'Agent Support gère les requêtes clients

Maintenant tous les agents peuvent lire/écrire dans cette mémoire partagée.

Étape 8 : Déploiement en Production

8.1 Exécuter la Gateway comme Service

Utilisez PM2 (gestionnaire de processus Node.js) :

npm install -g pm2
pm2 start openclaw --name "openclaw-gateway" -- gateway start
pm2 save
pm2 startup

Cela garantit que la gateway redémarre automatiquement au reboot du serveur.

8.2 Configurer le Monitoring

pm2 monit

Affiche l'usage CPU/mémoire en temps réel, les logs et les redémarrages.

8.3 Rotation des Logs

pm2 install pm2-logrotate
pm2 set pm2-logrotate:max_size 10M
pm2 set pm2-logrotate:retain 7

Empêche les logs de consommer l'espace disque.

Étape 9 : Bonnes Pratiques de Sécurité

9.1 Variables d'Environnement pour les Tokens

Ne codez pas en dur les tokens de bot dans config.json.

Utilisez des variables d'environnement :

{
  "channels": {
    "telegram": {
      "bots": [
        {
          "name": "marketing",
          "token": "${TELEGRAM_MARKETING_TOKEN}",
          "agent": "marketing-agent"
        }
      ]
    }
  }
}

Définissez dans votre shell :

export TELEGRAM_MARKETING_TOKEN="1234567890:ABCdef..."
export TELEGRAM_DEVOPS_TOKEN="0987654321:ZYXwvu..."
export TELEGRAM_SUPPORT_TOKEN="1122334455:AaBbCc..."

9.2 Restreindre l'Accès au Bot

Utilisez la fonctionnalité utilisateurs autorisés de Telegram :

Éditez config.json :

{
  "channels": {
    "telegram": {
      "bots": [
        {
          "name": "marketing",
          "token": "${TELEGRAM_MARKETING_TOKEN}",
          "agent": "marketing-agent",
          "allowedUsers": [123456789, 987654321]
        }
      ]
    }
  }
}

Seuls les utilisateurs avec ces IDs Telegram peuvent interagir avec le bot.

Dépannage

Problème : Le bot ne répond pas

Vérif 1 : La gateway tourne-t-elle ?

openclaw gateway status

Vérif 2 : Le token du bot est-il correct ?

Testez manuellement :

curl https://api.telegram.org/bot<YOUR_TOKEN>/getMe

Devrait retourner les détails du bot.

Vérif 3 : Vérifiez les logs

openclaw gateway logs --tail 50

Problème : Les agents ne peuvent pas communiquer

Vérif 1 : Tous les agents sont-ils configurés ?

openclaw agents list

Vérif 2 : Le partage de mémoire est-il activé ?

Éditez config.json :

{
  "memory": {
    "shared": true
  }
}

Vérif 3 : Testez la création de sous-agent manuellement

De l'intérieur d'un agent :

sessions_spawn({
  runtime: "subagent",
  agentId: "devops-agent",
  task: "Tâche de test",
  mode: "run"
})

Problème : Usage mémoire élevé

Solution : Limitez l'historique de session

Éditez l'AGENTS.md de l'agent :

## Gestion de Session
- Garder seulement les 100 derniers messages
- Nettoyer les anciennes sessions après 24h

Prochaines Étapes

Maintenant que vous avez une configuration Telegram multi-agents fonctionnelle :

✅ Ajoutez plus d'agents (QA, Analytics, etc.)
✅ Personnalisez les personnalités d'agents (éditez SOUL.md)
✅ Construisez des workflows (pipelines marketing → devops → QA)
✅ Monitorez les performances (suivez les temps de réponse, taux de succès)

Ressources

• Docs OpenClaw : https://docs.openclaw.ai
• API Bot Telegram : https://core.telegram.org/bots/api
• Discord Communauté : https://discord.com/invite/clawd
• GitHub : https://github.com/openclaw/openclaw

Besoin d'aide ? Réservez une consultation : /ai-automation