Guide d'installation d'OpenClaw Windows : installer sur Windows 10 et 11

Présentation

OpenClaw fonctionne très bien sous Windows, bien que le processus d’installation diffère légèrement de celui de macOS et Linux. Ce guide couvre tout ce dont vous avez besoin pour installer et exécuter OpenClaw sur Windows 10 ou Windows 11, y compris la configuration PowerShell, l’installation de Node.js et les recommandations WSL2.

Pour les instructions générales d’installation, consultez notre guide d’installation complet.

Configuration système requise

Version Windows

• Windows 10 (version 1903 ou ultérieure)
• Windows 11 (toutes les versions)
• Les anciennes versions peuvent fonctionner mais ne sont pas officiellement prises en charge

Matériel

• RAM — 2 Go+ recommandés (4 Go+ pour de meilleures performances)
• Stockage — 500 Mo+ pour l’installation, espace supplémentaire pour la mémoire/les données
• Processeur – Tout processeur x64 moderne

Prérequis logiciels

• Node.js 18+ — Requis pour exécuter OpenClaw
• PowerShell 5.1+ ou Windows Terminal — Recommandé par rapport à CMD
• Git (facultatif) — Pour une installation piratable à partir des sources

Méthodes d’installation

Méthode 1 : installation npm (recommandée)

La manière standard d’installer OpenClaw sur Windows :

1. Installez Node.js (s’il n’est pas déjà installé) :

   • Télécharger depuis nodejs.org
   • Choisissez la version LTS (18.x ou supérieure)
   • Exécutez le programme d’installation avec les paramètres par défaut
   • Vérifier l’installation :

     node --version
     npm --version

2. Installez OpenClaw :

   npm i -g openclaw

3. Vérifiez l’installation :

   openclaw --version

Méthode 2 : PowerShell One-Liner

Un script PowerShell automatise l’installation :

irm https://openclaw.ai/install.ps1 | iex

Remarque : Vous devrez peut-être activer l’exécution du script :

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Ce script :

• Recherchez Node.js (invite à installer s’il est manquant)
• Installer OpenClaw globalement
• Configurer PATH si nécessaire
• Vérifier l’installation

Méthode 3 : Installation WSL2 (meilleure expérience)

Le sous-système Windows pour Linux 2 (WSL2) fournit un environnement Linux qui fonctionne souvent mieux pour OpenClaw :

1. Installez WSL2 :

   wsl --install

   Redémarrez votre ordinateur lorsque vous y êtes invité.

2. Installez Ubuntu (ou votre distribution Linux préférée) :

   wsl --install -d Ubuntu

3. Dans WSL2, installez OpenClaw :

   curl -fsSL https://openclaw.ai/install.sh | bash

WSL2 fournit :

• Meilleure compatibilité avec les outils Unix
• Performances Linux natives
• Intégration plus facile avec les services basés sur Linux
• Accès aux gestionnaires de packages Linux

Consultez notre Guide de configuration Linux pour obtenir des instructions spécifiques à WSL2.

Méthode 4 : Installation piratable (à partir de la source)

Pour les développeurs qui souhaitent modifier la source :

1. Installer Git :

   • Télécharger depuis git-scm.com
   • Ou installer via Winget :

     winget install Git.Git

2. Cloner et construire :

   git clone https://github.com/openclaw/openclaw.git
   cd openclaw
   npm install
   npm run build

3. Exécuter à partir des sources :

   npm run openclaw onboard

Installation de Node.js sous Windows

Option 1 : Installateur officiel

1. Visitez nodejs.org
2. Téléchargez la version LTS (18.x ou supérieure)
3. Exécutez le programme d’installation
4. Cochez “Ajouter au PATH” lors de l’installation
5. Vérifiez :

   node --version
   npm --version

Option 2 : winget (Gestionnaire de packages Windows)

winget install OpenJS.NodeJS.LTS

Option 3 : Chocolaté

Si Chocolatey est installé :

choco install nodejs-lts

Option 4 : Scoop

Si vous utilisez Scoop :

scoop install nodejs-lts

PowerShell contre invite de commande

PowerShell (recommandé)

PowerShell est plus puissant et moderne :

• De meilleures capacités de script
• Plus cohérent avec les commandes multiplateformes
• Meilleure gestion des erreurs
• Prise en charge native de JSON

Utilisez PowerShell pour toutes les commandes OpenClaw.

