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

DEV - 13/06
Un runbook pratique pour créer votre propre instance OpenClaw : un sujet Telegram qui pilote un agent de codage dans un volet tmux. Chemin heureux minimal, avec une porte de préparation difficile.

C’est le seul article de la série que vous faites, et pas seulement lisez. À la fin, vous aurez un seul sujet Telegram dans lequel vous tapez un message et un agent de codage répond et pilote un volet tmux sur votre propre boîte. C'est tout l'objectif, rien de plus. La mémoire, les moniteurs, les serveurs d'outils et le superviseur viennent tous plus tard ; aucun d’entre eux n’est nécessaire pour qu’un agent vous réponde.

Prévoyez environ 30 à 45 minutes. Si vous ne faites qu'une seule chose, suivez le chemin rapide, puis prouvez-le avec la porte de préparation. Tout ce qui se trouve sous la porte est une explication manuelle et un débogage que vous pouvez ignorer jusqu'à ce que vous en ayez besoin.

Conditions préalables (là où les configurations solo meurent)

Le câblage Telegram est la partie mécanique ; les véritables échecs se cachent dans l’État local. Confirmez chaque ligne avant de commencer :

  • Une boîte avec laquelle vous contrôleztmux, et un accès au shell qui survit aux déconnexions (vous laisserez une passerelle en cours d'exécution).
  • Un agent de codage travaillant déjà dans un volet tmux (opencode, Codex ou Claude Code) que vous pouvez piloter à la main dès maintenant. S'il n'est pas encore installé et authentifié, arrêtez-le et corrigez-le d'abord ; OpenClaw le pilote, il ne le remplace pas.
  • Une cible de volet stable et connue pour cet agent (par exemple,ma boîte:1.1). Écrivez-le ; vous le coderez en dur dans les instructions de l'agent.
  • La commande de lancement de votre agent : la commande exacte (ou le script wrapper) qui démarre l'agent de codage dans le volet, y compris la manière dont il reprend une session. Le flux de redémarrage d'OpenClaw a besoin de ce textuel.
  • Le runtime OpenClaw, épinglé (voir la matrice ci-dessous). La mauvaise version du nœud est l’échec silencieux le plus courant.
  • Un compte Telegram et l'application Telegram sur votre téléphone.

Matrice des versions

Épinglez-les. « Il fonctionne sur Node » ne suffit pas ; la passerelle est sensible au runtime.

ComposantVersion épingléeRemarques
Noeud.js24.11.1La passerelle est construite sur le nœud 24 ; les majors les plus récentes peuvent échouer à la version native.
Gestionnaire de paquetspnpm 11.2.2OpenClawgestionnaire de packageschamp.pack de basele récupère pour vous.
Griffe Ouvertegithub.com/openclaw/openclaw, commit épinglé (testé sur2026.5.27)Épinglez un commit ou un tag ; ne pas suivreprincipalpour une configuration, tout le monde doit reproduire.
Agent de codageopencode, installé et authentifiéÉpinglez la version sur laquelle votre équipe standardise.
Gestionnaire de nœudsnvmCe guide suppose que nvm ; adaptez les commandes si vous utilisez asdf ou system Node.

Chemin rapide

Deux scripts effectuent toute la configuration locale. Saisissez-les de l'essentiel, puis exécutez-les selon les étapes de Telegram :

# Téléchargez les scripts d'amorçage + préparation 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 # 1. Épinglez le runtime, récupérez + construisez OpenClaw et lancez la passerelle. # Passez votre token de bot pour également écrire une configuration minimale d'un seul coup : OPENCLAW_BOT_TOKEN="" OPENCLAW_BOT_ACCOUNT="my-bot" ./setup-openclaw.sh # 2. Effectuez les étapes Telegram dans "Côté Telegram" ci-dessous (BotFather + groupe + sujet), # puis ajoutez la liste verte + la route du sujet à partir de "Connectez-les ensemble". # 3. Prouvez que cela fonctionne : AGENT_ID=my-agent PANE=mybox:1...
[Courte citation de 8% de l'article original]