Installer OpenClaw : guide pas à pas
Installez OpenClaw avec Node, lancez l’onboarding, vérifiez le Gateway et ouvrez la Control UI avec les commandes officielles.
Introduction
Installer OpenClaw consiste à mettre en place une application Node/TypeScript, terminer l’onboarding puis démarrer son Gateway self-hosted. Ce tutoriel est utile si vous voulez un assistant disponible depuis la Control UI ou un canal de messagerie, avec sessions, mémoire et skills. Il corrige les anciens guides fondés sur Python, pip et openclaw.yaml, qui ne décrivent pas le produit actuel. Si vous cherchez seulement à appeler un modèle depuis un script, OpenClaw est probablement inutile et une approche plus simple conviendra mieux. À la fin, vous aurez vérifié le service, envoyé un premier message et identifié les contrôles de sécurité indispensables.
Résumé rapide
- Vérifiez une version Node prise en charge ; Node 26 est recommandé.
- Testez sans installation durable avec
npx openclaw@latest. - Installez la CLI puis lancez
openclaw onboard --install-daemon. - Contrôlez le Gateway et ouvrez la Control UI.
- Terminez par
openclaw doctoret un audit de sécurité.
Prérequis et méthode d’installation
OpenClaw ne dépend pas de Python. Il requiert Node.js 22.22.3+, 24.15+, 25.9+ ou, de préférence, Node 26. Il faut également une authentification modèle : l’onboarding peut réutiliser une connexion Claude Code ou Codex CLI existante, ou enregistrer une clé fournisseur. La configuration finale se trouve dans ~/.openclaw/openclaw.json et l’état dans ~/.openclaw/.
Le chemin le plus sûr est progressif : essai avec npx, installation officielle, onboarding, validation du Gateway, puis connexion d’un canal. Ne configurez pas Telegram, Slack ou WhatsApp avant d’obtenir une réponse dans la Control UI ; vous isolerez ainsi les problèmes de modèle des problèmes de canal. Le guide complet OpenClaw explique la topologie avant de passer à la pratique.
Windows dispose d’un parcours natif et d’un parcours WSL2. Sur serveur, la même logique s’applique mais il faut traiter le processus comme un service, limiter l’exposition réseau et prévoir la supervision. Les méthodes Docker ou Nix peuvent être pertinentes, mais elles ne changent ni le rôle du Gateway ni le format JSON5 de la configuration.
Installer et valider OpenClaw étape par étape
1. Vérifier Node
node --version
npm --version
Si Node n’est pas pris en charge, mettez-le à niveau avant de poursuivre. N’essayez pas de compenser avec un environnement virtuel Python : il n’intervient pas dans l’installation.
2. Faire un essai direct
npx openclaw@latest
Sur une machine neuve, choisissez le démarrage rapide si une authentification compatible est détectée. Le Gateway reste alors attaché au terminal jusqu’à Ctrl+C, mais la configuration est conservée. Cet essai permet de valider le runtime avant une installation globale.
3. Installer la CLI
Sur macOS ou Linux, le script officiel présenté dans la documentation installe le parcours recommandé. Ne recopiez jamais un script provenant d’un miroir inconnu. Une installation npm directe est également documentée :
npm install -g openclaw@latest --allow-scripts=openclaw
Avec une ancienne version de npm qui ne comprend pas --allow-scripts, utilisez la variante indiquée par l’installateur. Vérifiez ensuite que openclaw --version répond, sans figer dans votre documentation un numéro de version rapidement obsolète.
4. Terminer l’onboarding
openclaw onboard --install-daemon
L’assistant configure l’accès au modèle, initialise l’état et installe le service durable. Ne collez pas une clé dans un fichier d’article ou une commande conservée dans l’historique. Utilisez le mécanisme de secrets proposé par l’onboarding.
5. Vérifier le Gateway
openclaw gateway status
Le service local doit écouter sur le port 18789 par défaut. En cas d’échec, utilisez d’abord openclaw triage, puis openclaw doctor pour obtenir un diagnostic lisible. Corrigez les erreurs de configuration avant de multiplier les redémarrages.
6. Ouvrir le tableau de bord
openclaw dashboard
La Control UI doit s’ouvrir dans le navigateur. Envoyez un message court et vérifiez la réponse. Cette étape confirme en même temps le Gateway, l’authentification modèle et la session principale.
7. Contrôler l’état initial
openclaw doctor
openclaw security audit
L’audit doit être relancé après l’ajout d’un canal ou une exposition réseau. Le tutoriel configuration OpenClaw couvre ensuite le fichier openclaw.json, les modèles et les politiques.
Checklist de validation
node --versioncorrespond à une version prise en charge ;openclaw --versionrépond ;openclaw gateway statusvoit le service ;openclaw dashboardouvre la Control UI ;- un message court reçoit une réponse ;
openclaw doctorne signale pas de blocage ;- l’audit ne contient aucune alerte critique ignorée.
Repère opérationnel supplémentaire
Le Gateway doit rester le point de référence opérationnel. Il porte les sessions, les connexions aux canaux et le routage ; un redémarrage ou une panne affecte donc toutes les surfaces qui en dépendent. En production, supervisez le processus, conservez une procédure de redémarrage, puis vérifiez son état avec openclaw gateway status. Les automations exigent elles aussi un Gateway actif au moment prévu. Cette topologie est plus simple à exploiter qu'une collection de scripts dispersés, mais elle impose de traiter le Gateway comme un service durable et non comme une commande ponctuelle.
Repère opérationnel supplémentaire
Le workspace facilite l'organisation, mais ce n'est pas une frontière de sécurité. Il fournit le répertoire de travail, les instructions, les skills et les fichiers de mémoire ; sans sandbox, un outil autorisé peut encore atteindre d'autres chemins de l'hôte. Pour un assistant exposé à plusieurs personnes, limitez les outils, activez l'isolation adaptée et séparez les Gateway lorsque les utilisateurs ne partagent pas le même niveau de confiance. Une allowlist de skills réduit ce que le modèle voit, mais ne remplace jamais une politique d'exécution shell.
Repère opérationnel supplémentaire
La validation doit porter sur un effet observable. Après une modification, lancez une demande courte, vérifiez le fichier ou le message produit, puis consultez les logs et l'historique de session en cas d'écart. Évitez de conclure qu'une opération a réussi uniquement parce que la CLI n'a pas retourné d'erreur. Pour les actions avec effets de bord, ajoutez une étape de lecture après écriture, un identifiant d'exécution et une règle d'idempotence. Cela réduit les doublons lors d'un retry ou d'une reprise après interruption.
Exemple concret
Vous installez OpenClaw sur un petit serveur personnel. Commencez par vérifier Node, puis lancez npx openclaw@latest. Choisissez le démarrage rapide, envoyez « Réponds uniquement par OK » dans la Control UI et confirmez que le modèle répond. Arrêtez le processus avec Ctrl+C, installez ensuite la CLI globalement et exécutez openclaw onboard --install-daemon.
Après l’installation du service, lancez openclaw gateway status, puis openclaw dashboard. Envoyez une seconde demande qui crée une note dans le workspace et relisez réellement le fichier. Exécutez enfin openclaw doctor et openclaw security audit --deep. Le test est réussi seulement si le service redémarre, si la session répond et si l’effet attendu est visible. N’ajoutez le canal Telegram qu’après cette recette ; si le canal échoue ensuite, vous saurez que le problème se situe dans le token, le pairing ou le routage, pas dans le modèle.
Bonnes pratiques
Utilisez l’installateur officiel ou npm, jamais un paquet pip portant un nom ressemblant. Ne figez pas un numéro de version dans vos procédures : contrôlez plutôt openclaw --version et lisez les migrations avant une mise à jour. Sauvegardez ~/.openclaw/ avant une opération majeure, mais ne copiez pas les secrets vers un dépôt.
Gardez le Gateway sur loopback tant qu’un accès distant n’est pas nécessaire. Préférez un VPN ou un tunnel contrôlé à une exposition publique directe. Votre checklist de maintenance doit couvrir le statut, la Control UI, un tour agent, les logs, openclaw doctor et openclaw security audit --deep. Si l’installation doit servir des utilisateurs qui ne se font pas confiance, séparez les instances au niveau Gateway et système.
Questions fréquentes
Comment installer OpenClaw ?
Le chemin le plus direct consiste à utiliser le script officiel sur macOS ou Linux, puis à exécuter openclaw onboard --install-daemon. Vous pouvez aussi installer la CLI avec npm. Vérifiez ensuite le service avec openclaw gateway status et ouvrez la Control UI avec openclaw dashboard.
Faut-il Python pour installer OpenClaw ?
Non. Le produit actuel utilise Node/TypeScript et se distribue via son installateur, npx ou npm. Les commandes pip install openclaw, les environnements virtuels Python et les imports from openclaw import Agent appartiennent à d’anciennes descriptions incorrectes et ne doivent pas être utilisés.
Quelle version de Node faut-il pour OpenClaw ?
Node 26 est le runtime recommandé. Les branches 22, 24 et 25 ne sont acceptées qu’à partir de versions minimales précises. Vérifiez toujours la version avec node --version et comparez-la à la documentation de la release que vous installez.
Comment diagnostiquer une installation OpenClaw ?
Commencez par openclaw gateway status. Lancez ensuite openclaw triage pour une lecture guidée ou openclaw doctor pour les diagnostics détaillés. Si vous avez modifié l’exposition, les canaux ou les tools, complétez avec openclaw security audit --deep.
Articles liés
Une installation OpenClaw valide se prouve par un Gateway actif, une Control UI accessible et un vrai tour agent réussi. Une fois cette base stable, configurez le workspace et les skills avant de connecter davantage de canaux.
Restez informé sur les agents IA
Nouveaux tutoriels, comparatifs et guides pratiques directement dans votre boîte mail.