Invite de commandes (CMD)

CMD fonctionne mais a des limites :

• Ancienne syntaxe
• Scripts moins puissants
• Certains scripts npm peuvent ne pas fonctionner correctement

Si vous devez utiliser CMD, les commandes sont pour la plupart les mêmes, mais PowerShell est recommandé.### Terminal Windows

Windows Terminal offre la meilleure expérience :

• Plusieurs onglets
• Meilleur rendu des polices
• Apparence personnalisable
• PowerShell, CMD et WSL intégrés

Installez depuis le Microsoft Store ou :

winget install Microsoft.WindowsTerminal

Configuration post-installation

Après l’installation, configurez OpenClaw :

openclaw onboard

Cette configuration interactive couvre :

1. Configuration du modèle d’IA

Choisissez votre fournisseur d’IA :

Claude Anthropic :

• Claude 3.5 Sonnet (recommandé)
• Claude 3 Opus
• Claude 4

Obtenez votre clé API sur console.anthropic.com.

OpenAI GPT :

• GPT-4o
• GPT-4 Turbo
• GPT-4.1

Obtenez votre clé API sur platform.openai.com.

Modèles locaux :

• Ollama (fonctionne localement)
• LM Studio
• MiniMax

2. Autorisations Windows

OpenClaw peut demander des autorisations :

• Pare-feu — Autoriser Node.js/OpenClaw via le pare-feu Windows
• Antivirus — Il faudra peut-être ajouter le répertoire OpenClaw à la liste blanche
• Système de fichiers — Pour lire/écrire des fichiers

3. Configuration du CHEMIN

Assurez-vous qu’OpenClaw est dans votre PATH :

$env:PATH -split ';' | Select-String "npm"

S’il n’est pas trouvé, ajoutez le chemin global npm :

$npmPath = npm config get prefix
$env:PATH += ";$npmPath"
[Environment]::SetEnvironmentVariable("Path", $env:Path, [EnvironmentVariableTarget]::User)

Redémarrez PowerShell après avoir modifié PATH.

Exécution d’OpenClaw

Démarrez le serveur

openclaw

Cela démarre le serveur local et connecte toutes les intégrations configurées.

Exécuter en arrière-plan

Utilisez Start-Process :

Start-Process -NoNewWindow openclaw

Ou utilisez un gestionnaire de processus comme pm2 :

npm i -g pm2
pm2 start openclaw
pm2 save
pm2 startup

Exécuter en tant que service Windows

Installez en tant que service Windows à l’aide de node-windows :

npm i -g node-windows

Créez un script de service (voir node-windows docs).

Lancement au démarrage

Créez une tâche planifiée :

1. Ouvrez le planificateur de tâches
2. Créer une tâche de base
3. Nom : “OpenClaw”
4. Déclencheur : “Quand je me connecte”
5. Action : “Démarrer un programme”
6. Programme : C:\Users\YourName\AppData\Roaming\npm\openclaw.cmd
7. Arguments : (laisser vide)

Ou utilisez le dossier Démarrage :

$startup = [Environment]::GetFolderPath("Startup")
$shortcut = "$startup\OpenClaw.lnk"
$shell = New-Object -ComObject WScript.Shell
$link = $shell.CreateShortcut($shortcut)
$link.TargetPath = "C:\Users\YourName\AppData\Roaming\npm\openclaw.cmd"
$link.Save()

Considérations spécifiques à Windows

Logiciel antivirus

Certains logiciels antivirus peuvent signaler OpenClaw :

• Windows Defender — Fonctionne généralement correctement, peut nécessiter une exclusion
• AV tiers – Peut nécessiter une liste blanche

Ajoutez une exclusion pour :

• Répertoire d’installation d’OpenClaw
• Répertoire de données ~/.openclaw
• Exécutable Node.js

Configuration du pare-feu

Autoriser OpenClaw via le pare-feu Windows :

New-NetFirewallRule -DisplayName "OpenClaw" -Direction Inbound -Program "C:\Users\YourName\AppData\Roaming\npm\node_modules\openclaw\bin\openclaw.js" -Action Allow

Ou utilisez l’interface graphique du pare-feu Windows Defender :

1. Sécurité Windows → Pare-feu et protection réseau
2. Autoriser une application via le pare-feu
3. Ajouter OpenClaw

Prise en charge des chemins longs

Windows a une limite de chemin de 260 caractères. Activer les longs chemins :

