Guide d'installation complet OpenClaw : de la préparation à la première exécution

Mise à jour du 2026-06-08 : versions Node revérifiées dans la doc officielle OpenClaw (v24 recommandé, v22.14+ minimum), script en une ligne et flux onboard, et lectures complémentaires de la même série ajoutées. Les commandes et ports suivent la doc officielle.

L’installation d’OpenClaw s’est avérée plus fluide que prévu — que vous soyez sur Mac, Linux ou Windows, en suivant ce guide vous éviterez la plupart des pièges. Cet article s’adresse à ceux qui ne sont pas à l’aise en ligne de commande mais veulent essayer : voici l’expérience d’installation, structurée étape par étape.

Guide low-cost « élevage de homard » : ArkClaw démocratise les agents IA

OpenClaw (le homard) est puissant mais la configuration rebute ? ArkClaw de ByteDance Volcano Engine abaisse la barrière au minimum. Sans serveur ni configuration de tokens : un « assistant IA 24h/24 » capable de contrôler le navigateur, exécuter des scripts et gérer l’agenda, en un clic.

Le prix est réellement bas : 9,9 ¥/mois ; avec mon code d’invitation ZLKUK54M (inscrivez-vous ici), seulement 8,9 ¥. Développeurs : le plan Coding Plan Pro inclut l’offre gratuitement.

Qu’est-ce qu’OpenClaw ?

Avant d’installer, clarifions ce qu’est OpenClaw. En bref, c’est une plateforme open source d’assistant IA qui connecte des grands modèles de langage comme ChatGPT ou Claude à vos outils de messagerie habituels — Telegram ou WhatsApp, par exemple.

Pourquoi l’installer en local plutôt que d’utiliser l’IA dans le navigateur ?

Chacun a ses avantages. En local, vous pouvez :

• Maîtriser vos données et votre vie privée
• Personnaliser les fonctionnalités et les compétences
• Intégrer l’IA à votre flux de travail
• Si vous aimez expérimenter, utiliser des modèles locaux sans dépendre du cloud

Pour ma part, le plus attractif est de brancher l’IA sur Telegram : discuter au quotidien suffit, sans jongler entre applications.

Préparation : vérifier votre système

OpenClaw est assez indulgent côté prérequis. Avant de commencer, confirmez toutefois quelques points.

Compatibilité des systèmes d’exploitation

OpenClaw prend en charge nativement macOS et Linux. Sous Windows, la documentation d’installation officielle couvre Windows natif et WSL2 ; si vous comptez copier les commandes Linux ci-dessous, WSL2 est souvent le plus simple.

WSL2 exécute un environnement Linux léger dans Windows. Pour l’installer, ouvrez PowerShell et lancez :

wsl --install

Après installation, redémarrez l’ordinateur, puis tapez wsl dans PowerShell pour entrer l’environnement Linux.

Configuration matérielle

OpenClaw n’est pas exigeant. Recommandations officielles :

• Mémoire : 8 Go suffisent, 16 Go c’est mieux
• Stockage : au moins 20 Go libres (un SSD améliore nettement l’expérience)

En pratique, si votre PC fait tourner un navigateur sans ralentir, OpenClaw ira bien. J’utilise un vieux MacBook 8 Go, sans souci.

Environnement Node.js

Étape clé. OpenClaw repose sur Node.js : il faut l’installer d’abord. D’après la documentation officielle : Node 24 recommandé, minimum Node 22.14+ ; le script one-click avertit ou aide si la version est insuffisante.

Avec nvm, installez 24 comme version courante.

Installer Node.js sur macOS

Sur Mac, Homebrew est le plus simple :

🔥 Ne perdez plus des mois sur des produits sans demande ! Validez vos promesses SaaS avec Adsterra à petit budget →

Tester l'MVP →Pub

# Si Homebrew n'est pas encore installé
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Puis installer Node.js
brew install node

Installer Node.js sur Linux

Sous Linux, je recommande nvm (Node Version Manager) pour changer de version facilement :

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

# Après redémarrage du terminal, installer Node.js (24 recommandé)
nvm install 24
nvm use 24

