Installer OpenClaw sur Windows

OpenClaw est un outil puissant pour créer des workflows d’IA, mais sa configuration sur Windows peut être déroutante pour les débutants. Ce guide présente les principales méthodes d’installation afin de vous aider à démarrer rapidement.

Installation d’OpenClaw sur Windows : 3 méthodes comparées

Avant d’entrer dans les étapes, voici un bref aperçu des trois façons d’installer OpenClaw sur Windows. Chaque méthode présente des compromis différents en matière de temps de configuration, de couverture fonctionnelle et d’exigences techniques.

Kimi Claw est un outil en ligne qui vous permet d’exécuter OpenClaw dans votre navigateur. Il prend automatiquement en charge l’installation et la configuration : vous n’avez donc pas besoin de Node.js, de WSL ni de configurer une clé API. Vous pouvez commencer à utiliser un agent prêt à l’emploi en quelques minutes.

Pour une configuration locale avec PowerShell ou WSL2, passez à la Méthode 1 ou à la Méthode 2. Pour éviter entièrement l’installation locale, allez directement à la Méthode 3 : Kimi Claw. Si vous voulez démarrer plus vite, vous pouvez commencer tout de suite.

Ce qu’il vous faut avant d’installer OpenClaw localement sur Windows

Si vous prévoyez d’installer OpenClaw localement, vérifiez que votre système répond aux exigences suivantes. Si vous choisissez une option cloud comme Kimi Claw, vous pouvez ignorer entièrement cette section.

Configuration requise

• Windows 10 ou Windows 11 (64 bits)

• Au moins 4 Go de RAM (8 Go recommandés pour des builds npm stables)

• Connexion Internet stable

• Privilèges administrateur pour la configuration initiale si vous choisissez WSL2

• Pour OpenClaw WSL2 : la virtualisation doit être activée dans BIOS/UEFI

Logiciels requis

• Node.js 22.14 ou version ultérieure. OpenClaw nécessite un runtime Node.js moderne. Téléchargez-le depuis nodejs.org ou installez-le via le script d’onboarding.

• Git for Windows (facultatif mais recommandé). Certains paquets npm et certaines compétences dépendent de Git.

Méthode 1 : installer OpenClaw sur Windows avec PowerShell

Par rapport à WSL2, la méthode PowerShell demande moins d’étapes et ne nécessite aucun environnement Linux. Une seule commande télécharge OpenClaw, vérifie votre version de Node.js et lance l’assistant d’onboarding. Cette méthode fonctionne sous Windows 10 comme sous Windows 11.

Étape 1 : installer et lancer votre OpenClaw

Windows limite par défaut l’exécution des scripts afin de protéger votre système. Avant d’installer OpenClaw, vous devez autoriser PowerShell à exécuter des scripts locaux en lançant cette commande de « sécurité » :

Ensuite, exécutez la commande suivante :

Après avoir exécuté la commande, vous devriez voir une sortie similaire à la capture d’écran ci-dessous. Fermez puis rouvrez PowerShell afin d’actualiser le PATH de votre système avant de passer à l’onboarding.

Étape 2 : confirmer l’avertissement de risque et choisir le mode d’onboarding

Sélectionnez Yes pour reconnaître le risque et continuer.

Sélectionnez ensuite QuickStart pour démarrer rapidement l’onboarding. Vous pourrez ajuster les paramètres plus tard, ou choisir Manual pour une configuration complète.

Étape 3 : configurer et authentifier votre modèle d’IA

1. Sélectionner Moonshot AI comme fournisseur de modèle et d’authentification

1. Authentifier et configurer votre modèle d’IA

Pour connecter OpenClaw, activez votre clé Kimi API via la Kimi Open Platform. Une recharge de 5 $vous donne droit à un bon bonus de 5$, mais nous recommandons 20 $ ou plus pour débloquer l’accès Tier 2. Cela réduit la latence et garantit que votre agent OpenClaw peut gérer des tâches complexes en plusieurs étapes.

1. Créer une clé Kimi API

Accédez à la section des clés API, puis cliquez sur Create API Key. Veillez à conserver votre clé API dans un endroit sûr et accessible. Elle ne s’affiche qu’une seule fois, au moment de sa création.

1. Saisir votre clé API et sélectionner le modèle par défaut

Lorsque l’assistant d’onboarding vous y invite, collez votre clé API unique dans la fenêtre PowerShell/Terminal.

Lorsque vous devez choisir un modèle par défaut, sélectionnez moonshot/kimi-k2.5 (ou choisissez « Keep current » s’il est déjà en surbrillance). Ce modèle offre le meilleur équilibre entre rapidité et raisonnement pour les tâches agentiques.

