OpenClaw est un outil local qui permet à votre agent IA de se connecter à des applications comme Telegram ou WhatsApp et d’agir, par exemple en envoyant des messages ou en traitant des tâches. Sa configuration est simple une fois le processus compris. Ce guide couvre l’installation sur macOS, Linux et Windows.
Aperçu rapide des options de configuration d’OpenClaw
Choisissez la configuration qui correspond à vos besoins. Exécuter OpenClaw localement garde tout sur votre propre machine et nécessite l’installation de dépendances comme npm ou l’utilisation d’un script automatisé. Si vous préférez éviter la configuration, des plateformes entièrement hébergées comme Kimi Claw gèrent l’environnement pour vous et vous permettent de commencer directement.
| macOS / Linux | Windows | |
|---|---|---|
| Exécution locale | Commande Terminal en une ligne | Commande PowerShell en une ligne |
| Via npm | Via npm | |
| Via Homebrew | Via WSL2 | |
| Exécution en ligne | Solution cloud (p. ex. Kimi Claw) | Solution cloud (p. ex. Kimi Claw) |
Comment installer OpenClaw sur macOS et Linux
macOS et Linux partagent le même programme d’installation et les mêmes commandes. Sauf indication contraire, ces instructions s’appliquent aux deux systèmes.
Voici un guide de configuration rapide. Pour un tutoriel complet pas à pas avec captures d’écran, consultez Comment installer OpenClaw sur macOS.
Méthode 1 : utiliser le script d’installation en une ligne
Étape 1 : exécuter le script d’installation dans Terminal
Exécutez le script d’installation officiel pour configurer OpenClaw. Le script vérifie si Node.js 22 ou une version plus récente est installé. S’il est absent ou obsolète, Node.js 24 sera installé automatiquement. Il installe ensuite la CLI OpenClaw et lance l’assistant d’onboarding.
Étape 2 : finaliser l’assistant d’onboarding
Suivez l’assistant d’onboarding pour configurer votre environnement d’agent, notamment le choix d’un fournisseur de modèles (p. ex. Kimi API), la saisie de votre clé API, le choix d’un canal et la configuration des paramètres de base.
Étape 3 : vérifier votre installation
Exécutez la commande suivante pour confirmer votre version d’OpenClaw.
Étape 4 : vérifier la gateway et finaliser la configuration
Exécutez la commande suivante pour vérifier que la gateway OpenClaw est active.
Le programme d’installation enregistre également un LaunchAgent sur macOS ou un service systemd sur Linux, afin qu’OpenClaw continue de fonctionner en arrière-plan. Une fois la configuration terminée, votre agent est prêt à l’emploi. Vous pouvez commencer à discuter, connecter des outils ou configurer des workflows selon vos besoins.
Méthode 2 : installer avec Homebrew
Étape 1 : installer ou mettre à niveau Node.js
Utilisez Homebrew pour installer Node.js en exécutant la commande suivante dans Terminal. Si Node.js est déjà installé, exécutez plutôt la commande de mise à niveau afin d’utiliser la dernière version.
Étape 2 : installer la CLI OpenClaw
Exécutez la commande suivante pour installer la CLI OpenClaw globalement.
Étape 3 : lancer l’onboarding et configurer le daemon
Exécutez la commande suivante pour lancer l’assistant d’onboarding et enregistrer le daemon d’arrière-plan. Suivez l’assistant pour configurer votre environnement d’agent, notamment le choix d’un fournisseur de modèles (p. ex. Kimi API), la saisie de votre clé API et la connexion d’un canal de messagerie. Une fois la configuration terminée, votre agent est prêt à l’emploi. Vous pouvez commencer à discuter, connecter des outils ou configurer des workflows selon vos besoins.
Méthode 3 : installer avec npm
Étape 1 : vérifier la version du runtime
Exécutez la commande suivante pour vous assurer que Node.js 22.14 ou une version ultérieure est installé sur votre système. Si votre version est à jour, vous pouvez poursuivre l’installation.
Étape 2 : installer la CLI OpenClaw
Exécutez la commande suivante pour installer la CLI OpenClaw globalement.
Étape 3 : lancer l’onboarding et activer la persistance
Exécutez la commande suivante pour lancer l’assistant d’onboarding et enregistrer le daemon d’arrière-plan. Suivez l’assistant pour configurer votre environnement d’agent, notamment le choix d’un fournisseur de modèles (p. ex. Kimi API), la saisie de votre clé API et le choix d’un canal de messagerie. Une fois la configuration terminée, votre agent est prêt. Vous pouvez commencer à interagir avec lui, connecter des outils ou créer des workflows selon vos besoins.
Notes sur la plateforme : OpenClaw prend en charge les Macs Intel et Apple Silicon. Si l’installation est bloquée par Gatekeeper, vous pouvez l’autoriser dans Réglages Système, sous Confidentialité et sécurité.
Comment installer OpenClaw sur Windows
Windows propose trois principales façons d’installer OpenClaw : le programme d’installation PowerShell pour une configuration native rapide, WSL2 pour un environnement Linux complet, et npm pour une installation manuelle.
Voici un guide de configuration rapide. Pour un tutoriel complet pas à pas avec captures d’écran, consultez Comment installer OpenClaw sur Windows.
Méthode 1 : utiliser le programme d’installation PowerShell (Windows natif)
Étape 1 : exécuter le script d’installation dans PowerShell
Ouvrez PowerShell en tant qu’administrateur et exécutez le script officiel en une ligne pour installer OpenClaw.
Étape 2 : finaliser l’assistant d’onboarding
Suivez les étapes d’onboarding pour configurer votre environnement d’agent, notamment le choix d’un fournisseur de modèles (p. ex. Kimi API), la saisie de votre clé API et le choix d’un canal de messagerie.
Étape 3 : vérifier l’installation
Exécutez la commande suivante pour confirmer qu’OpenClaw est correctement installé et que la gateway est active.
Étape 4 : commencer à utiliser votre agent
Une fois la configuration terminée, votre agent est prêt. Vous pouvez commencer à interagir avec lui, connecter des outils ou configurer des workflows selon vos besoins.
Méthode 2 : installer avec WSL2
Étape 1 : configurer l’environnement Linux
Ouvrez PowerShell en tant qu’administrateur et exécutez la commande suivante pour activer et initialiser WSL2.
Étape 2 : exécuter le programme d’installation sous Linux
Ouvrez votre terminal Linux et exécutez le script d’installation standard pour installer OpenClaw.
Étape 3 : finaliser l’assistant d’onboarding
Suivez les étapes d’onboarding pour configurer votre environnement d’agent, notamment le choix d’un fournisseur de modèles (p. ex. Kimi API), la saisie de votre clé API et le choix d’un canal de messagerie.
Une fois la configuration terminée, votre agent est prêt. Vous pouvez commencer à interagir avec lui, connecter des outils ou configurer des workflows selon vos besoins.
Méthode 3 : installer avec npm sur Windows
Étape 1 : vérifier votre version de Node.js
Exécutez la commande suivante pour vérifier que Node.js est installé et à jour.
Étape 2 : installer la CLI OpenClaw
Exécutez la commande suivante pour installer la CLI OpenClaw globalement.
Étape 3 : lancer l’onboarding et activer la persistance
Exécutez la commande suivante pour lancer l’assistant d’onboarding et enregistrer le daemon d’arrière-plan.
Suivez les étapes d’onboarding pour configurer votre environnement d’agent, notamment le choix d’un fournisseur de modèles (p. ex. Kimi API), la saisie de votre clé API et le choix d’un canal de messagerie.
Une fois la configuration terminée, votre agent est prêt. Vous pouvez commencer à interagir avec lui, connecter des outils ou configurer des workflows selon vos besoins.
Comment exécuter OpenClaw en ligne avec Kimi Claw
Les méthodes ci-dessus nécessitent un terminal, une version prise en charge de Node.js et une machine qui reste allumée. Kimi Claw propose une option entièrement hébergée : vous pouvez ainsi exécuter OpenClaw sans installer ni maintenir d’environnement local.
Étape 1 : ouvrir Kimi Claw et créer une instance
Accédez à la page Kimi Claw, puis cliquez sur Créer pour commencer.
Étape 2 : confirmer le déploiement
Confirmez le déploiement dans la fenêtre contextuelle. Kimi Claw configurera automatiquement votre environnement OpenClaw, y compris la gateway et l’espace de travail, sans aucune configuration locale.
Étape 3 : commencer à utiliser votre espace de travail
Une fois le déploiement terminé, votre espace de travail s’ouvre dans le tableau de bord. Vous pouvez commencer à interagir avec votre agent, configurer des compétences, programmer des tâches et gérer les fichiers directement dans votre navigateur.
Fonctionnalités clés de Kimi Claw
Hébergement cloud : Kimi Claw exécute votre gateway dans le cloud ; votre agent reste donc disponible même lorsque votre machine locale est hors ligne.
Maintenance automatique : les mises à jour et correctifs sont appliqués en arrière-plan, sans configuration manuelle ni redémarrage requis.
Fonctionnalités intégrées : inclut la planification des tâches, le stockage persistant et le chargement dynamique de compétences en fonction de vos prompts, avec un accès fluide sur tous vos appareils.
Résoudre les erreurs courantes d’installation d’OpenClaw
La plupart des problèmes d’installation d’OpenClaw relèvent de quelques catégories fréquentes, comme la configuration de PATH, des dépendances manquantes ou des conflits de port. Les sections ci-dessous vous aident à repérer et corriger rapidement les problèmes les plus courants sur macOS, Windows et Linux.
« openclaw: command not found » après l’installation
OpenClaw ne se trouve pas dans le PATH de votre système.
Correction : ajoutez le répertoire bin global de npm à votre PATH.
Rechargez ensuite votre shell (p. ex. source ~/.zshrc) ou redémarrez votre terminal. Sur Windows, ajoutez le chemin à vos variables d’environnement, puis redémarrez PowerShell.
Erreurs de compilation Sharp sur macOS
Cela se produit généralement lorsqu’un libvips installé globalement entre en conflit avec la bibliothèque Sharp.
Correction : exécutez la commande d’installation avec cette variable d’environnement.
Si vous voyez des erreurs node-gyp, installez les Xcode Command Line Tools :
OpenClaw ne démarre pas après un redémarrage
Le daemon d’arrière-plan n’a pas été installé lors de l’onboarding.
Correction : relancez l’onboarding avec l’option du daemon.
Vérifiez ensuite le service :
La gateway ne répond pas ou affiche « 0 tokens used »
Le processus de la gateway s’est peut-être arrêté, ou l’authentification API a échoué.
Correction : redémarrez la gateway.
Lancez un contrôle d’état :
Pour les journaux de débogage :
Vérifiez également que votre clé API est valide.
Le port 18789 est déjà utilisé
Un autre processus utilise le port de la gateway OpenClaw.
Correction : recherchez et arrêtez le processus en conflit
Redémarrez ensuite la gateway :
Erreurs d’autorisation EACCES
Cela signifie généralement que le répertoire global de npm ne dispose pas des autorisations appropriées.
Correction : mettez à jour le propriétaire du répertoire.
Sur Windows, exécutez PowerShell en tant qu’administrateur ou définissez un préfixe npm personnalisé :
Pour les configurations Docker, corrigez les autorisations des volumes :
Erreur « spawn git ENOENT »
Git n’est pas installé ou n’est pas disponible dans le PATH.
Correction : installez Git depuis git-scm.com, redémarrez votre terminal, puis relancez l’installation.
systemd WSL2 ne fonctionne pas
systemd n’est pas activé dans votre configuration WSL.
Correction : modifiez
/etc/wsl.confet ajoutez ce qui suit.
Redémarrez ensuite WSL :
Rouvrez votre terminal Linux et vérifiez :
Mémoire insuffisante lors de l’installation npm sur un VPS
Les instances VPS disposant de peu de mémoire peuvent échouer lors de l’installation des paquets.
Correction : créez un fichier d’échange.
Relancez ensuite l’installation.
« Access not configured » lors de la connexion à des plateformes de messagerie
Votre compte n’est pas autorisé par OpenClaw.
Correction : approuvez votre compte à l’aide du code d’appairage.
Vérifiez également que les identifiants de votre bot (token, webhook, autorisations) sont correctement configurés.
Conclusion
L’installation d’OpenClaw est simple sur macOS, Linux et Windows. Selon votre configuration, vous pouvez utiliser un script en une ligne, PowerShell, WSL2 ou npm. L’assistant d’onboarding vous guide dans le choix du modèle, la configuration de l’API et les canaux de messagerie. Si vous préférez ne pas gérer d’environnement local, Kimi Claw propose une option entièrement hébergée qui vous permet d’exécuter OpenClaw directement dans le cloud.
FAQ
node --version pour vérifier que votre version respecte l’exigence minimale.npm install -g openclaw@latest depuis votre terminal. La CLI sera ainsi mise à jour vers la dernière version. Vous pouvez également relancer le programme d’installation en une ligne, qui mettra automatiquement à niveau votre installation existante. OpenClaw prend aussi en charge les mises à jour depuis l’application via l’interface de contrôle à l’adresse 127.0.0.1:18789. Après la mise à jour, redémarrez la gateway avec openclaw gateway restart pour charger la nouvelle version.openclaw gateway status pour vérifier que le daemon est actif. Sur Windows, WSL2 avec systemd activé offre la configuration permanente la plus fiable. Si vous préférez ne pas gérer de services locaux, des options entièrement hébergées comme Kimi Claw vous permettent d’exécuter OpenClaw en continu dans le cloud.