OpenClaw : ce que c’est, comment l’installer et le connecter à Telegram

OpenClaw est apparu dans mon fil l’hiver dernier, lorsque le projet a changé deux fois de nom en une semaine et a gagné des centaines de milliers d’étoiles sur GitHub. Depuis, de plus en plus de personnes recherchent « openclaw installation » et « openclaw telegram ».

Ci-dessous, je passe en revue la documentation officielle : ce qu’est cet outil, en quoi il diffère de Claude Code, comment l’installer sous Windows, macOS ou Linux, choisir un modèle et connecter un bot Telegram. Je traite aussi séparément de la sécurité, car OpenClaw a été impliqué dans quelques incidents très médiatisés.

Découvrez comment utiliser le service dans la documentation Ailoot.

Qu’est-ce qu’OpenClaw, en termes simples ?#

OpenClaw relie un modèle IA à votre bot Telegram. Avec les outils et autorisations adaptés, il peut résumer des messages ou programmer un rappel. Le processus passerelle et sa configuration locale tournent sur votre ordinateur ou serveur. Cela ne rend pas toutes les conversations locales : avec un modèle cloud, la requête et le contexte pertinent sont envoyés au fournisseur. Via Ailoot, la requête passe par Ailoot puis par le fournisseur du modèle choisi. Une inférence locale exige un modèle local sans repli cloud ; les messages Telegram transitent toujours par Telegram et les outils activés peuvent contacter d’autres services.

Le projet est développé par la communauté open source d’OpenClaw. Le dépôt GitHub a été créé le 24 novembre 2025 et, au 22 août 2026, il compte 387 000 étoiles et 81 000 forks — l’un des projets ouverts à la croissance la plus rapide de l’année. Le langage utilisé est TypeScript.

Le projet a une histoire de noms amusante qu’il vaut mieux connaître pour ne pas être dérouté par les anciens articles. Il s’appelait d’abord Warelay, une passerelle pour WhatsApp. Puis il est devenu Clawdbot. En janvier 2026, Anthropic a demandé un changement de nom pour des raisons de marque, et le projet s’est appelé Moltbot pendant quelques jours. Le 30 janvier 2026, il a adopté son nom définitif : OpenClaw. Ainsi, si vous trouvez des instructions concernant « Clawdbot » ou « Moltbot », il s’agit du même projet ; ces articles ont simplement été écrits avant le changement de nom.

La mascotte du projet est Molty le homard, et la « mue » (le changement de carapace) est devenue la métaphore officielle de chaque changement de nom.

En quoi OpenClaw diffère-t-il de Claude Code et de Hermes Agent ?#

On me pose sans cesse des questions sur cette différence parce que, de l’extérieur, ils ressemblent tous à des « agents IA ». Voici un tableau comparatif :

Comment lire ce tableau ? J’utilise Claude Code pour le développement : il est particulièrement performant quand vous avez besoin d’un modèle puissant et travaillez avec du code. OpenClaw et Hermes servent à autre chose : un agent qui fonctionne en permanence, traîne dans Telegram, se souvient de la conversation d’hier et accomplit des tâches selon un calendrier. Le choix entre OpenClaw et Hermes est plus subtil ; il existe déjà un guide Hermes avec les étapes d’installation et de configuration.

Si vous êtes simplement en train de choisir un outil, commencez par cette vue d’ensemble : avec quoi les gens codent en 2026 et quelles tâches confier à un agent IA. J’ai aussi un article séparé sur l’installation de Claude Code.

De quoi avez-vous besoin avant d’installer OpenClaw ?#

Vérifiez votre version de Node à l’avance : c’est la seule exigence stricte :

node --version

Les versions 22.22.3+, 24.15+ et 25.9+ sont prises en charge ; Node 26 est recommandé. Si la commande renvoie « command not found » ou si la version est ancienne, ne vous inquiétez pas : le programme d’installation officiel téléchargera une version récente de Node pour vous, vous n’avez donc rien à installer manuellement.