Étape 4 : sélectionner le canal

Choisissez l’application que vous souhaitez connecter à votre OpenClaw. Si vous ne savez pas laquelle choisir, ignorez simplement cette étape.

Étape 5 : configurer les performances

Cliquez sur Yes pour configurer, ou sur No pour passer cette étape.

Étape 6 : activer les hooks

Choisissez une méthode pour discuter avec votre bot, puis attendez qu’il démarre.

Étape 7 : lancer votre OpenClaw

Une fois toutes les étapes ci-dessus terminées, profitez de votre OpenClaw.

Méthode 2 : installer OpenClaw sur Windows avec WSL2

La configuration OpenClaw WSL2 fournit un environnement Linux complet dans Windows ; c’est la méthode officiellement recommandée pour exécuter OpenClaw. Elle vous donne accès à l’ensemble des fonctionnalités, notamment la gestion des démons systemd, les scripts shell natifs et des builds npm plus fluides. Si vous comptez utiliser OpenClaw sur Windows pour vos workflows quotidiens ou pour le développement, OpenClaw WSL est le meilleur choix.

Étape 1 : activer WSL2 pour OpenClaw sous Windows 11/10

Ouvrez PowerShell en tant qu’administrateur et exécutez :

Cette commande active WSL, télécharge Ubuntu et l’installe. Une fois le processus terminé, redémarrez votre ordinateur. Au redémarrage de Windows, Ubuntu se lancera et vous demandera de créer un nom d’utilisateur et un mot de passe.

Si WSL est déjà installé, vérifiez-le :

Étape 2 : configurer WSL2 pour systemd

OpenClaw s’exécute comme service en arrière-plan à l’aide de systemd. Activez-le dans votre configuration WSL :

Redémarrez ensuite WSL depuis PowerShell :

Rouvrez votre terminal Ubuntu et vérifiez que systemd est en cours d’exécution :

La sortie doit afficher systemd. Si elle affiche plutôt init, revérifiez votre fichier /etc/wsl.conf.

Étape 3 : installer Node.js 22.14+

OpenClaw nécessite Node.js 22.14 ou une version ultérieure. Installez-le depuis le dépôt NodeSource :

Vérifiez l’installation :

Étape 4 : installer OpenClaw via npm

Une fois Node.js prêt, installez OpenClaw globalement :

Vous pouvez aussi utiliser le script d’installation officiel :

Vérifiez l’installation :

Étape 5 : finaliser la configuration d’OpenClaw sur Windows via l’onboarding

Exécutez l’assistant d’onboarding avec l’indicateur de démon pour configurer OpenClaw comme service systemd :

L’assistant vous guidera pour :

• Sélectionner votre fournisseur LLM et saisir votre clé API

• Choisir un modèle par défaut

• Configurer les canaux de messagerie (facultatif)

• Installer la passerelle comme service en arrière-plan

Après l’onboarding, activez la persistance du service afin qu’OpenClaw démarre automatiquement au lancement de WSL :

La passerelle est le service d’arrière-plan principal qui gère toutes les opérations d’OpenClaw, notamment les requêtes d’agent, la messagerie et l’exécution des modèles. Vérifier qu’elle fonctionne confirme que votre installation d’OpenClaw est terminée et prête à l’emploi, et évite les erreurs lors des étapes suivantes.

Exécutez la commande suivante dans votre terminal PowerShell ou WSL pour vérifier son état :

Méthode 3 : exécuter OpenClaw sur Windows avec Kimi Claw (aucune configuration requise)

Si la gestion de Node.js, de WSL et des clés API vous semble trop lourde pour vos besoins, Kimi Claw offre une façon plus simple d’exécuter OpenClaw. Vous pouvez lancer OpenClaw directement dans votre navigateur, sans installation locale ni configuration manuelle. Pour commencer, suivez ces étapes :

Étape 1 : ouvrir Kimi Claw et créer une instance

Accédez à la page Kimi Claw, puis cliquez sur Create pour commencer.

Étape 2 : lancer le déploiement

Confirmez le déploiement dans la fenêtre contextuelle. Kimi Claw configure votre environnement OpenClaw en environ deux minutes, avec la passerelle, l’espace de travail et les outils. Aucune commande ni configuration manuelle n’est requise.

Étape 3 : travailler dans votre espace de travail

Une fois le déploiement terminé, votre espace de travail s’ouvre dans le tableau de bord. Vous pouvez commencer à discuter avec votre agent d’IA, configurer des compétences, planifier des tâches et gérer des fichiers, le tout depuis le navigateur.

Ce que vous apporte Kimi Claw

• Zéro configuration : aucune gestion de Node.js, de WSL ni de clé API requise

