openclaw-windows

openclaw-windows-install

Salut à tous ! Aujourd'hui, on va voir comment installer OpenClaw sur Windows — cet assistant IA open source que vous pouvez héberger directement sur votre propre machine.

Si vous en avez marre de confier vos données à des services cloud d'IA et que vous voulez un assistant entièrement contrôlable, capable d'accéder à vos fichiers locaux et d'exécuter des tâches concrètes, OpenClaw est fait pour vous.

Qu'est-ce qu'OpenClaw ?

OpenClaw est une passerelle IA auto-hébergée qui peut :

  • 📱 Se connecter à plusieurs plateformes de messagerie (WhatsApp, Telegram, Discord, WeChat, etc.)
  • 🤖 Interfacer différents modèles d'IA (OpenAI, Claude, Gemini, modèles locaux, etc.)
  • 📁 Accéder à votre système de fichiers local et à vos APIs
  • ⚙️ Exécuter des tâches réelles, pas seulement discuter
  • 🔒 Fonctionner entièrement sur votre machine, vos données ne quittent jamais votre ordinateur

Avantages principaux : - Auto-hébergé — tourne sur votre matériel, vous gardez le contrôle - Multi-canal — une seule passerelle pour plusieurs applications de messagerie - Open source — licence MIT, piloté par la communauté - Accessible — Node.js 22+, installation en 5 minutes

Configuration système requise

Avant de commencer, vérifiez que votre système répond aux critères suivants :

Composant Requis Notes
Système d'exploitation Windows 10/11 Windows 11 recommandé
Node.js 22 ou supérieur Obligatoire ! Les anciennes versions échoueront
Mémoire RAM 4 Go minimum 8 Go+ recommandés
Espace disque 2 Go disponibles Pour l'installation et le cache
Réseau Connexion internet stable Pour télécharger les dépendances et appeler les APIs

⚠️ Note importante

Les utilisateurs Windows doivent impérativement utiliser WSL2 !

Le chemin officiel pour faire fonctionner OpenClaw sur Windows passe par WSL2 (Windows Subsystem for Linux 2). Même si c'est théoriquement possible de le faire tourner nativement sur Windows, vous rencontrerez toutes sortes de problèmes de compatibilité. Ce guide détaille la méthode WSL2.

Étape 1 : Installer WSL2

Méthode 1 : Installation en un clic (recommandée)

Ouvrez PowerShell ou l'Invite de commandes en tant qu'administrateur et exécutez :

POWERSHELL 
wsl --install

Cette commande va : 1. Activer la fonctionnalité WSL 2. Activer la plateforme de machine virtuelle 3. Installer Ubuntu comme distribution par défaut 4. Demander un redémarrage de l'ordinateur

Après le redémarrage, Ubuntu s'ouvrira automatiquement et vous demandera de configurer un nom d'utilisateur et un mot de passe.

Méthode 2 : Installation manuelle

Si l'installation en un clic échoue, vous pouvez procéder manuellement :

POWERSHELL 
# 1. Activer WSL
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 2. Activer la plateforme de machine virtuelle
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

# 3. Redémarrer l'ordinateur
shutdown /r /t 0

# 4. Après redémarrage, définir WSL2 comme version par défaut
wsl --set-default-version 2

# 5. Installer Ubuntu depuis le Microsoft Store
# Ou exécutez :
wsl --install -d Ubuntu

Vérifier l'installation de WSL2

POWERSHELL 
# Vérifier la version de WSL
wsl --version

# Lister les distributions installées
wsl --list --verbose

# S'assurer qu'Ubuntu utilise WSL2
wsl --set-version Ubuntu 2

Sortie attendue :

  NAME      STATE           VERSION
* Ubuntu    Running         2

Étape 2 : Installer Node.js 22 dans WSL2

OpenClaw nécessite Node.js 22 ou supérieur. C'est la cause d'échec d'installation la plus fréquente !

Méthode 1 : Via NodeSource (recommandée)

Dans le terminal Ubuntu, exécutez :

BASH 
# 1. Mettre à jour la liste des paquets
sudo apt update

# 2. Installer curl (si pas déjà installé)
sudo apt install -y curl

# 3. Télécharger et exécuter le script de configuration NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

# 4. Installer Node.js
sudo apt install -y nodejs

# 5. Vérifier l'installation
node --version
npm --version

Sortie attendue :

v22.x.x
10.x.x

Méthode 2 : Via nvm (Node Version Manager)

Si vous avez besoin de gérer plusieurs versions de Node.js :

BASH 
# 1. Installer nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

# 2. Recharger la configuration du shell
source ~/.bashrc

# 3. Installer Node.js 22
nvm install 22

# 4. Définir comme version par défaut
nvm use 22
nvm alias default 22

# 5. Vérifier
node --version

⚠️ Dépannage des erreurs courantes

Erreur 1 : node: command not found

BASH 
# Vérifier le chemin global de npm
npm prefix -g

