Comment installer OpenClaw et le connecter à Telegram
Comptez environ une demi-heure pour passer d’une machine vierge à un agent qui vous répond dans Telegram. Les commandes indiquées proviennent de la documentation officielle : vérifiez-les par rapport à la version que vous installez.
Ce qu’il vous faut
- Un ordinateur ou un VPS sous macOS, Linux, WSL2 ou Windows
- Node 24.16+ ou Node 26, que l’installateur peut ajouter pour vous
- Une clé API ou un abonnement donnant accès à un modèle, ou un modèle local
- Un compte Telegram
Étape par étape
-
Choisir une machine et créer un bot
Un ordinateur portable convient pour un essai. Pour un agent qui fonctionne en permanence, préférez un petit VPS ou un serveur domestique ; le port de la passerelle ne doit jamais être exposé à Internet. Dans Telegram, vérifiez soigneusement le nom d’utilisateur de @BotFather, envoyez-lui un message, exécutez /newbot et copiez le jeton fourni.
-
Installer OpenClaw
Exécutez l’installateur officiel correspondant à votre système. Il détecte le système d’exploitation, ajoute Node s’il est absent, installe OpenClaw, puis lance la configuration initiale.
# macOS / Linux / WSL2 curl -fsSL https://openclaw.ai/install.sh | bash # Windows (PowerShell) iwr -useb https://openclaw.ai/install.ps1 | iex
-
Effectuer la configuration initiale et installer le service de passerelle
Choisissez Quick start pour réutiliser l’accès à l’IA détecté, ou Custom setup pour configurer chaque option. Une fois la configuration terminée, arrêtez la passerelle qui s’exécute au premier plan, puis installez-la comme service en arrière-plan afin qu’elle redémarre après un redémarrage de la machine.
openclaw onboard # after the quick start, stop the foreground gateway (Ctrl+C), then: openclaw gateway install
-
Ajouter le canal Telegram
Ajoutez Telegram comme canal à l’aide du jeton de votre bot. Vérifiez ensuite l’état du canal pour confirmer que la connexion fonctionne.
openclaw channels add --channel telegram --token <bot-token> openclaw channels status --probe
-
Approuvez votre demande d’association
Envoyez n’importe quel message à votre bot. Les expéditeurs inconnus reçoivent un code d’association au lieu d’une réponse. Affichez les demandes en attente et approuvez votre propre code dans l’heure.
openclaw pairing list telegram openclaw pairing approve telegram <CODE>
-
Effectuez un audit et une mise à jour
Lancez l’audit de sécurité intégré et effectuez la mise à jour depuis le canal stable. Les versions antérieures à 2026.4.22 présentent des vulnérabilités critiques connues : ne conservez jamais une telle version.
openclaw security audit openclaw update --channel stable
Premières choses à faire après la configuration
- Laissez dmPolicy sur pairing afin que les inconnus qui trouvent votre bot ne puissent pas l’utiliser.
- Configurez les approbations d’exécution pour qu’une confirmation soit toujours demandée, jusqu’à ce que vous ayez confiance en votre configuration.
- Répétez régulièrement l’audit de sécurité et la mise à jour.
Erreurs fréquentes
- Exposer le port de la passerelle au lieu de laisser gateway.bind sur loopback et de se connecter via SSH ou Tailscale.
- Installer trop de compétences tierces : considérez-les comme des extensions de navigateur et n’en ajoutez que quelques-unes provenant de sources fiables.
- Oublier qu’un agent bloqué dans une boucle continue de consommer des jetons de modèle.