Comment Installer OpenClaw : Guide Étape par Étape 2026

OpenClaw est devenu le projet open source à la croissance la plus rapide de l’histoire de GitHub. Dans ce guide, nous parcourons le processus d’installation complet — de zéro à un agent IA opérationnel connecté à votre application de messagerie. Chaque commande ici est réelle et testée.

Avant de commencer, une note de sécurité : Ce guide couvre l’installation à des fins de développement et de test. Pour un déploiement professionnel, lisez notre guide de sécurité entreprise et envisagez une configuration conforme RGPD sur Hetzner avant de passer en production.

Prérequis

Vous aurez besoin de :

1. Node.js 22 ou supérieur — OpenClaw requiert Node 22+
2. npm — inclus avec Node.js
3. Une clé API LLM — OpenAI, Anthropic (Claude), DeepSeek, ou local via Ollama
4. Une application de messagerie — WhatsApp, Telegram, Discord, Slack, Signal, ou 20+ autres

Étape 1 : Installer Node.js 22+

Nous recommandons nvm (Node Version Manager) pour une gestion facile des versions.

Sur macOS / Linux :

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

# Recharger votre shell
source ~/.bashrc   # ou source ~/.zshrc sur macOS

# Installer Node 22
nvm install 22
nvm use 22

# Vérifier
node --version   # Devrait afficher v22.x.x
npm --version

Sur Windows : Téléchargez et exécutez l’installateur Node.js 22 LTS depuis nodejs.org. Après installation, ouvrez un nouveau terminal PowerShell et vérifiez :

node --version
npm --version

Sur Windows (WSL2 — recommandé pour une configuration similaire à la production) :

# Dans le terminal Ubuntu WSL2
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

Étape 2 : Installer OpenClaw

Avec Node.js prêt, installez OpenClaw globalement :

npm install -g openclaw@latest

Cela télécharge et installe la dernière version d’OpenClaw comme outil CLI global.

Vérifiez l’installation :

openclaw --version

Vous devriez voir une chaîne de version au format vAAAA.M.J (ex. v2026.3.15).

Important : Installez toujours la dernière version. Les versions antérieures à v2026.1.30 sont affectées par la CVE-2026-25253 (vulnérabilité RCE en un clic, CVSS 8,8). Le correctif a été publié le 29 janvier 2026.

Étape 3 : Obtenir Votre Clé API LLM

OpenClaw a besoin d’un modèle de langage pour alimenter son raisonnement. Choisissez-en un :

Option A : Anthropic (Claude) — Recommandé

1. Allez sur console.anthropic.com
2. Créez un compte et ajoutez un moyen de paiement
3. Naviguez vers Clés API → Créer une clé
4. Copiez votre clé : sk-ant-api03-...

Option B : OpenAI (GPT-4)

1. Allez sur platform.openai.com
2. Créez un compte et ajoutez une facturation
3. Naviguez vers Clés API → Créer une nouvelle clé secrète
4. Copiez votre clé : sk-proj-...

Option C : Ollama (Local — Gratuit, conforme RGPD)

Exécutez des modèles localement — aucune clé API nécessaire, aucune donnée ne quitte votre machine.

# Installer Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# Télécharger un modèle (choisissez selon votre matériel)
ollama pull llama3          # 8B, ~5 Go, bon pour la plupart des tâches
ollama pull mistral         # 7B, ~4 Go, rapide et capable
ollama pull deepseek-r1:7b  # 7B, raisonnement solide

# Vérifier qu'Ollama tourne
ollama list

Pour les entreprises luxembourgeoises avec des contraintes RGPD, Ollama est l’option la plus respectueuse de la vie privée — tout le traitement se fait sur votre propre matériel.

Étape 4 : Lancer l’Assistant de Configuration

OpenClaw dispose d’un processus de configuration guidé :

openclaw onboard --install-daemon

L’assistant vous posera plusieurs questions. Voici ce à quoi vous attendre :

Choisir Votre Fournisseur LLM

? Sélectionnez votre fournisseur IA :
❯ Anthropic (Claude)
  OpenAI (GPT-4)
  DeepSeek
  Ollama (local)
  Autre (endpoint personnalisé)

Sélectionnez votre fournisseur et entrez votre clé API quand demandé. Si vous utilisez Ollama, assurez-vous qu’il tourne (ollama serve).

Connecter une Application de Messagerie

