OpenClaw sur Windows : installation complète avec WSL2

Introduction

OpenClaw est conçu pour Linux. Sur Windows, la voie la plus fiable — et la seule vraiment recommandée — est WSL2 (Windows Subsystem for Linux 2). Cette approche vous donne un environnement Linux complet directement dans Windows, sans dual-boot ni machine virtuelle lourde. Vous pourrez accéder à l'interface d'OpenClaw depuis votre navigateur Windows habituel, éditer vos fichiers depuis VS Code, et exécuter vos agents sans friction. Ce tutoriel couvre l'activation de WSL2, la configuration d'Ubuntu, l'installation d'OpenClaw, et les pièges à éviter pour ne pas perdre du temps sur des problèmes de performances ou de permissions.

Résumé rapide

1. Activer WSL2 : wsl --install dans PowerShell (admin)
2. Installer Ubuntu depuis le Microsoft Store
3. Mettre à jour Ubuntu et installer Python, pip, git
4. Installer OpenClaw dans l'environnement WSL2
5. Accéder à l'interface depuis http://localhost:PORT dans le navigateur Windows
6. Éditer les fichiers avec VS Code + extension "Remote - WSL"

Pourquoi WSL2 et pas autre chose ?

OpenClaw dépend d'un écosystème Python/Linux : des dépendances natives, des scripts shell, et un serveur HTTP qui écoute sur un port local. Sur Windows, trois approches sont théoriquement possibles.

Exécution native Windows via Python pour Windows : rarement fonctionnelle sans adapter manuellement les chemins, les séparateurs de fichiers et certaines dépendances système. La majorité des utilisateurs abandonnent à mi-chemin.

Machine virtuelle complète (VirtualBox, VMware) : fonctionnel mais lourd. Démarrage lent, partage de fichiers compliqué, ressources système importantes. Utile si vous avez déjà une VM Linux configurée, sinon c'est surdimensionné pour ce cas d'usage.

WSL2 : c'est l'option officielle de Microsoft pour exécuter Linux sur Windows. WSL2 utilise un vrai noyau Linux (pas une émulation), la communication réseau entre Linux et Windows est transparente, et les performances sur le filesystem Linux natif sont équivalentes à un système Linux réel. L'intégration avec l'écosystème Windows (navigateur, VS Code, explorateur de fichiers) est native.

WSL2 est disponible sur Windows 10 version 2004 (build 19041) ou supérieur, et sur toutes les versions de Windows 11. Si votre machine est à jour, vous l'avez.

Un point important avant de commencer : les fichiers de votre projet doivent rester dans le filesystem Linux (répertoire ~/ dans WSL2), pas dans /mnt/c/. Les accès cross-filesystem entre Windows et Linux dans WSL2 sont significativement plus lents — jusqu'à 10x dans certains cas — ce qui ralentit toutes les opérations de fichiers d'OpenClaw.

Installer OpenClaw sur Windows pas à pas

Prérequis

• Windows 10 version 2004 (build 19041) minimum, ou Windows 11
• 4 Go de RAM minimum (8 Go recommandés pour exécuter des agents)
• Droits administrateur sur la machine
• Connexion internet pour les téléchargements

Étape 1 — Activer WSL2

Ouvrez PowerShell en tant qu'administrateur (clic droit sur le menu Démarrer → "Windows PowerShell (Admin)") et exécutez :

wsl --install

Cette commande active la fonctionnalité WSL, installe le noyau Linux WSL2, et installe Ubuntu par défaut. Output attendu :

Installation en cours : Sous-système Windows pour Linux
Sous-système Windows pour Linux a été installé.
Installation en cours : Ubuntu
Ubuntu a été installé.

Redémarrez votre machine après l'installation. Sans redémarrage, WSL2 n'est pas opérationnel.

Si WSL était déjà installé en version 1, mettez à jour vers WSL2 :

wsl --set-default-version 2

Pour vérifier la version active après redémarrage :

wsl --list --verbose

Output attendu :

  NAME      STATE           VERSION
* Ubuntu    Running         2

La colonne VERSION doit afficher 2.

Étape 2 — Installer Ubuntu depuis le Microsoft Store

Si Ubuntu n'a pas été installé automatiquement, ou si vous voulez choisir une version spécifique :

1. Ouvrez le Microsoft Store
2. Recherchez "Ubuntu"
3. Choisissez Ubuntu 22.04 LTS ou Ubuntu 24.04 LTS
4. Cliquez "Obtenir" puis "Installer"