La question restante concerne le modèle. OpenClaw ne réfléchit pas de lui-même : il appelle le modèle que vous choisissez. Voici les options de coût : une clé Anthropic, OpenAI ou Google — vous payez le fournisseur en fonction de l’utilisation réelle ; ou un modèle local via Ollama — gratuit financièrement, mais exigeant en matériel. Je présente les deux options ci-dessous dans des sections distinctes.

Comment installer OpenClaw sur macOS et Linux ?#

La méthode recommandée consiste à utiliser le programme d’installation officiel :

1. Lancer le programme d’installation

   curl -fsSL https://openclaw.ai/install.sh | bash
   

   Le script détecte votre système d’exploitation, vérifie la présence de Node (et l’installe si nécessaire), installe OpenClaw, puis ouvre l’assistant de configuration. Si vous voulez jeter un coup d’œil avant de lancer l’assistant, ajoutez l’option : bash -s -- --no-onboard.

2. Vérifier que tout est installé

   openclaw --version
   openclaw doctor
   openclaw gateway status
   

   La première commande affiche la version, la deuxième vérifie la configuration et la troisième confirme que la passerelle fonctionne et écoute sur le port 18789.

Si vous utilisez npm et souhaitez gérer vous-même l’installation :

npm install -g openclaw@latest --allow-scripts=openclaw
openclaw onboard --install-daemon

Il existe ici un piège récent, abordé dans un chapitre distinct de la documentation. npm 12 bloque par défaut les scripts d’installation des paquets et, sans l’option --allow-scripts=openclaw, l’installation s’arrêtera avec un message allowScripts. Avec npm 11.15 et les versions antérieures, cette option n’est pas nécessaire : cette restriction n’existe pas encore. Vérifiez votre version avec : npm --version.

L’option --install-daemon de la deuxième commande configure le démarrage automatique : un LaunchAgent sous macOS et un service systemd sous Linux. La passerelle démarre après un redémarrage ou une connexion, selon les conditions du gestionnaire de services. Cela n’empêche pas la veille et ne maintient rien quand l’ordinateur est éteint. Les réponses Telegram exigent un hôte éveillé, connecté et une passerelle active ; utilisez un serveur toujours allumé si le portable dort ou s’éteint.

Comment installer OpenClaw sous Windows ?#

La première option s’adresse aux personnes qui préfèrent Windows au terminal. Windows Hub est une application OpenClaw native pour Windows 10 (20H2+) et Windows 11, actuellement en version bêta. Rendez-vous sur la page des versions de Windows Hub et téléchargez le programme d’installation adapté à votre processeur : OpenClawCompanion-Setup-x64.exe pour les ordinateurs classiques, ou arm64 pour ARM. Une fois l’installation terminée, OpenClaw Companion apparaît dans le menu Démarrer, avec une icône dans la zone de notification, une fenêtre de discussion et des paramètres.

Au premier lancement, l’application propose « Set up locally » — acceptez. Elle créera un environnement WSL dédié appelé OpenClawGateway, y installera la passerelle et s’y connectera. Elle ne touchera pas à votre installation Ubuntu existante, si vous en avez une.

La deuxième option passe par PowerShell :

iwr -useb https://openclaw.ai/install.ps1 | iex
openclaw gateway install

La première ligne installe OpenClaw ; la deuxième configure le démarrage automatique avec le Planificateur de tâches Windows. Si la politique de votre ordinateur bloque la création de tâches, OpenClaw basculera automatiquement vers une solution de repli : un raccourci dans le dossier de démarrage, afin que la passerelle démarre lorsque vous ouvrez votre session.

La troisième option est WSL2, que la documentation qualifie d’environnement d’exécution le plus compatible sous Windows. Installez Ubuntu, activez systemd, puis suivez les instructions pour Linux de la section précédente :

wsl --install -d Ubuntu-24.04

Dans WSL, activez systemd dans /etc/wsl.conf (la section [boot], la ligne systemd=true), redémarrez WSL en exécutant wsl --shutdown depuis PowerShell, puis installez OpenClaw avec la commande Linux. Si les termes « distribution » et « systemd » ne vous disent rien, utilisez Windows Hub ; il s’occupe de tout cela pour vous.