? Quelle plateforme de messagerie souhaitez-vous utiliser ?
❯ WhatsApp
  Telegram
  Discord
  Slack
  Signal
  (plus d'options...)

Connexion WhatsApp : Après avoir sélectionné WhatsApp, un QR code apparaîtra dans votre terminal. Ouvrez WhatsApp sur votre téléphone → Paramètres → Appareils liés → Lier un appareil. Scannez le QR code. Une fois lié, OpenClaw affichera :

✓ WhatsApp connecté avec succès

Connexion Telegram : Sélectionnez Telegram, puis suivez les instructions pour créer un bot via BotFather. Vous collerez le token du bot quand demandé.

Connexion Discord : Vous devrez créer une application Discord et un bot sur discord.com/developers. Collez le token du bot quand demandé.

Installer comme Service Système

Le flag --install-daemon configure OpenClaw pour démarrer automatiquement au démarrage du système :

? Installer OpenClaw comme service système ? (Recommandé)
❯ Oui — tourne en arrière-plan, démarre au démarrage
  Non — je le démarrerai manuellement

Sélectionnez Oui pour une configuration persistante. Sur Linux, cela crée un service systemd. Sur macOS, un LaunchAgent.

Étape 5 : Vérifier l’Installation

Une fois l’onboarding terminé, testez votre agent en envoyant un message via votre app connectée :

Vous : Bonjour, tu fonctionnes ?
OpenClaw : Oui ! Je suis votre agent OpenClaw. Je suis prêt. Que souhaitez-vous que je fasse ?

Essayez une tâche simple :

Vous : Quelle est la date et l'heure actuelles ?
OpenClaw : Il est actuellement 14h32 le mercredi 15 mars 2026.

Puis quelque chose de plus intéressant :

Vous : Recherche les dernières actualités sur les agents IA
OpenClaw : [Navigation sur le web...]
Voici les principales actualités sur les agents IA des dernières 24 heures : ...

Étape 6 : Installer Vos Premières Skills

Les skills étendent les capacités d’OpenClaw. Parcourez-les sur github.com/openclaw/clawhub.

Installez une skill via OpenClaw :

Vous : Installe la skill Gmail
OpenClaw : Installation de la skill Gmail depuis ClawHub...
✓ Installée. Pour connecter Gmail, allez dans Paramètres → Skills → Gmail et autorisez l'accès.

Ou via CLI :

openclaw skills install gmail
openclaw skills install calendar
openclaw skills install seo-research

Avertissement de sécurité : Avant d’installer une skill, vérifiez son dépôt GitHub. Installez uniquement des skills avec des commits récents, un code source visible, et des éditeurs de confiance. Évitez les skills aux noms génériques sans documentation — ce sont des patterns courants parmi les 1 184 skills malveillantes identifiées par les chercheurs en sécurité.

Fichier de Configuration

OpenClaw stocke sa configuration dans ~/.openclaw/config.json. Paramètres clés à ajuster :

{
  "llm": {
    "provider": "anthropic",
    "model": "claude-3-5-sonnet-20241022",
    "maxTokens": 4096
  },
  "security": {
    "requireConfirmation": true,
    "allowedPaths": ["/home/user/travail"],
    "blockedCommands": ["rm -rf", "format", "dd"]
  },
  "messaging": {
    "platform": "whatsapp",
    "autoReply": true
  }
}

Définissez toujours requireConfirmation: true pour les opérations destructives — cela ajoute une étape de confirmation avant qu’OpenClaw exécute des suppressions de fichiers, des emails, ou des appels API externes.

Mettre à Jour OpenClaw

Restez à jour — OpenClaw publie fréquemment des mises à jour, souvent avec des correctifs de sécurité :

npm update -g openclaw
openclaw --version

Configurez un rappel hebdomadaire pour exécuter cette commande. Mieux encore, pour un déploiement VPS, utilisez une tâche cron :

# Ajouter au crontab (crontab -e)
0 3 * * 1 npm update -g openclaw  # Chaque lundi à 3h

Utiliser OpenClaw sur un VPS (Configuration Professionnelle)

Pour un usage professionnel, ne dépendez jamais uniquement d’une installation sur laptop. Un VPS garantit que votre agent OpenClaw est toujours disponible.

Recommandé : Hetzner Cloud (serveurs UE, conforme RGPD, excellent rapport qualité/prix) :

1. Créez un compte Hetzner
2. Créez un nouveau serveur : Ubuntu 22.04, CX21 (2 vCPU, 4 Go RAM)
3. Connectez-vous en SSH à votre serveur
4. Suivez les étapes d’installation Node.js et OpenClaw ci-dessus
5. Configurez un pare-feu : autorisez uniquement SSH (port 22) et votre IP VPN — n’exposez jamais les ports OpenClaw publiquement

# Pare-feu Hetzner basique
ufw allow 22/tcp
ufw enable
ufw status

Nous couvrons la configuration VPS complète conforme RGPD dans notre guide de déploiement Hetzner.

Résolution des Problèmes Courants

« Commande introuvable : openclaw »

Les binaires globaux Node ne sont pas dans votre PATH. Solution :

export PATH="$PATH:$(npm bin -g)"
# Ajoutez la ligne ci-dessus à votre ~/.bashrc ou ~/.zshrc

Le QR code WhatsApp expire avant le scan

Le QR code a une fenêtre de 60 secondes. Relancez openclaw onboard et scannez plus vite. Assurez-vous que votre téléphone a une connexion internet stable.

« Clé API LLM invalide »

Vérifiez votre clé. Les clés Anthropic commencent par sk-ant-, les clés OpenAI par sk-proj-. Vérifiez votre tableau de bord de fournisseur pour tout problème de facturation.

Le démon OpenClaw ne démarre pas au démarrage

# Vérifier le statut du service systemd (Linux)
systemctl status openclaw
journalctl -u openclaw -n 50

# Redémarrer le service
systemctl restart openclaw

Incompatibilité de version Node

node --version   # Doit être 22+
nvm use 22       # Passer à Node 22
npm install -g openclaw@latest  # Réinstaller

Prochaines Étapes

Maintenant qu’OpenClaw tourne, voici quoi explorer :

• OpenClaw pour les PME luxembourgeoises — exemples d’automatisation de workflows réels
• OpenClaw & RGPD : Configuration Hetzner — déploiement conforme RGPD
• OpenClaw en Entreprise — durcissement sécurité avant production
• Meilleures Skills OpenClaw pour les Agences — les skills les plus utiles

Besoin d’aide pour déployer OpenClaw pour votre entreprise luxembourgeoise ? dcode fournit implémentation complète, durcissement sécurité et support continu. Réservez une consultation gratuite.