Comment installer OpenClaw : guide d'installation complet étape par étape 2026

Présentation

L’installation d’OpenClaw est simple, avec plusieurs méthodes pour s’adapter à différentes préférences et niveaux de confort technique. Que vous souhaitiez une installation rapide en une seule ligne, préfériez npm ou souhaitiez créer à partir des sources, ce guide couvre toutes les options.

Ce guide couvre l’installation sur macOS, Windows et Linux. Pour plus de détails spécifiques à la plateforme, consultez nos guides dédiés :

• Guide de configuration macOS
• Guide d’installation de Windows
• Guide de configuration Linux

Prérequis

Avant d’installer OpenClaw, assurez-vous d’avoir :

• Node.js 18+ — Requis pour exécuter OpenClaw (le programme d’installation en une seule ligne gère cela automatiquement)
• Accès au terminal — Interface de ligne de commande sur votre système
• Connexion Internet — Pour télécharger des packages et des dépendances
• 2 Go+ de RAM — Recommandé pour un fonctionnement fluide

Le programme d’installation en une seule ligne installera automatiquement Node.js s’il n’est pas déjà présent, vous pouvez donc continuer même si Node.js n’est pas installé.

Méthodes d’installation

Méthode 1 : installation en une seule ligne (recommandée)

Le moyen le plus rapide de faire fonctionner OpenClaw est le programme d’installation en une seule ligne. Il gère automatiquement l’installation de Node.js et toutes les dépendances.

macOS/Linux

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

Ce script :

1. Recherchez Node.js (installez-le s’il est manquant)
2. Installez OpenClaw globalement via npm
3. Configurez les autorisations nécessaires
4. Vérifiez l’installation

Une fois l’installation terminée, vous verrez :

✓ OpenClaw installed successfully!
  Run 'openclaw onboard' to get started.

Windows (PowerShell)

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

Ou en utilisant la méthode npm (voir ci-dessous) qui fonctionne de manière identique sous Windows.

Méthode 2 : installation de npm

Si Node.js est déjà installé, vous pouvez installer OpenClaw directement via npm :

npm i -g openclaw

Cela installe OpenClaw globalement, rendant la commande openclaw disponible dans tout le système.

Utilisation de pnpm :

pnpm add -g openclaw

Utiliser du fil :

yarn global add openclaw

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

Pour les développeurs qui souhaitent modifier le code source ou contribuer, vous pouvez créer OpenClaw à partir des sources :

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

Exécutez ensuite OpenClaw en utilisant :

pnpm run openclaw onboard

Ou associez-le globalement :

pnpm link --global

Cette méthode vous donne un contrôle total sur la base de code et facilite la personnalisation d’OpenClaw selon vos besoins.

Méthode 4 : application macOS Companion (bêta)

Pour les utilisateurs de macOS, il existe une application de barre de menu complémentaire qui fournit une interface graphique aux côtés de la CLI :

1. Téléchargez depuis GitHub Releases
2. Ouvrez le fichier .dmg
3. Faites glisser OpenClaw vers les applications
4. Lancement depuis Applications ou Spotlight

L’application compagnon fonctionne parallèlement à l’installation CLI et fournit :

• Accès à la barre de menus
• Indicateurs d’état visuels
• Accès rapide aux paramètres
• Visionneuse de journaux

Exigences :

• macOS 14+ (Sonoma ou version ultérieure)
• Universal Binary (fonctionne sur Apple Silicon et Intel)

Configuration système requise

macOS

• macOS 13 Ventura ou version ultérieure
• Node.js 18+ (auto-installé par one-liner)
• 2 Go+ de RAM recommandés
• Processeur Apple Silicon (M1/M2/M3) ou Intel

Fenêtres

• Windows 10 ou Windows 11
• Node.js 18+
• PowerShell 5.1+ ou Windows Terminal
• WSL2 recommandé pour une meilleure expérience

Linux

• Ubuntu 20.04+, Debian 11+, Fedora 34+ ou similaire
• Node.js 18+
• 2 Go+ de RAM
• Architecture ARM64 ou x86_64
• Raspberry Pi 4+ pris en charge

Configuration post-installation

Après l’installation, vous devez configurer OpenClaw avant de l’utiliser. Exécutez la commande d’intégration :

openclaw onboard

Cette configuration interactive vous guidera à travers :

1. Sélection du modèle d’IAChoisissez votre fournisseur d’IA :

• Claude Anthropic — Claude 3.5 Sonnet, Claude 3 Opus, Claude 4
• OpenAI GPT — GPT-4o, GPT-4 Turbo, GPT-4.1
• Modèles locaux — Ollama, LM Studio, MiniMax