Comment choisir un modèle et terminer la configuration initiale ?#

Le modèle est le moteur de l’assistant. L’assistant de configuration vous proposera une liste de fournisseurs ; voici trois options pratiques :

Voici un détail intéressant à propos d’Anthropic : si Claude Code est déjà installé sur votre machine et que vous y êtes connecté, OpenClaw peut utiliser cette connexion. Commencez par exécuter claude auth login sur la machine, puis indiquez à OpenClaw de l’utiliser :

openclaw models auth login --provider anthropic --method cli --set-default

Si la passerelle fonctionne comme service d’arrière-plan (ce qui est le cas avec --install-daemon), la clé doit être accessible au service. Pour cela, placez-la dans ~/.openclaw/.env — l’assistant s’en charge pour vous, vous n’avez donc pas besoin de modifier le fichier manuellement. Après toute modification, redémarrez et vérifiez :

openclaw gateway restart
openclaw models status

Si payer est difficile, un modèle local de la section Ollama est une solution adaptée.

Comment connecter OpenClaw à Telegram ?#

Telegram est le canal le plus rapide à connecter : il suffit d’un jeton de bot, sans vérification de compte professionnel. La documentation indique que c’est la façon la plus simple de commencer à échanger avec votre assistant depuis votre téléphone. Voici la procédure complète :

1. Créer un bot avec BotFather

   Ouvrez une discussion Telegram avec @BotFather (vérifiez qu’il s’agit bien de ce nom d’utilisateur exact — les faux comptes sont nombreux), envoyez /newbot, puis choisissez un nom et un nom d’utilisateur se terminant par bot. Vous recevrez en réponse un jeton du type 123456789:ABCdef... — c’est la clé de votre bot, alors gardez-la comme un mot de passe.

2. Saisir le jeton dans OpenClaw

   Le plus simple est de passer par l’assistant : exécutez openclaw configure et sélectionnez le canal Telegram. L’alternative manuelle consiste à utiliser le paramètre channels.telegram.botToken ou la variable d’environnement TELEGRAM_BOT_TOKEN. La documentation précise que la commande openclaw channels login telegram n’existe pas ; Telegram se connecte uniquement au moyen d’un jeton.

3. Démarrer la passerelle et envoyer un message au bot

   openclaw gateway
   

   Ouvrez votre bot dans Telegram et envoyez-lui un message. Il répondra avec un code d’association de huit caractères. C’est une mesure de protection : les messages ne seront pas traités tant que vous n’aurez pas approuvé l’expéditeur.

4. Vous approuver vous-même

   openclaw pairing list telegram
   openclaw pairing approve telegram CODE
   

   Le code est valable une heure, ne tardez donc pas trop. Le premier expéditeur approuvé devient automatiquement propriétaire des commandes privilégiées.

Il y a deux points délicats que les utilisateurs rencontrent souvent.

Le premier concerne les groupes. OpenClaw bloque tous les groupes par défaut : vous devez explicitement autoriser le bot dans le paramètre channels.telegram.groups et laisser le mode requireMention: true activé dans le groupe. Il ne répondra alors que lorsqu’on le mentionnera par son nom d’utilisateur, et ne s’immiscera pas dans la conversation générale. Telegram dispose aussi de son propre mode de confidentialité des bots : dans un groupe, un bot ne voit par défaut que les commandes. Désactivez-le avec /setprivacy via @BotFather. Après cette modification, vous devez retirer le bot du groupe puis l’y ajouter de nouveau ; sinon, Telegram n’appliquera pas le paramètre.

Le deuxième point consiste à ne pas ouvrir l’accès à tout le monde. Les paramètres comportent le mode dmPolicy: "open" avec un astérisque dans la liste d’accès : toute personne qui trouve le bot grâce à son nom d’utilisateur peut le commander. Pour un assistant personnel, c’est une façon directe de donner à quelqu’un d’autre le contrôle de votre machine. Laissez l’association par code activée ou saisissez votre identifiant numérique dans allowFrom.

