Agents de codage sur Telegram : de zéro à un agent qui répond

Arrêtez de lire et passez à l'action.

À la fin de ce guide, vous aurez un sujet (topic) Telegram où un agent de codage répondra à vos messages. Cet agent pilotera un volet tmux sur votre propre machine.

C'est l'objectif central. Vous n'avez pas encore besoin de mémoire, de moniteurs ou de serveurs d'outils. Il vous suffit de faire en sorte que l'agent vous réponde.

⏱️ Temps nécessaire : 30 à 45 minutes.

🛠️ Prérequis

Avant de commencer, assurez-vous d'avoir les éléments suivants prêts :

  • Une machine avec tmux et un accès au shell.
  • Un agent de codage fonctionnel (comme OpenCode ou Claude Code) déjà en cours d'exécution dans un volet tmux.
  • La cible tmux exacte pour votre agent (exemple : mybox:1.1).
  • La commande exacte pour lancer votre agent.
  • Le runtime OpenClaw installé.
  • Un compte Telegram et l'application Telegram.

📦 Versions requises

Ne sautez pas ces étapes. Les mauvaises versions provoquent des échecs silencieux.

• Node.js : 24.11.1 • Gestionnaire de paquets : pnpm 11.2.2 • OpenClaw : Fixez à un commit spécifique.

🚀 Chemin de configuration rapide

Vous pouvez utiliser ces scripts pour gérer la configuration locale :

  1. Téléchargez les scripts : curl -fsSL "https://gist.githubusercontent.com/jerilkuriakose/cd0f8353aac74e47c591111b758943e9/raw/setup-openclaw.sh" -o setup-openclaw.sh curl -fsSL "https://gist.githubusercontent.com/jerilkuriakose/7cf94af3e96526f9f14d0c28b6c26b69/raw/ready-check.sh" -o ready-check.sh chmod +x setup-openclaw.sh ready-check.sh

  2. Lancez la configuration avec votre jeton de bot : OPENCLAW_BOT_TOKEN="<YOUR_TOKEN>" OPENCLAW_BOT_ACCOUNT="my-bot" ./setup-openclaw.sh

  3. Vérifiez la configuration : AGENT_ID=my-agent PANE=mybox:1.1 ./ready-check.sh

📱 Configuration Telegram

Suivez ces étapes dans votre application Telegram :

  • Créez un bot via @BotFather et enregistrez le jeton.
  • Créez un nouveau groupe et ajoutez votre bot.
  • Nommez le bot administrateur. Cela lui permet de voir vos messages.
  • Activez les « Sujets » (Topics) dans les paramètres du groupe.
  • Créez un sujet pour votre projet.
  • Envoyez un message dans ce sujet pour générer un Topic ID dans vos journaux (logs).

⚙️ Mise en relation

La passerelle utilise une configuration JSON située dans ~/.openclaw/openclaw.json.

Utilisez la Phase 1 pour trouver votre Chat ID et votre Topic ID en envoyant un message et en vérifiant les journaux de la passerelle.

Utilisez la Phase 2 pour sécuriser le groupe. Modifiez la politique en « allowlist » et ajoutez uniquement votre ID utilisateur Telegram numérique. Associez votre Topic ID à votre Agent ID spécifique.

📝 Le contrat de l'agent

Créez un fichier AGENTS.md dans l'espace de travail de votre agent. Ce fichier indique à l'agent comment se comporter. Vous devez définir :

  • Comment lire le volet (tmux capture-pane).
  • Comment écrire dans le volet (tmux send-keys).
  • Comment gérer des commandes spécifiques telles que « status », « send » ou « restart ».

✅ Le test de préparation

Vous n'avez terminé que lorsque vous avez réussi ces cinq vérifications :

  1. Le bot répond dans votre sujet Telegram.
  2. Votre prompt atteint le volet tmux.
  3. L'agent de codage commence à travailler sur le prompt.
  4. Un fichier journal prouve que l'agent a traité votre sujet.
  5. Le groupe est verrouillé pour votre seul ID utilisateur.

Source : https://dev.to/jerilk/coding-agents-over-telegram-part-2-from-zero-to-an-agent-that-answers-2777

Communauté d'apprentissage optionnelle : https://t.me/GyaanSetuAi