# Ajouter au PATH (à ajouter dans ~/.bashrc)
export PATH="$(npm prefix -g)/bin:$PATH"
source ~/.bashrc

Erreur 2 : Problèmes de permissions

BASH 
# Réparer les problèmes de permissions npm
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Étape 3 : Installer OpenClaw

Méthode 1 : Script d'installation officiel (recommandé)

Dans le terminal Ubuntu, exécutez :

BASH 
# Installation en un clic
curl -fsSL https://openclaw.sh/install | bash

Le processus d'installation va : 1. Télécharger le CLI OpenClaw 2. L'installer globalement via npm 3. Créer le répertoire de configuration ~/.openclaw 4. Lancer l'assistant de configuration interactif

Méthode 2 : Installation manuelle avec npm

BASH 
# Installer OpenClaw globalement
npm install -g openclaw

# Vérifier l'installation
openclaw --version

Vérification post-installation

BASH 
# Vérifier l'état du système
openclaw doctor

# Voir le statut
openclaw status

# Ouvrir le panneau de contrôle Web
openclaw dashboard

Étape 4 : Finaliser la configuration initiale

Après l'installation, OpenClaw lance automatiquement l'assistant de configuration interactif. S'il ne se lance pas, exécutez manuellement :

BASH 
openclaw onboard --install-daemon

Détail des étapes de configuration

1. Choisir un fournisseur de modèle IA

OpenClaw prend en charge plusieurs modèles d'IA :

  • OpenAI (GPT-4, GPT-3.5)
  • Anthropic (Claude 3/3.5)
  • Google (Gemini Pro/Flash)
  • Modèles locaux (via LM Studio, Ollama, etc.)

Configuration recommandée : - Privilégier la qualité → Claude 3.5 Sonnet - Privilégier le rapport qualité-prix → Gemini 2.0 Flash - Privilégier la confidentialité → Qwen/Llama en local

Saisissez votre clé API dans l'assistant de configuration.

2. Configurer les canaux de communication

Vous pouvez choisir comment interagir avec OpenClaw :

  • Interface Web — Accès via le navigateur (activé par défaut)
  • Telegram — Nécessite un Bot Token
  • WhatsApp — Nécessite de scanner un QR code
  • Discord — Nécessite un Bot Token
  • Passer — Configuration ultérieure

Conseil pour les débutants : Commencez par l'interface Web, puis configurez les autres canaux une fois familiarisé.

3. Activer les compétences (Skills)

Le système de compétences d'OpenClaw lui permet d'exécuter diverses tâches :

  • ✅ Opérations sur les fichiers — Lire, écrire, rechercher du contenu
  • ✅ Recherche Web — Obtenir des informations en temps réel
  • ✅ Exécution de code — Lancer des scripts Python/Shell
  • ✅ Tâches planifiées — Configurer des rappels et automatisations
  • ✅ Multimodal — Traiter des images et des documents

Recommandation : Activez tout, vous pourrez restreindre les permissions dans le fichier de configuration.

4. Installer le démon

Pour qu'OpenClaw tourne en continu, installez-le comme service système :

BASH 
# Dans l'assistant de configuration, choisissez "Install Daemon"
# Ou exécutez manuellement :
openclaw gateway install
openclaw gateway start

Étape 5 : Commencer à utiliser OpenClaw

Accéder au panneau de contrôle Web

BASH 
openclaw dashboard

Cela ouvrira http://127.0.0.1:18789/ dans votre navigateur.

Fonctionnalités principales : - 💬 Discuter avec l'assistant IA - 📊 Consulter l'historique des sessions - ⚙️ Gérer la configuration et les compétences - 📅 Configurer des tâches planifiées - 📝 Voir les journaux

Commandes CLI courantes

BASH 
# Vérifier le statut
openclaw status

# Diagnostic de santé
openclaw doctor

# Lister les modèles disponibles
openclaw models list

# Rechercher dans la mémoire
openclaw memory search "mot-clé"

# Voir la documentation
openclaw docs

# Redémarrer la passerelle
openclaw gateway restart

# Mettre à jour OpenClaw
openclaw update

Exemples de premières tâches

Dans l'interface Web ou le chat, essayez :

Crée un fichier de test avec le contenu "Hello OpenClaw!"

Fais une recherche sur les actualités tech du jour

Lis le fichier readme.txt sur mon bureau et fais-en un résumé

Dépannage des problèmes courants

Problème 1 : openclaw: command not found

Cause : Le chemin global de npm n'est pas dans le PATH

Solution :

BASH 
# Vérifier le chemin
npm prefix -g

# Ajouter au ~/.bashrc
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Ou rouvrez simplement le terminal

Problème 2 : Problèmes réseau WSL2

Symptômes : Impossible de télécharger des dépendances ou de se connecter à une API

Solution :

BASH 
# Dans PowerShell Windows, exécutez
wsl --shutdown

# Redémarrer WSL
wsl

# Vérifier le DNS
cat /etc/resolv.conf

