# OpenClaw : ce que c’est, comment l’installer et le connecter à Telegram
> OpenClaw en termes simples : ce qu’est cet assistant IA personnel, comment l’installer sous Windows, macOS et Linux, choisir un modèle et le connecter à Telegram.
Source: https://ailoot.ai/blog/fr/openclaw-install-telegram/
Canonical: https://ailoot.ai/blog/fr/openclaw-install-telegram/
Language: fr
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-188
Revision: sha256-14760450bc147c21f789813bafd0cd2fc527a09afa943806261a116b4684c915
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](https://ailoot.ai/docs/).
## Qu’est-ce qu’OpenClaw, en termes simples ?
L’essentiel
OpenClaw est un assistant IA personnel open source qui fonctionne sur votre ordinateur ou votre serveur et répond dans les applications de messagerie que vous utilisez déjà : Telegram, WhatsApp, Discord, Slack et plus d’une douzaine d’autres. Techniquement, c’est une passerelle : un processus unique sur votre machine relie les applications de messagerie à un modèle — Claude, GPT, Gemini ou un modèle local. Le code est ouvert et l’outil est gratuit.
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](https://github.com/openclaw/openclaw) — 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 ?
L’essentiel
Claude Code est un outil de travail dans un dépôt ; il fonctionne dans le terminal et l’éditeur et est lié aux modèles d’Anthropic. OpenClaw est un assistant personnel dans une application de messagerie : il fonctionne avec n’importe quel modèle, se souvient de vous d’une conversation à l’autre et répond dans Telegram. Hermes Agent est celui dont la conception se rapproche le plus d’OpenClaw, mais il se concentre sur les compétences qui s’écrivent elles-mêmes.
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 :
| Fonctionnalité | OpenClaw | Claude Code | Hermes Agent |
|----|----|----|----|
| Où il fonctionne | Sur votre ordinateur ou serveur, comme passerelle pour les applications de messagerie | Terminal et éditeur | Sur votre ordinateur ou serveur |
| Modèles | Claude, GPT, Gemini, Qwen, modèles locaux et autres | Claude uniquement | N’importe lequel parmi vingt fournisseurs |
| Code | Open source | Code fermé | Open source, MIT |
| Coût de l’outil | Gratuit | Abonnement ou paiement par jeton | Gratuit |
| Applications de messagerie | Telegram, WhatsApp, Discord, Slack, iMessage et plus de 10 autres | Aucune | Telegram, Discord, Slack, WhatsApp et plus de 17 autres |
| Mémoire entre les conversations | Oui, fichiers Markdown dans l’espace de travail | Via un fichier CLAUDE.md | Oui, fichiers MEMORY.md et USER.md |
| Tâches planifiées | Intégrées | Non | Planificateur intégré |
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](https://ailoot.ai/blog/fr/hermes-agent-install-setup/).
Si vous êtes simplement en train de choisir un outil, commencez par cette vue d’ensemble : [avec quoi les gens codent en 2026](https://ailoot.ai/blog/fr/ai-coding-tools/) et [quelles tâches confier à un agent IA](https://ailoot.ai/blog/fr/business-tasks-for-ai-agents/). J’ai aussi un [article séparé](https://ailoot.ai/blog/fr/install-claude-code/) sur l’installation de Claude Code.
## De quoi avez-vous besoin avant d’installer OpenClaw ?
L’essentiel
Il vous faut trois choses : un ordinateur sous macOS, Linux ou Windows ; Node.js version 22.22.3 ou ultérieure (si vous ne l’avez pas, le programme d’installation le fera pour vous) ; et l’accès à un modèle — une clé API d’un fournisseur ou un modèle local via Ollama. Vous n’avez pas besoin de droits d’administrateur sous Windows pour utiliser l’application.
Vérifiez votre version de Node à l’avance : c’est la seule exigence stricte :
```bash
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 ?
L’essentiel
Une commande dans le terminal : curl -fsSL \| bash. Le script détecte votre système, installe Node.js s’il est absent, installe OpenClaw et lance l’assistant de configuration initiale. Si Node est déjà installé et que vous êtes habitué à npm, vous pouvez utiliser npm install -g openclaw.
La méthode recommandée consiste à utiliser le programme d’installation officiel :
1. ### Lancer le programme d’installation
```bash
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é
```bash
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 :
```bash
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 ?
L’essentiel
Sous Windows, il existe trois méthodes. La plus simple est l’application Windows Hub : téléchargez le programme d’installation depuis GitHub et exécutez-le ; les droits d’administrateur ne sont pas nécessaires. L’option en ligne de commande est le programme d’installation PowerShell, iwr -useb \| iex. Pour une compatibilité maximale avec la documentation, installez la passerelle dans WSL2.
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](https://github.com/openclaw/openclaw-windows-node/releases/latest) 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 :
```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 :
```powershell
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 ?
L’essentiel
Après l’installation, l’assistant openclaw onboard vous demandera de choisir un fournisseur de modèle et une clé. Pour une passerelle qui fonctionne en permanence, la documentation recommande une clé API : Anthropic, OpenAI ou Google. La clé est écrite dans le fichier ~/.openclaw/.env afin que le service d’arrière-plan puisse y accéder. Inspectez la configuration avec `openclaw models status`, puis testez une vraie réponse du modèle et, séparément, une réponse dans Telegram comme décrit plus bas. L’affichage de l’état ne prouve pas à lui seul le fonctionnement du parcours complet.
Le modèle est le moteur de l’assistant. L’assistant de configuration vous proposera une liste de fournisseurs ; voici trois options pratiques :
| Fournisseur | De quoi s’agit-il ? | Comment se connecter |
|----|----|----|
| Anthropic | Modèles Claude directement | Clé API ou connexion via une installation existante de Claude Code |
| OpenAI | Modèles GPT | Clé API ou connexion via un abonnement ChatGPT |
| Ollama / LM Studio | Modèles locaux sur votre matériel | Saisir l’adresse du serveur local ; voir la section suivante |
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 :
```bash
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 :
```bash
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 ?
L’essentiel
Créez un bot avec @BotFather et récupérez son jeton, saisissez le jeton dans les paramètres du canal Telegram, démarrez la passerelle et envoyez un message au bot. Il répondra à votre premier message avec un code d’association — approuvez-le avec la commande openclaw pairing approve. Les autres personnes ne recevront pas de réponse sans votre approbation.
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
```bash
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
```bash
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 {#comment-utiliser-openclaw-avec-un-modèle-local-via-ollama-}
L’essentiel
Installez Ollama depuis ollama.com/download, téléchargez un modèle (la documentation d’OpenClaw suggère gemma4), puis choisissez Ollama et Local only dans l’assistant openclaw onboard. Un serveur local n’a pas besoin de clé API. Important : OpenClaw appelle Ollama à son adresse native, sans le préfixe /v1 ; sinon, les appels d’outils ne fonctionnent plus.
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](https://ollama.com/download) — des versions existent pour macOS, Windows et Linux.
2. ### Télécharger un modèle
```bash
ollama pull gemma4
```
3. ### Connecter Ollama à OpenClaw
```bash
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
```bash
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 ?
L’essentiel
Le modèle de sécurité d’OpenClaw repose sur une personne de confiance par passerelle : c’est un assistant personnel conçu pour un seul propriétaire. Les mesures de base sont simples : gardez l’association par code activée, n’exposez pas la passerelle à l’Internet public, lancez le contrôle de sécurité intégré avec openclaw security audit et téléchargez OpenClaw uniquement depuis des adresses officielles.
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 :
```bash
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](https://openclaw.ai) ou [github.com/openclaw/openclaw](https://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 ?
L’essentiel
Une fois un canal connecté, l’assistant répond dans une application de messagerie, exécute des tâches planifiées, travaille avec les fichiers et le navigateur de votre machine, conserve sa mémoire à long terme dans des fichiers Markdown et peut être enrichi avec des compétences du catalogue. Ouvrez le tableau de bord Web avec la commande openclaw dashboard.
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 ?
L’essentiel
Trois problèmes couvrent presque tous les cas : la commande openclaw est introuvable (le chemin vers les paquets npm globaux n’est pas défini), l’assistant ne répond pas après la configuration (le modèle n’est pas configuré — vérifiez openclaw models status) ou le bot ne répond pas dans Telegram (l’association n’a pas été approuvée ou le jeton est incorrect). La commande de diagnostic polyvalente est openclaw doctor.
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 :
```bash
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 :
```bash
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 ?
L’essentiel
Réponses rapides aux questions courantes : OpenClaw est gratuit en tant qu’outil ; vous ne payez éventuellement que le modèle ; un serveur n’est nécessaire que pour un fonctionnement en continu ; Windows est pris en charge via l’application ou WSL2 ; et Clawdbot et Moltbot sont d’anciens noms du même projet.
### Foire aux questions
OpenClaw est-il gratuit ?
Oui. L’outil lui-même est open source et vous n’avez pas à payer pour l’utiliser sur un ordinateur ou un serveur. Les seuls coûts possibles concernent le modèle : une clé API d’un fournisseur est facturée selon l’utilisation réelle, tandis qu’un modèle local via Ollama est gratuit financièrement mais nécessite du matériel suffisamment puissant.
Dans quelle langue sont l’interface et la documentation d’OpenClaw ?
L’interface et la documentation sont en anglais.
Faut-il un serveur pour OpenClaw ?
Non, un ordinateur portable suffit pour un usage personnel. Un serveur est utile dans un seul cas : si vous voulez que l’assistant réponde dans Telegram et exécute des tâches planifiées lorsque votre ordinateur est éteint. La documentation propose des instructions prêtes à l’emploi pour Hetzner, Hostinger, DigitalOcean et une douzaine d’autres fournisseurs environ.
Qu’est-il arrivé à Clawdbot et à Moltbot ?
Ce sont d’anciens noms du même projet. En janvier 2026, Anthropic a demandé un changement de nom pour des raisons de marque. Le projet s’est appelé Moltbot pendant quelques jours, puis a adopté son nom définitif, OpenClaw, le 30 janvier 2026. Les anciennes instructions fonctionnent généralement encore, mais vérifiez les commandes et les adresses dans la documentation à jour.
OpenClaw est-il un virus ou une arnaque ?
Non : c’est un projet ouvert qui compte des centaines de milliers d’étoiles sur GitHub, et vous pouvez lire tout son code. Mais des escrocs profitent de sa popularité : de faux « jetons OpenClaw » et des sites frauduleux sont apparus à plusieurs reprises. Téléchargez-le uniquement depuis openclaw.ai ou le dépôt GitHub officiel, et n’oubliez pas : le projet n’a pas de cryptomonnaie.
### Sources
- [OpenClaw, site officiel](https://openclaw.ai)
- [OpenClaw, documentation](https://docs.openclaw.ai)
- [Installer OpenClaw](https://docs.openclaw.ai/install)
- [Démarrage rapide](https://docs.openclaw.ai/start/getting-started)
- [OpenClaw sous Windows](https://docs.openclaw.ai/platforms/windows)
- [Connecter Telegram](https://docs.openclaw.ai/channels/telegram)
- [Association et accès](https://docs.openclaw.ai/channels/pairing)
- [Modèles locaux](https://docs.openclaw.ai/gateway/local-models)
- [OpenClaw et Ollama](https://docs.openclaw.ai/providers/ollama)
- [Authentification des modèles](https://docs.openclaw.ai/gateway/authentication)
- [Sécurité de la passerelle](https://docs.openclaw.ai/gateway/security)
- [Historique du projet et des changements de nom](https://docs.openclaw.ai/start/lore)
- [Dépôt GitHub d’OpenClaw](https://github.com/openclaw/openclaw)
- [Versions de Windows Hub](https://github.com/openclaw/openclaw-windows-node/releases)
- [Télécharger Ollama](https://ollama.com/download)
Découvrez [Ailoot](https://ailoot.ai/).
## Questions fréquentes : OpenClaw : ce que c’est, comment l’installer et le connecter à Telegram
### Installer le démon maintient-il Telegram lorsque mon portable dort ?
Non. Le démarrage automatique relance la passerelle après redémarrage ou connexion si le service est autorisé. Répondre exige un hôte éveillé, une passerelle active et le réseau. Utilisez un hôte toujours allumé si le portable est éteint.
### Que vérifier si Telegram ne reçoit aucune réponse ?
Vérifiez le bot associé à votre jeton, la passerelle active et l’approbation de l’appairage. Vérifiez ensuite modèle et journaux : connexion du modèle et appairage Telegram sont deux étapes distinctes.
## Ailoot · L’entreprise et son portefeuille de projets
Ailoot s’appuie sur une expérience opérationnelle éprouvée, une large clientèle, un service stable et un suivi continu des KPI.
L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.
Ailoot met cette expérience opérationnelle au service de l’accès API aux fonctions d’IA dans les produits des clients, leurs agents, applications et automatisations.