Au premier lancement, Ubuntu vous demande de créer un compte utilisateur Linux (différent de votre compte Windows) :

Enter new UNIX username: votre_nom
New password:
Retype new password:
passwd: password updated successfully

Ce nom d'utilisateur est utilisé pour votre répertoire home (/home/votre_nom/).

Étape 3 — Configurer Ubuntu pour OpenClaw

Dans le terminal Ubuntu (accessible depuis le menu Démarrer ou en tapant ubuntu dans PowerShell), commencez par mettre à jour le système :

sudo apt update && sudo apt upgrade -y

Output attendu : liste des paquets mis à jour, sans erreur.

Installez les dépendances nécessaires pour OpenClaw :

sudo apt install -y python3 python3-pip python3-venv git curl build-essential

Vérifiez les versions installées :

python3 --version
# Python 3.10.x ou supérieur

pip3 --version
# pip 22.x ou supérieur

git --version
# git version 2.x

Si python3 --version retourne une erreur, Python n'est pas dans le PATH. Ajoutez-le :

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Étape 4 — Installer OpenClaw dans WSL2

Placez-vous dans votre répertoire home Linux (important : pas dans /mnt/c/) :

cd ~

Créez un virtualenv et installez OpenClaw via pip :

python3 -m venv ~/openclaw-env
source ~/openclaw-env/bin/activate
pip install openclaw

Vérifiez l'installation :

openclaw --version
# openclaw x.x.x

Pour les détails de configuration des LLMs et clés API, consultez le guide de configuration d'OpenClaw.

Étape 5 — Accéder à OpenClaw depuis Windows

WSL2 expose automatiquement les ports Linux vers Windows. Quand OpenClaw tourne dans WSL2, son interface est accessible depuis le navigateur Windows.

Démarrez OpenClaw dans Ubuntu :

source .venv/bin/activate
openclaw start

Output attendu :

OpenClaw running on http://0.0.0.0:3000

Ouvrez maintenant votre navigateur Windows (Chrome, Firefox, Edge) et naviguez vers :

http://localhost:3000

L'interface d'OpenClaw s'affiche directement. Aucune configuration réseau supplémentaire n'est nécessaire : WSL2 gère le routage entre le réseau Linux et Windows.

Étape 6 — Configurer VS Code avec Remote - WSL

Pour éditer vos fichiers de configuration et vos agents depuis VS Code :

1. Installez VS Code sur Windows si ce n'est pas déjà fait
2. Ouvrez VS Code et installez l'extension "Remote - WSL" (identifiant : ms-vscode-remote.remote-wsl)
3. Dans le terminal Ubuntu, naviguez dans votre projet et ouvrez VS Code :

cd ~/openclaw
code .

VS Code s'ouvre en mode Remote WSL — vous éditez directement les fichiers Linux, avec IntelliSense et le terminal intégré qui pointe sur Ubuntu.

Checklist de validation

• wsl --list --verbose affiche Ubuntu en version 2
• python3 --version retourne Python 3.10+
• openclaw --version retourne un numéro de version
• openclaw start démarre sans erreur
• http://localhost:3000 charge l'interface dans le navigateur Windows
• Les fichiers du projet sont dans ~/ et non dans /mnt/c/

Exemple concret : lancer un premier agent depuis Windows

Voici un workflow complet depuis un poste Windows jusqu'à l'exécution d'un agent.

Contexte : vous voulez créer un agent de veille qui récupère des articles et les résume. Votre flux de travail depuis Windows :

1. Ouvrez le menu Démarrer, tapez "Ubuntu", lancez le terminal
2. Activez l'environnement virtuel et démarrez OpenClaw :

cd ~/openclaw-env
source ~/openclaw-env/bin/activate
openclaw start --port 3000

3. Dans votre navigateur Windows, ouvrez http://localhost:3000
4. Dans l'interface, créez un nouvel agent, ajoutez votre clé API LLM, et définissez la tâche

Pour éditer le fichier de configuration de l'agent depuis VS Code :

# Dans le terminal Ubuntu
code ~/mon-agent/agents/veille.yaml

VS Code s'ouvre en mode Remote WSL. Vous modifiez le fichier dans l'éditeur Windows, les changements sont instantanément visibles côté Linux.