# Si besoin d'utiliser un DNS public
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf

Problème 3 : Erreurs de permissions

Symptômes : EACCES: permission denied

Solution :

BASH 
# Réparer les permissions npm
sudo chown -R $(whoami) ~/.npm
sudo chown -R $(whoami) ~/.openclaw

# Ou utilisez nvm pour éviter sudo

Problème 4 : La passerelle ne démarre pas

Vérifier les journaux :

BASH 
openclaw gateway status
openclaw gateway logs

Causes fréquentes : - Port déjà utilisé (par défaut 18789) - Erreur dans le fichier de configuration - Clé API invalide

Solution :

BASH 
# Vérifier l'occupation du port
netstat -tlnp | grep 18789

# Reconfigurer
openclaw onboard

# Redémarrer la passerelle
openclaw gateway restart

Problème 5 : Version de Node.js trop ancienne

Vérifier la version :

BASH 
node --version

Mettre à jour Node.js :

BASH 
# Si vous utilisez nvm
nvm install 22
nvm use 22
nvm alias default 22

# Si vous utilisez NodeSource
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

Configuration avancée

Modifier le fichier de configuration

Le fichier de configuration se trouve dans ~/.openclaw/openclaw.json

Exemple de configuration :

JSON 
{
  "channels": {
    "webchat": {
      "enabled": true,
      "port": 18789
    },
    "telegram": {
      "enabled": true,
      "botToken": "YOUR_BOT_TOKEN"
    }
  },
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@openclaw"]
    }
  },
  "skills": {
    "allowList": ["file.read", "file.write", "web.search"],
    "denyList": ["exec"]
  }
}

Variables d'environnement

Vous pouvez personnaliser les chemins via des variables d'environnement :

BASH 
# Répertoire de configuration personnalisé
export OPENCLAW_HOME=/custom/path

# Répertoire d'état personnalisé
export OPENCLAW_STATE_DIR=/custom/state

# Fichier de configuration personnalisé
export OPENCLAW_CONFIG_PATH=/custom/config.json

Renforcement de la sécurité

Recommandations pour la production :

  1. Restreindre les sources d'accès
JSON 
{
  "channels": {
    "webchat": {
      "allowFrom": ["192.168.1.0/24"]
    }
  }
}
  1. Activer l'authentification
JSON 
{
  "auth": {
    "required": true,
    "token": "your-secure-token"
  }
}
  1. Restreindre les permissions de compétences
JSON 
{
  "skills": {
    "allowList": ["file.read", "web.search"],
    "denyList": ["exec", "file.delete"]
  }
}

Optimisation des performances

Optimisation de la mémoire

Si la mémoire est limitée :

JSON 
{
  "runtime": {
    "maxMemory": "2GB",
    "sessionLimit": 5
  }
}

Optimisation du démarrage

BASH 
# Désactiver les compétences inutilisées
openclaw skills disable unused-skill

# Utiliser un modèle léger
openclaw model set gemini-2.0-flash

Prochaines étapes

Une fois l'installation terminée, vous pouvez :

  1. 📚 Lire la documentation officielle — docs.openclaw.ai
  2. 🔧 Explorer le système de compétences — Voir les compétences disponibles et les exemples
  3. 🤖 Configurer l'automatisation — Mettre en place des tâches planifiées et des rappels
  4. 🔌 Connecter plus de canaux — Ajouter Telegram, WhatsApp, etc.
  5. 👥 Rejoindre la communauté — Discord communautaire

Résumé

Le processus complet d'installation d'OpenClaw sur Windows :

  1. ✅ Installer WSL2 et Ubuntu
  2. ✅ Installer Node.js 22+
  3. ✅ Exécuter le script d'installation OpenClaw
  4. ✅ Finaliser la configuration initiale
  5. ✅ C'est parti !

Le tout prend environ 10 à 15 minutes. Même si les étapes semblent nombreuses, la plupart ne se configurent qu'une seule fois.

Points clés à retenir : - ⚠️ Utilisez WSL2, n'essayez pas Windows natif - ⚠️ Node.js doit être en version 22 ou supérieure - ⚠️ Exécutez openclaw doctor après l'installation pour vérifier l'état - ✅ Installez le démon pour un lancement automatique au démarrage

OpenClaw est un outil puissant. Une fois configuré, il deviendra votre assistant IA disponible 24h/24 pour gérer toutes sortes de tâches. Gestion de fichiers, recherche d'informations, automatisation de workflows — il gère tout.

Si vous rencontrez des problèmes lors de l'installation, n'hésitez pas à consulter la documentation officielle ou à laisser un commentaire !

Ressources connexes : - Documentation officielle OpenClaw - Repository GitHub OpenClaw - Documentation officielle WSL2 - Télécharger Node.js - Discord communautaire OpenClaw

Prochain épisode : On explorera en profondeur le système de compétences d'OpenClaw et on vous montrera comment automatiser des workflows complexes avec votre assistant IA. Restez à l'écoute !