Installer Node.js sous Windows (WSL2)

Dans WSL2, même méthode qu’en Linux avec nvm.

Ensuite, vérifiez la version :

node --version

Si vous voyez v22.14+ ou v24.x (recommandé), vous respectez les exigences officielles actuelles.

Gestionnaire de paquets : npm ou pnpm ?

Node.js inclut npm (Node Package Manager). OpenClaw fonctionne très bien avec npm.

Si vous connaissez pnpm, vous pouvez l’utiliser aussi. Par rapport à npm :

• Installation plus rapide
• Moins d’espace disque
• Gestion des dépendances plus stricte

Pour la plupart des utilisateurs, l’un ou l’autre convient. Je préfère pnpm, mais c’est une question de goût.

Pour installer pnpm :

npm install -g pnpm

Installer OpenClaw

Préparatifs terminés, passons à l’installation. Plusieurs méthodes existent ; voici celles que je recommande, par ordre de préférence.

Méthode 1 : script officiel (le plus recommandé)

La plus simple — une commande :

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

Le script :

• Vérifie l’environnement système
• Installe les dépendances nécessaires
• Télécharge et installe la CLI OpenClaw
• Vous invite à lancer la configuration initiale

Comptez 1 à 2 minutes selon la connexion. La première fois, voir défiler les logs dans le terminal donne une certaine satisfaction.

Méthode 2 : installation globale npm

Si vous préférez le gestionnaire de paquets :

npm install -g openclaw@latest

@latest garantit la dernière version. Ensuite, la commande openclaw est disponible dans le terminal.

Méthode 3 : installation globale pnpm

Avec pnpm :

pnpm add -g openclaw@latest

Même résultat qu’avec npm, outil différent.

Méthode 4 : depuis les sources (avancé)

Pour contribuer ou expérimenter en profondeur, clonez le dépôt GitHub :

# Cloner le dépôt
git clone https://github.com/openclaw/openclaw.git

# Entrer dans le répertoire
cd openclaw

# Installer les dépendances
pnpm install

# Construire
pnpm ui:build

Réservé aux développeurs ; déconseillé aux utilisateurs occasionnels.

Configuration initiale : faire tourner OpenClaw

Après installation, il faut passer par l’assistant de configuration. Étape importante, mais simple.

Lancer l’assistant onboard

Dans le terminal :

openclaw onboard --install-daemon

Cela lance un assistant interactif. --install-daemon installe OpenClaw comme service système : démarrage automatique au boot, sans relancer manuellement à chaque session.

L’assistant pose plusieurs questions :

Vultr - Serveur cloud NVMe haute performance, 32 emplacements mondiaux, déploiement Docker en un clic

Voir les tarifs →Pub

1. Choisir le mode d’exécution

En général, mode local (Local gateway) suffit, sauf déploiement sur un serveur distant.

2. Configurer le modèle IA

Choisissez le fournisseur :

• OpenAI (GPT-5, etc.)
• Anthropic (série Claude)
• Modèles locaux (configuration supplémentaire)

Saisissez votre clé API OpenAI ou Anthropic si vous en avez ; sinon, vous pourrez la configurer plus tard.

Obtenir une clé :

• OpenAI : platform.openai.com, page API keys
• Anthropic : console.anthropic.com, paramètres API

3. Définir le répertoire de travail

L’assistant demande où stocker config et données. Par défaut ~/.openclaw/ — Entrée pour accepter.

4. Connecter un canal de messagerie

Choisissez la plateforme pour dialoguer avec l’IA :

• Telegram : créer un bot via @BotFather, récupérer le token
• WhatsApp : un QR code s’affiche ; scannez avec l’app mobile
• Ignorer : pour n’utiliser que l’interface Web pour l’instant

J’ai choisi Telegram — configuration rapide :

1. Rechercher @BotFather dans Telegram
2. Envoyer /newbot
3. Nommer le bot
4. Copier le token généré
5. Le coller dans la config OpenClaw

5. Installer le démon

Enfin, installer le démon en arrière-plan ? Si oui, OpenClaw continue de tourner même après fermeture du terminal.