1. Ouvrez l’éditeur de stratégie de groupe (gpedit.msc)
2. Accédez à : Configuration de l’ordinateur → Modèles d’administration → Système → Système de fichiers.
3. Activez « Activer les chemins longs Win32 »
4. Redémarrez l’ordinateur

Ou modifiez le registre (utilisateurs avancés uniquement).

Fins de lignes

Windows utilise CRLF, Unix utilise LF. La plupart des outils gèrent cela automatiquement, mais si vous rencontrez des problèmes :

git config --global core.autocrlf true

Dépannage

Commande introuvable

Si openclaw n’est pas reconnu :

1. Vérifiez le chemin global npm :

   npm config get prefix

2. Ajouter au CHEMIN :

   $npmPath = npm config get prefix
   [Environment]::SetEnvironmentVariable("Path", "$env:Path;$npmPath", [EnvironmentVariableTarget]::User)

3. Redémarrez PowerShell

4. Vérifiez :

   Get-Command openclaw

Autorisation refusée

Si vous voyez des erreurs d’autorisation :

1. Exécutez PowerShell en tant qu’administrateur : Faites un clic droit sur PowerShell → “Exécuter en tant qu’administrateur”

2. Installer globalement :

   npm i -g openclaw

3. Corriger les autorisations npm (alternative) :

   mkdir $env:APPDATA\npm-global
   npm config set prefix "$env:APPDATA\npm-global"
   $env:PATH += ";$env:APPDATA\npm-global"
   [Environment]::SetEnvironmentVariable("Path", $env:Path, [EnvironmentVariableTarget]::User)

Port déjà utilisé

Changer le port :

openclaw --port 3001

Ou trouvez et tuez le processus :

netstat -ano | findstr :3000
taskkill /PID <PID> /F

Problèmes de version de Node.js

Assurez-vous d’avoir Node.js 18+ :

node --version

S’il est obsolète, mettez à jour :

winget upgrade OpenJS.NodeJS.LTS
```Ou téléchargez la dernière version depuis [nodejs.org](https://nodejs.org/).

### Intégration WSL2

Si vous utilisez WSL2, accédez aux fichiers Windows :

```bash
# In WSL2
cd /mnt/c/Users/YourName

Accédez aux fichiers WSL2 depuis Windows :

# In PowerShell
cd \\wsl$\Ubuntu\home\username

Conseils sur les performances

Performances WSL2

Si vous utilisez WSL2 :

• Stocker les données OpenClaw dans le système de fichiers WSL2 (plus rapide)
• Utiliser WSL2 pour toutes les opérations
• Accédez aux fichiers Windows via /mnt/c/ en cas de besoin

Windows Défenseur

Excluez les répertoires OpenClaw de l’analyse en temps réel :

1. Sécurité Windows → Protection contre les virus et les menaces
2. Gérer les paramètres → Exclusions
3. Ajoutez des dossiers :
   • C:\Users\YourName\AppData\Roaming\npm
   • C:\Users\YourName\.openclaw

Gestion de la mémoire

Surveiller l’utilisation des ressources :

Get-Process | Where-Object {$_.ProcessName -like "*node*"} | Select-Object ProcessName, CPU, WorkingSet

Mise à jour d’OpenClaw

Mise à jour vers la dernière version :

npm update -g openclaw

Ou réexécutez le programme d’installation :

irm https://openclaw.ai/install.ps1 | iex

Désinstallation

Supprimer OpenClaw :

npm uninstall -g openclaw

Supprimer la configuration :

Remove-Item -Recurse -Force $env:USERPROFILE\.openclaw

Supprimer de PATH (si ajouté manuellement).

Prochaines étapes

Maintenant qu’OpenClaw est installé sur Windows :

1. Connectez les applications de chat — WhatsApp, Telegram, Discord
2. Configurer les intégrations — Gmail, Slack
3. Explorer les compétences — Bibliothèque de compétences
4. Lire la FAQ — Questions courantes

Conclusion

L’installation d’OpenClaw sur Windows est simple avec npm. Bien que WSL2 offre la meilleure expérience, l’installation native de Windows fonctionne parfaitement pour la plupart des utilisateurs. PowerShell est recommandé par rapport à CMD pour une meilleure compatibilité et de meilleures capacités de script.

Pour plus d’aide, consultez notre guide d’installation général ou notre page FAQ. Bonne automatisation sous Windows !