Agent IA gratuit : utiliser OpenClaw avec Ollama en local#

Cette option garde l’inférence du modèle sur votre matériel si vous choisissez un parcours exclusivement local, sans bascule vers le cloud ; elle ne nécessite pas d’endpoint de modèle payant. Cela ne rend pas tout le parcours Telegram local : les messages passent toujours par Telegram et les outils en ligne activés peuvent transmettre des données à d’autres services.

1. Installer Ollama

   Téléchargez le programme d’installation depuis ollama.com/download — des versions existent pour macOS, Windows et Linux.

2. Télécharger un modèle

   ollama pull gemma4
   

3. Connecter Ollama à OpenClaw

   openclaw onboard
   

   Choisissez le fournisseur Ollama et un mode : Local only (vos propres modèles), Cloud only (modèles depuis ollama.com) ou Cloud + Local. L’assistant trouvera le serveur local et affichera les modèles installés.

4. Vérifier

   openclaw models list --provider ollama
   

Voici la réserve honnête sans laquelle cette section ressemblerait à une publicité. La documentation d’OpenClaw indique clairement qu’une utilisation confortable d’agents avec un modèle local exige du matériel équivalent à deux Mac Studios entièrement équipés, tandis qu’une carte graphique de 24 Go ne peut traiter que des requêtes légères, avec des délais. Les petits modèles fortement compressés tronquent le contexte et résistent moins bien aux instructions malveillantes dissimulées dans le texte de quelqu’un d’autre. En termes simples : un modèle local sur un bon ordinateur portable suffit pour « essayer et comprendre de quoi il s’agit », mais un modèle cloud reste bien plus fiable au quotidien avec un assistant qui utilise des outils.

Autre avertissement tiré de la documentation, à l’intention de ceux qui configurent WSL2 + Ollama + un GPU NVIDIA : le programme d’installation Linux officiel d’Ollama active le démarrage automatique avec une politique de redémarrage « always », et sous WSL2 avec un GPU cela peut entraîner la machine dans une boucle de redémarrage. La solution consiste à désactiver le démarrage automatique du service. Si cela vous arrive, consultez la section de dépannage de la page Ollama dans la documentation.

Est-il sûr d’exécuter OpenClaw ?#

Je commencerai par le point principal, que tout le monde ne comprend pas. OpenClaw a accès à votre machine : aux fichiers, aux commandes et au navigateur. La documentation le dit clairement : le projet est conçu pour un seul utilisateur de confiance, et vous ne devez pas donner à des personnes extérieures accès à votre bot. Si quelqu’un peut envoyer des messages à votre agent, cette personne peut s’en servir pour agir sur votre ordinateur.

Le minimum pratique :

1. Gardez l’association par code activée ou utilisez une liste d’accès — j’ai expliqué comment la configurer dans la section Telegram.
2. N’exposez pas la passerelle à l’extérieur sauf si vous en avez besoin. Par défaut, elle n’écoute que sur votre machine ; laissez-la ainsi.
3. Lancez le contrôle intégré après toute modification de configuration :

openclaw security audit

Il vérifie les accès ouverts, les autorisations d’outils trop larges, les jetons faibles et les ports exposés. Avec l’option --fix, certains problèmes peuvent être corrigés automatiquement.

Un mot à part sur les escroqueries — et ce n’est pas théorique. Quand le projet a changé de nom dans la précipitation en janvier 2026, des bots squatteurs se sont emparés des anciennes adresses en quelques secondes et y ont immédiatement publié un portefeuille crypto ; de faux « développeurs OpenClaw » ont commencé à promouvoir une escroquerie autour d’un jeton. Deux règles strictes en découlent. Téléchargez OpenClaw uniquement depuis openclaw.ai ou github.com/openclaw/openclaw. Et le projet n’a pas de cryptomonnaie : tout « jeton OpenClaw » est une escroquerie. Ne lui envoyez de l’argent sous aucun prétexte.

Que peut faire OpenClaw après l’installation ?#

