Installer OpenClaw : la procédure à jour, de Node à Telegram

Pour installer OpenClaw sur macOS, Linux ou WSL2, lance le script officiel curl -fsSL https://openclaw.ai/install.sh | bash ; sous Windows, passe par l'application Windows Hub. Le script installe Node si besoin, puis OpenClaw, puis lance la configuration. Au 28 septembre 2026 (version 2026.9.6), il faut Node 24.16+ ou 26.1+. Installe ensuite le service et vérifie qu'il tourne.

Les six étapes, dans l'ordre

Commandes et sorties attendues viennent de la documentation d'installation et du guide de démarrage, relus le 28 septembre 2026 ; la procédure n'a pas été rejouée pour l'article. Elle vise ton propre ordinateur ; le serveur est traité plus bas.

1. Vérifie ta version de Node

Lance node --version. OpenClaw accepte Node 24 à partir de 24.16 et Node 26 à partir de 26.1 ; Node 22, 23 et 25 ne sont pas pris en charge. Si Node manque, le script l'installe. Si ton Node est trop ancien, mets-le à jour avant de continuer. Attention : la page française de la documentation, traduite automatiquement le 16 juillet 2026, cite encore Node 22 et 25. En cas d'écart, suis la page anglaise.

2. Lance le script, après un essai à blanc

La commande de l'introduction exécute le script dès son téléchargement. Pour voir d'abord ce qu'il fera, enregistre-le : l'option --dry-run affiche le plan d'installation sans rien modifier et se termine par Dry run complete (no changes made).

curl -fsSL https://openclaw.ai/install.sh -o install-openclaw.sh
bash install-openclaw.sh --dry-run
bash install-openclaw.sh

Sous Windows, Windows Hub s'installe sans droits d'administrateur ; son option Set up locally crée une distribution WSL réservée à OpenClaw, et son Command Center affiche ensuite la connexion et l'état des canaux. La voie PowerShell (iwr -useb https://openclaw.ai/install.ps1 | iex) existe aussi. Le reste de l'article décrit la voie en ligne de commande.

3. Fais la configuration initiale

Le script ouvre l'assistant, en anglais (il ne propose que l'anglais et le chinois). Choisis Quick start : il te propose les accès au modèle qu'il détecte (connexion à Claude Code ou à Codex CLI, clé API), vérifie celui que tu choisis par une vraie requête, enregistre la configuration et ouvre le tableau de bord. Si aucun accès détecté ne fonctionne, il ouvre la configuration manuelle du fournisseur. Regarde quel compte sera facturé avant de valider.

4. Installe le service