Rechargez l'agent depuis l'interface localhost:8080 — OpenClaw détecte les modifications et recharge la configuration sans redémarrage complet.

Ce workflow — terminal Ubuntu pour les commandes, navigateur Windows pour l'interface, VS Code Remote pour l'édition — couvre 95% des interactions quotidiennes avec OpenClaw sur Windows.

Bonnes pratiques et erreurs fréquentes

Problème de performances : fichiers dans /mnt/c/

C'est l'erreur la plus courante. Si vous clonez votre projet dans C:\Users\vous\Documents\openclaw et l'ouvrez depuis WSL2 via /mnt/c/Users/vous/Documents/openclaw, chaque opération de fichier passe par une couche de translation filesystem. Les opérations qui prennent 50ms sur le filesystem Linux natif peuvent prendre 500ms via /mnt/c/. Règle : tous les fichiers de projet dans ~/ dans WSL2.

Permissions Linux sur des fichiers Windows

Si vous copiez des fichiers depuis Windows vers WSL2 (par glisser-déposer dans l'explorateur), les permissions peuvent être incorrectes. Vérifiez et corrigez :

chmod 644 fichier.yaml
chmod 755 script.sh

WSL2 qui ne démarre pas

Si wsl retourne une erreur après redémarrage, vérifiez que la virtualisation matérielle est activée dans le BIOS (option "Intel VT-x" ou "AMD-V"). Sur la plupart des machines récentes, c'est activé par défaut.

Port déjà utilisé

Si le port 8080 est pris par une autre application Windows, démarrez OpenClaw sur un port différent :

openclaw start --port 3001

Et accédez à http://localhost:3001.

Mémoire allouée à WSL2

Par défaut, WSL2 peut utiliser jusqu'à 50% de la RAM système. Pour les configurations avec plusieurs agents actifs, ajustez si nécessaire en créant C:\Users\vous\.wslconfig :

[wsl2]
memory=6GB
processors=4

Questions fréquentes

OpenClaw fonctionne-t-il sur Windows sans WSL2 ?

Non, pas de manière fiable. OpenClaw repose sur des dépendances système Linux et des scripts shell qui ne s'exécutent pas correctement dans un environnement Python Windows natif. WSL2 est la seule voie officielle et supportée pour utiliser OpenClaw sur Windows.

openclaw wsl2 est-il plus lent que sur Linux natif ?

Sur le filesystem Linux natif (~/), les performances de WSL2 sont quasi-identiques à Linux natif. La différence de performance n'apparaît que si vous stockez vos fichiers dans le filesystem Windows (/mnt/c/), ce qui est à éviter. Pour les accès réseau et CPU, WSL2 n'introduit aucune pénalité significative.

Comment installer openclaw wsl sur Windows 10 ?

Le processus est identique à Windows 11. Vérifiez que votre Windows 10 est à la version 2004 (build 19041) minimum via winver. Si c'est le cas, wsl --install fonctionne directement. En dessous de cette version, mettez à jour Windows avant de continuer.

Puis-je utiliser OpenClaw avec PowerShell directement ?

Non. PowerShell ne dispose pas de l'environnement Linux nécessaire. Toutes les commandes OpenClaw doivent être exécutées dans le terminal Ubuntu (WSL2). En revanche, vous pouvez lancer le terminal Ubuntu depuis PowerShell avec la commande wsl.

Comment accéder à l'interface openclaw windows 11 depuis un autre appareil ?

Par défaut, OpenClaw n'est accessible que sur localhost. Pour l'exposer sur le réseau local, démarrez-le avec openclaw start --host 0.0.0.0 et configurez une règle de port forwarding dans WSL2. Cette configuration sort du cadre de ce tutoriel — consultez le guide OpenClaw sur VPS pour les approches d'exposition réseau.

Articles liés

WSL2 vous donne un environnement Linux complet sur Windows — OpenClaw y tourne dans les mêmes conditions qu'un serveur Linux. L'étape suivante logique est de configurer votre instance : connecter vos LLMs, renseigner vos clés API, et définir vos premiers workflows d'agents. Si vous envisagez de faire tourner OpenClaw en production ou de le partager avec une équipe, un VPS Linux dédié est souvent plus adapté qu'un poste Windows.

• Installer OpenClaw — guide complet
• Configurer OpenClaw : LLMs, clés API et premiers agents
• Déployer OpenClaw sur un VPS Linux
• Premiers agents avec OpenClaw : tutoriel pas à pas