• 40 Go de stockage cloud : conservez rapports, jeux de données et fichiers générés d’une session à l’autre

• Mémoire persistante : votre agent d’IA se souvient des interactions passées, de vos préférences et du contexte

• Plus de 5 000 compétences ClawHub : accédez instantanément à des compétences d’automatisation, de recherche, de code et d’analyse

• Automatisation des tâches planifiées : configurez des tâches récurrentes comme des rapports quotidiens, des rappels et de la surveillance

• Fonctionne sur tous les appareils : accédez à votre agent OpenClaw depuis n’importe quel navigateur sur Windows, Mac ou mobile

Paramètres de pare-feu et de sécurité Windows pour OpenClaw

Kimi Claw gère automatiquement la sécurité et le réseau sur des serveurs cloud. Si vous préférez installer OpenClaw localement avec PowerShell ou WSL2, quelques paramètres de sécurité sont recommandés après l’installation.

• Configurer le pare-feu Windows

Au premier démarrage de la passerelle OpenClaw, le pare-feu Windows peut vous demander d’autoriser l’accès au réseau. Autorisez-le uniquement pour les réseaux privés. Si vous utilisez OpenClaw WSL2, la passerelle s’exécute dans l’environnement Linux et communique via localhost ; des règles de pare-feu supplémentaires ne sont donc généralement pas nécessaires.

Si Browser Relay ou d’autres fonctionnalités ne parviennent pas à se connecter, vérifiez que le trafic localhost n’est pas bloqué par un logiciel de sécurité tiers, comme un antivirus, un client VPN ou un pare-feu d’entreprise.

• Sécuriser l’interface de contrôle

L’interface de contrôle OpenClaw s’exécute sur le port 18789 et donne un accès complet à votre agent. N’exposez jamais ce port à l’internet public. Gardez la passerelle liée à 127.0.0.1 et n’y accédez que depuis votre machine locale.

Pour un accès distant sécurisé, utilisez Tailscale afin de créer un tunnel réseau privé :

Le port reste ainsi sur localhost tout en étant accessible via votre réseau privé Tailscale.

Erreurs courantes d’installation d’OpenClaw sur Windows et solutions

Même avec un guide clair, vous pouvez rencontrer des problèmes pendant l’installation. Voici les problèmes les plus fréquemment signalés lors de l’installation d’OpenClaw sur Windows, ainsi que leurs solutions.

OpenClaw n’est pas reconnu

• Cause : le répertoire bin global de npm n’est pas dans le PATH de votre système.

• Solution : exécutez la commande suivante pour trouver votre préfixe npm

Ajoutez le chemin obtenu aux variables d’environnement Windows. N’ajoutez pas \\bin. Fermez puis rouvrez PowerShell.

Git introuvable pendant l’installation

• Cause : Git for Windows n’est pas installé.

• Solution : téléchargez et installez Git depuis git-scm.com. Après l’installation, redémarrez PowerShell et relancez le programme d’installation Windows d’OpenClaw.

La version de Node.js est trop ancienne

• Cause : votre système dispose d’une ancienne version de Node.js qui ne répond pas à l’exigence minimale (v22.14+).

• Solution : téléchargez la dernière version LTS depuis nodejs.org et installez-la. Si vous utilisez OpenClaw WSL2, réinstallez-la via le dépôt NodeSource.

Erreurs d’autorisation refusée

• Cause : PowerShell ne dispose pas des autorisations suffisantes, ou le répertoire global de npm n’est pas accessible en écriture.

• Solution : exécutez PowerShell en tant qu’administrateur, ou définissez le préfixe global de npm sur un répertoire accessible en écriture par l’utilisateur

La passerelle ne démarre pas

• Cause : Port 18789 est déjà utilisé, ou le fichier de configuration est corrompu.

• Solution : recherchez les processus en conflit et redémarrez

WSL2 systemd ne fonctionne pas

• Cause : le fichier /etc/wsl.conf ne contient pas la configuration systemd.

• Solution : vérifiez que le fichier contient les bons paramètres

Si le paramètre est absent, ajoutez-le puis redémarrez WSL avec wsl --shutdown dans PowerShell.

Conclusion

L’installation d’OpenClaw sur Windows peut aller d’une configuration simple par script à un environnement WSL2 plus avancé, selon vos besoins. Si vous voulez un contrôle total et une grande flexibilité, PowerShell et WSL2 sont de solides options. Si vous préférez éviter la configuration et commencer immédiatement, Kimi Claw vous permet d’exécuter OpenClaw dans votre navigateur, sans installation locale. Choisissez l’approche qui correspond à votre flux de travail et à votre niveau d’aisance technique, et vous serez prêt à tirer le meilleur parti d’OpenClaw.