Vous aurez besoin de clés API pour les modèles cloud. Pour Claude, récupérez votre clé sur console.anthropic.com. Pour OpenAI, obtenez votre clé sur platform.openai.com.

2. Configuration des personnages

Configurez la personnalité de votre IA :

• Nom (par défaut : “Homard”)
• Ton et style
• Capacités et limites
• Préférences de réponse

3. Configuration de la mémoire

Configurez la mémoire persistante :

• Lieu de stockage
• Politiques de conservation de la mémoire
• Taille de la fenêtre contextuelle

4. Compétences initiales

Sélectionnez les compétences par défaut à activer :

• Gestion des emails
• Intégration du calendrier
• Contrôle du navigateur
• Accès au système de fichiers

Vérification de l’installation

Après l’installation, vérifiez que tout fonctionne :

openclaw --version

Vous devriez voir le numéro de version (par exemple, v1.0.0).

Testez l’installation :

openclaw test

Cela exécute un diagnostic rapide pour garantir que tous les composants fonctionnent correctement.

Connecter des applications de chat

Une fois OpenClaw installé et configuré, connectez vos applications de chat :

openclaw integrations

Cela ouvre un menu interactif pour configurer :

• WhatsApp
• Télégramme
• Discorde
• Mou
• iMessage
• Autres plateformes

Pour obtenir des guides de configuration détaillés, voir :

• Configuration WhatsApp
• Configuration du télégramme
• Configuration Discord
• Configuration Slack
• Configuration iMessage

Démarrage d’OpenClaw

Pour démarrer le serveur OpenClaw :

openclaw

Cela démarre le serveur local et connecte toutes les intégrations configurées. Vous verrez des messages d’état indiquant quelles applications de chat sont connectées.

Pour exécuter en arrière-plan :

openclaw start --daemon

Ou utilisez un gestionnaire de processus comme pm2 :

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

Dépannage

L’installation échoue

Si le programme d’installation monoligne échoue :

1. Vérifiez la version de Node.js :

   node --version

   Doit être v18 ou supérieur.

2. Essayez npm install directement :

   npm i -g openclaw

3. Vérifiez les autorisations :

   sudo npm i -g openclaw

   (macOS/Linux uniquement)

Commande introuvable

Si la commande openclaw n’est pas trouvée :

1. Vérifiez le chemin global npm :

   npm config get prefix

2. Ajouter au CHEMIN (si nécessaire) :

   export PATH="$PATH:$(npm config get prefix)/bin"

3. Redémarrez le terminal après l’installation

Port déjà utilisé

Si vous voyez des erreurs « port déjà utilisé » :

openclaw --port 3001

Ou recherchez et tuez le processus en utilisant le port :

lsof -ti:3000 | xargs kill

Erreurs d’autorisation

Sous macOS/Linux, vous devrez peut-être accorder des autorisations :

• Accès aux terminaux
• Accès au système de fichiers
• Accès au réseau

Vérifiez les Préférences Système → Sécurité et confidentialité.

Mise à jour d’OpenClaw

Pour mettre à jour vers la dernière version :

npm update -g openclaw

Ou réexécutez le programme d’installation one-liner (il sera mis à jour s’il est déjà installé).

Vérifiez les mises à jour :

npm outdated -g openclaw

Désinstallation d’OpenClaw

Pour supprimer OpenClaw :

npm uninstall -g openclaw

Cela supprime l’installation globale mais conserve votre configuration et vos données. Pour tout supprimer :

rm -rf ~/.openclaw

Prochaines étapes

Maintenant qu’OpenClaw est installé :

1. Explorer les compétences – Découvrez les compétences disponibles sur /skills
2. Configurer les intégrations : connectez vos applications de chat (voir page d’intégrations)
3. Lisez la FAQ — Questions courantes répondues sur /faq
4. Rejoignez la communauté — Discord, discussions GitHub et plus encore

ConclusionL’installation d’OpenClaw est rapide et simple. Le programme d’installation en une seule ligne gère l’essentiel de la complexité, le rendant accessible aux utilisateurs de tous niveaux techniques. Une fois installée, la commande openclaw onboard vous guide dans la configuration.

Pour obtenir des conseils spécifiques à la plate-forme et des options de configuration avancées, consultez nos guides détaillés :

• Configuration macOS
• Installation de Windows
• Configuration Linux

Prêt à commencer à utiliser votre assistant personnel IA ? Exécutez openclaw onboard et commencez le processus de configuration !