Après Quick start, la passerelle (le programme qui reçoit les messages et fait tourner l'agent) tourne dans ton terminal et s'arrête avec lui. Appuie sur Ctrl+C, puis lance openclaw gateway install : la commande la fait tourner en arrière-plan, avec un LaunchAgent sur macOS, un service systemd sur Linux et WSL2, une tâche planifiée sous Windows. Ta configuration est conservée.

5. Vérifie l'installation

Lance ces trois commandes :

openclaw --version
openclaw doctor
openclaw gateway status

La première affiche la version, la deuxième ne doit signaler aucune erreur bloquante, la troisième doit montrer Runtime: running, Connectivity probe: ok et une passerelle à l'écoute sur le port 18789. Lance ensuite openclaw dashboard et écris un message dans le chat du tableau de bord : si le modèle répond, l'installation fonctionne.

6. Connecte Telegram

Ouvre une conversation avec @BotFather (vérifie le nom exact), envoie /newbot et garde le jeton fourni. Ajoute-le, puis contrôle le canal :

openclaw channels add --channel telegram --token <ton-jeton>
openclaw channels status --probe

La seconde commande doit indiquer works pour Telegram. Par défaut, un inconnu qui écrit au bot reçoit un code d'appairage et son message n'est pas traité. Ton propre premier message passe donc par cette étape.

Exemple : appairer ton compte Telegram

Le bot et le code ci-dessous sont fictifs. Tu envoies « Bonjour » à @mon_assistant_bot. Le bot ne répond pas à ta question : il t'envoie un code de huit caractères, par exemple K7QXMPRA. Sur la machine qui héberge OpenClaw, tu lances :

openclaw pairing list telegram
openclaw pairing approve telegram K7QXMPRA

La première commande doit afficher la demande en attente avec ce code ; la seconde l'approuve. Renvoie « Bonjour » : cette fois, le modèle répond. Pour vérifier, relance openclaw pairing list telegram : la demande n'y figure plus. Si tu as un second compte Telegram, écris au bot depuis ce compte : il doit recevoir un code, pas une réponse. N'approuve pas cette demande-là.

Un code expire au bout d'une heure ; ensuite, un nouveau message en crée un autre. Et tant qu'aucun propriétaire n'existe, l'approbation en ligne de commande fait de ton compte le propriétaire des commandes : c'est lui qui recevra les demandes d'autorisation de la section suivante.

“

Une installation qui répond ne te dit pas ce que l'agent a le droit de faire sur ta machine.

”

Le réglage à changer avant de brancher un vrai compte

Une installation qui répond ne te dit pas ce que l'agent a le droit de faire sur ta machine. Par défaut, le bac à sable est désactivé et les commandes shell s'exécutent sur l'ordinateur hôte sans approbation : c'est le mode full. Avant de connecter une boîte mail, un dépôt de code ou un compte client, passe en mode ask :

openclaw config set tools.exec.mode ask
openclaw config get tools.exec.mode
openclaw security audit

En mode ask, seules les commandes que tu as autorisées à l'avance s'exécutent directement ; les autres attendent ton accord. Si personne ne répond, la commande est refusée par défaut. Une tâche planifiée de nuit verra donc ses commandes non autorisées refusées : ajoute ces commandes précises à la liste autorisée, décrite sur la même page, plutôt que de revenir au mode full.

L'audit et l'isolation sont détaillés dans ce qu'il faut pour installer OpenClaw. Le comparatif Hermes vs OpenClaw sur six critères montre comment un autre agent règle les mêmes valeurs par défaut.

Quand ça bloque

• openclaw: command not found dans un nouveau terminal. Le dossier des paquets npm globaux manque à ton PATH. npm prefix -g donne ce dossier ; ajoute export PATH="$(npm prefix -g)/bin:$PATH" à ~/.zshrc ou ~/.bashrc, puis ouvre un nouveau terminal.
• npm bloque l'installation avec le message blocked because they are not covered by allowScripts. Avec npm 12, l'installation manuelle s'écrit npm install -g openclaw@latest --allow-scripts=openclaw, suivie de openclaw onboard --install-daemon. Avec pnpm, l'option est --allow-build=openclaw : pnpm approve-builds -g, encore cité par des guides plus anciens, ne fonctionne pas pour une installation globale.
• EADDRINUSE ou another gateway instance is already listening. Le port est déjà pris, souvent par une passerelle lancée plus tôt. openclaw gateway status indique ce qui tourne.
• Un autre symptôme. openclaw triage fait des contrôles en lecture seule et rédige un diagnostic sans secrets, que tu peux confier à un agent de code ; openclaw doctor te montre les constats directement.

Sur un serveur plutôt que sur ton ordinateur

Sur ton ordinateur, l'agent s'arrête quand la machine dort. Un serveur règle ce point mais change deux choses. La documentation conseille de garder la passerelle sur l'adresse locale du serveur et d'ouvrir le tableau de bord par un tunnel SSH, plutôt que de l'exposer sur internet. Et les images de conteneur exposent la passerelle par défaut : avec Docker, active l'authentification avant d'ouvrir le port. Si ton besoin tient en une seule tâche répétée, les alternatives à OpenClaw peuvent t'éviter ce travail d'administration.

Désinstaller après un essai

openclaw uninstall seul ne présélectionne que le service. Lance d'abord openclaw uninstall --dry-run --all, qui liste ce qui serait supprimé : service, état, espace de travail et application. Si la liste te convient, lance openclaw uninstall --all, puis npm rm -g openclaw, la méthode prévue après une installation par le script. Dans un nouveau terminal, command -v openclaw ne doit plus rien afficher ; sinon, une seconde installation reste sur la machine.