Voici ce que j’essaierais, dans l’ordre :

1. Passerelle et modèle. Lancez openclaw gateway status, puis ouvrez openclaw dashboard. Le chargement du panneau confirme que Control UI est joignable. Dans son chat, envoyez « Réponds : model connection test » et vérifiez l’arrivée d’une réponse IA ; ouvrir la page ne teste pas le modèle.
2. Telegram et tâche prévue. Après configuration du bot et approbation de votre propre appairage, envoyez-lui un nouveau message dans Telegram et vérifiez la réponse dans Telegram. Essayez ensuite une tâche limitée avec un résultat visible, par exemple résumer un dossier de test sans risque dont vous avez autorisé la lecture. Pour un rappel, vérifiez séparément l’horaire enregistré et le rappel livré. Une réponse dans le tableau de bord ne prouve ni livraison Telegram ni exécution planifiée.
3. Tâches planifiées. L’assistant peut exécuter des tâches selon un calendrier — un résumé matinal dans Telegram, des vérifications régulières des e-mails. Voilà pourquoi vous laissez la passerelle fonctionner en continu.
4. Mémoire. OpenClaw conserve sa mémoire à long terme dans des fichiers Markdown ordinaires de son dossier de travail : qui vous êtes, comment vous répondre et ce qu’il a retenu des conversations précédentes. Vous pouvez ouvrir les fichiers et les lire vous-même — il n’y a pas de boîte noire.
5. Compétences. Le projet possède un catalogue de compétences et de plugins prêts à l’emploi, assortis de contrôles de sécurité intégrés. La compétence de quelqu’un d’autre, c’est du code appartenant à quelqu’un d’autre sur votre machine ; c’est pourquoi le catalogue les vérifie.

Voici une règle à suivre : ne mettez pas tout en route d’un coup. Commencez par une conversation stable, puis Telegram, puis les tâches planifiées. Chaque problème apparaîtra ainsi à sa propre étape au lieu de donner l’impression que « tout est cassé et que je ne sais pas pourquoi ».

Que faire en cas de problème d’installation ?#

Passons en revue trois situations courantes.

« openclaw: command not found » juste après l’installation. Il s’agit presque toujours d’un problème de chemin : le dossier des paquets npm globaux ne figure pas dans le PATH de votre terminal. Les commandes de diagnostic de la documentation sont :

node -v
npm prefix -g
echo "$PATH"

Le chemin renvoyé par la deuxième commande doit apparaître dans la troisième. Si ce n’est pas le cas, ajoutez-le à la configuration de votre shell ou fermez puis rouvrez simplement le terminal : parfois, le chemin Node n’apparaît dans une nouvelle session qu’après l’installation.

La passerelle fonctionne, mais l’assistant reste silencieux. Symptôme mentionné dans la FAQ de la documentation : aucune réponse au premier message, et le compteur de jetons est à zéro. Cela signifie que l’agent n’a même pas démarré — le plus souvent, le modèle n’est pas configuré. Vérifiez dans cet ordre :

openclaw gateway restart
openclaw status
openclaw models status

Si un modèle est configuré et qu’il n’y a toujours pas de réponse, openclaw logs --follow affichera le journal en direct et l’endroit où le processus bloque.

Le bot Telegram ne répond pas. Vérifiez dans cet ordre : le jeton appartient bien au bot auquel vous écrivez ; la passerelle fonctionne (openclaw gateway status) ; et votre association a été approuvée (openclaw pairing list telegram). Un code d’association est valable une heure — si vous avez écrit au bot hier, envoyez-lui simplement un nouveau message et approuvez le nouveau code.

Si vous êtes complètement bloqué, la documentation propose une solution inattendue mais sensée : transmettre les diagnostics à un agent IA local qui peut accéder à votre machine. Avec la sortie de openclaw status --all et de openclaw doctor, Claude Code ou Codex peut comprendre la configuration plus vite qu’un chat d’assistance. La boucle est bouclée : l’IA répare l’IA.

Quelles autres questions pose-t-on sur OpenClaw ?#

Découvrez Ailoot.