Comptez 5 à 10 minutes, surtout pour les clés API et les canaux.

Configuration manuelle (optionnel)

Pour affiner, éditez le fichier de configuration :

nano ~/.openclaw/openclaw.json

Fichier JSON avec toutes les options. Pour la plupart des utilisateurs, l’assistant suffit.

Première exécution : vérifier que tout fonctionne

Configuration terminée, démarrez OpenClaw.

Démarrer Gateway

Sans démon installé, démarrage manuel :

openclaw gateway --port 18789

18789 est le port par défaut ; vous pouvez en choisir un autre. En cas de succès :

✓ OpenClaw Gateway started on http://localhost:18789

Accéder à l’interface Web

Ouvrez le navigateur :

http://localhost:18789

Vous devriez voir le panneau de contrôle OpenClaw :

• Chat : zone de test de conversation
• Agents : gestion des agents IA
• Skills : plugins de compétences
• Settings : paramètres système

Tester une conversation

Dans Chat, envoyez par exemple « Bonjour » ou « Présente-toi ».

Si tout est bien configuré, l’IA répond — c’est votre assistant IA auto-hébergé.

Dépannage des problèmes courants

L’installation peut accrocher. Voici les cas fréquents.

Version Node.js incorrecte

Symptôme : erreur de compatibilité Node en lançant openclaw

Railway - Plateforme de déploiement moderne, sans opérations complexes, en ligne en quelques minutes

Commencer →Pub

Solution : vérifier la version, minimum v22.14 (recommandé v24)

node --version

Si trop basse, réinstallez ou mettez à jour Node.js.

Problèmes WSL2 (utilisateurs Windows)

Symptôme : erreurs diverses sous Windows

Solution : confirmer WSL2 installé et à jour

wsl --update

Clé API invalide

Symptôme : clé configurée mais pas de réponse ou erreur

Solution :

• Vérifier la copie (pas d’espaces en trop)
• Confirmer le solde du compte (OpenAI et Anthropic facturent l’usage)
• Régénérer la clé

Port occupé

Symptôme : le port 18789 est déjà utilisé au démarrage de Gateway

Solution : changer de port ou libérer le processus

# Voir qui utilise le port 18789
lsof -i :18789

# Démarrer sur un autre port
openclaw gateway --port 18790

Problèmes de permissions

Symptôme : permissions insuffisantes à l’installation

Solution : sous Linux/Mac, parfois sudo, ou vérifier les droits sur le répertoire

# S'assurer des droits d'écriture
chmod -R 755 ~/.openclaw

Rappels de sécurité

Une fois OpenClaw installé, gardez en tête :

1. Ne pas exposer le port : 18789 écoute localhost par défaut — ne le publiez pas sur Internet, sinon n’importe qui pourrait accéder à votre IA
2. Protéger les clés API : sensibles dans la config — ne les partagez pas, ne les commitez pas dans Git
3. Accès distant via tunnel SSH : depuis un autre appareil, préférez un tunnel SSH plutôt qu’ouvrir le port

# Accéder depuis une autre machine via SSH
ssh -L 18789:localhost:18789 user@your-server

À lire aussi

• Configuration OpenClaw : le guide complet de openclaw.json
• Architecture OpenClaw en détail : conception à trois niveaux
• OpenClaw vs ChatGPT : architecture, coût et confidentialité

Pour conclure

Vous devriez maintenant avoir OpenClaw installé. Récapitulons le parcours :

Ensuite, vous pouvez :

• Explorer Skills et ajouter des capacités à l’IA
• Connecter Telegram ou WhatsApp pour l’utiliser dans la messagerie
• Si ça vous intéresse, développer des compétences personnalisées
• Consulter la doc officielle pour les fonctions avancées

OpenClaw est open source, mais l’expérience est déjà solide. En cas de blocage, les Issues GitHub et la communauté sont actives.

Première fois avec ce type d’outil, ça peut sembler dense — une fois passé l’install, c’est surtout de la routine. Prenez votre temps, cherchez en ligne : la plupart des problèmes se résolvent.

Bon amusement !