Pour OpenClaw v2026.2 | Cet article suppose que vous disposez de Node.js >= 22 et d’une API Key IA (Anthropic Claude recommandé).

TL;DR : Installation d’OpenClaw en 5 minutes. Prend en charge npm/pnpm/bun/Docker — recommandé : npm install -g openclaw@latest && openclaw onboard. Le fichier de configuration se trouve dans ~/.openclaw/openclaw.json, démarrage via openclaw gateway. Couvre en détail le déploiement Docker, la structure des fichiers de configuration et le dépannage des problèmes courants.

Prérequis

Environnement requis

Environnement recommandé

API Key IA

OpenClaw nécessite une connexion à un modèle IA pour fonctionner. Recommandations :

💡 Recommandation : Anthropic Claude Opus 4.6 offre les meilleures capacités de traitement de contexte long et de protection contre l’injection de prompts.

Vérification de l’environnement

# Vérifier la version de Node.js
node --version
# Exemple de sortie : v22.12.0

# Vérifier la version de npm
npm --version
# Exemple de sortie : 10.9.0

# Vérifier les informations système
uname -a  # Linux/macOS
# ou
systeminfo | findstr /B /C:"OS Name" /C:"OS Version"  # Windows

Comparaison des méthodes d’installation

flowchart TB
    A[Choisir la méthode d'installation] --> B{Cas d'usage ?}
    B -->|Essai rapide| C[Installation globale npm]
    B -->|Usage quotidien| D[Installation pnpm/bun]
    B -->|Déploiement production| E[Déploiement Docker]
    B -->|Contribution au développement| F[Compilation depuis les sources]
    
    C --> G[Terminé en 5 min]
    D --> H[Gestion des dépendances plus rapide]
    E --> I[Isolation d'environnement reproductible]
    F --> J[Personnalisable, participer au développement]

Tableau comparatif des méthodes

Méthode 1 : Installation globale npm (recommandée pour les débutants)

Étapes d’installation

# 1. Installer la dernière version stable
npm install -g openclaw@latest

# 2. Vérifier l'installation
openclaw --version
# Exemple de sortie : 2026.2.26

# 3. Afficher l'aide
openclaw --help

Structure des répertoires après installation

/usr/local/lib/node_modules/openclaw/  # Répertoire d'installation global
├── bin/
│   └── openclaw                        # Exécutable
├── lib/
│   └── ...                             # Fichiers de la bibliothèque principale
└── package.json

~/.openclaw/                            # Répertoire des données utilisateur (créé au premier lancement)
├── openclaw.json                       # Fichier de configuration principal
├── credentials/                       # Stockage des identifiants de canaux
├── workspace/                          # Espace de travail de l'Agent
│   ├── AGENTS.md                      # Guide de comportement de l'Agent
│   ├── SOUL.md                        # Personnalité de l'Agent
│   └── skills/                        # Skills personnalisés
└── logs/                              # Répertoire des journaux

Lancer l’assistant de configuration

# Démarrer l'assistant de configuration interactif
openclaw onboard --install-daemon

L’assistant vous guidera à travers :

sequenceDiagram
    participant U as Utilisateur
    participant W as Assistant
    participant S as Système
    
    U->>W: Lancer onboard
    W->>U: Choisir le fournisseur de modèle
    U->>W: Choisir Anthropic
    W->>U: Saisir la API Key
    U->>W: Coller la clé
    W->>U: Choisir le port du Gateway
    U->>W: 18789 (par défaut)
    W->>U: Installer le daemon ?
    U->>W: Oui
    W->>S: Créer le service systemd/launchd
    S-->>W: Installation réussie
    W-->>U: Configuration terminée !

Méthode 2 : Installation pnpm (recommandée pour l’usage quotidien)

Installer pnpm

# Installer pnpm via npm
npm install -g pnpm

# Ou via le script dédié
curl -fsSL https://get.pnpm.io/install.sh | sh -

Installer OpenClaw

# Installer avec pnpm
pnpm add -g openclaw@latest

# Vérifier
openclaw --version

Avantages de pnpm

Méthode 3 : Installation bun (performance maximale)

Installer bun

# macOS/Linux
curl -fsSL https://bun.sh/install | bash

# Ou via npm
npm install -g bun

Installer OpenClaw

# Installer avec bun
bun add -g openclaw@latest

# Vérifier
openclaw --version

Avantages de bun

Méthode 4 : Déploiement Docker (recommandé pour la production)

Récupérer l’image

# Télécharger la dernière image
docker pull openclaw/openclaw:latest

# Ou spécifier une version
docker pull openclaw/openclaw:2026.2

Exécution de base

# Lancement minimal
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  -e ANTHROPIC_API_KEY=your_key_here \
  openclaw/openclaw:latest

# Consulter les journaux
docker logs -f openclaw

Configuration Docker Compose

Créez un fichier docker-compose.yml :

version: '3.8'

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "18789:18789"
    volumes:
      - ./openclaw-data:/root/.openclaw
    environment:
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      # Ou utiliser un fichier de configuration
      # - OPENCLAW_CONFIG=/root/.openclaw/openclaw.json
    healthcheck:
      test: ["CMD", "openclaw", "health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

Démarrer le service :

# Créer le fichier .env
echo "ANTHROPIC_API_KEY=your_key_here" > .env

# Démarrer
docker-compose up -d

# Vérifier le statut
docker-compose ps

# Consulter les journaux
docker-compose logs -f

Configuration réseau Docker

# Extension de la configuration docker-compose.yml
services:
  openclaw:
    # ... autres configurations
    networks:
      - openclaw-net

  # Optionnel : proxy inverse
  caddy:
    image: caddy:latest
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - ./Caddyfile:/etc/caddy/Caddyfile
    networks:
      - openclaw-net

networks:
  openclaw-net:
    driver: bridge

Méthode 5 : Compilation depuis les sources (développeurs)

Cloner le dépôt

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

# Installer les dépendances (pnpm recommandé)
pnpm install

# Compiler
pnpm build

# Lancer
pnpm openclaw onboard

Mode développement

# Mode développement (rechargement automatique)
pnpm gateway:watch

# Lancer les tests
pnpm test

# Vérification du code
pnpm lint

Détail du fichier de configuration

Priorité de configuration

Arguments CLI > Variables d'environnement > Fichier de configuration > Valeurs par défaut

Structure des répertoires

~/.openclaw/
├── openclaw.json           # Fichier de configuration principal
├── openclaw.json.backup    # Sauvegarde automatique
├── credentials/            # Identifiants sensibles (chiffrement automatique)
│   ├── telegram.json
│   ├── whatsapp.json
│   └── discord.json
├── workspace/              # Espace de travail de l'Agent
│   ├── AGENTS.md          # Guide de comportement global
│   ├── SOUL.md            # Personnalité de l'Agent
│   ├── TOOLS.md           # Description des outils personnalisés
│   ├── USER.md            # Informations utilisateur
│   └── skills/            # Répertoire des Skills
│       ├── gmail/
│       │   └── SKILL.md
│       └── calendar/
│           └── SKILL.md
├── sessions/              # Données de sessions
├── logs/                  # Fichiers journaux
│   ├── gateway.log
│   └── agent.log
└── cache/                 # Données en cache

Configuration minimale

~/.openclaw/openclaw.json :

{
  "agent": {
    "model": "anthropic/claude-opus-4-6"
  }
}

Exemple de configuration complète

{
  "agent": {
    "model": "anthropic/claude-opus-4-6",
    "thinkingLevel": "high",
    "verboseLevel": "normal"
  },
  "gateway": {
    "port": 18789,
    "bind": "loopback",
    "host": "127.0.0.1"
  },
  "channels": {
    "telegram": {
      "botToken": "YOUR_BOT_TOKEN",
      "dmPolicy": "pairing",
      "allowFrom": []
    },
    "whatsapp": {
      "allowFrom": ["+8613800138000"],
      "groups": {
        "*": { "requireMention": true }
      }
    },
    "discord": {
      "token": "YOUR_DISCORD_TOKEN",
      "guilds": {}
    }
  },
  "agents": {
    "defaults": {
      "workspace": "~/.openclaw/workspace",
      "sandbox": {
        "mode": "off"
      }
    }
  },
  "models": {
    "fallback": [
      {
        "model": "anthropic/claude-sonnet-4",
        "condition": "rate_limit"
      }
    ]
  },
  "webhooks": [],
  "cron": []
}

Description des options de configuration

Variables d’environnement

OpenClaw permet de remplacer la configuration via des variables d’environnement :

# API Keys
export ANTHROPIC_API_KEY="sk-ant-..."
export OPENAI_API_KEY="sk-..."

# Configuration des canaux
export TELEGRAM_BOT_TOKEN="123456:ABC..."
export DISCORD_BOT_TOKEN="..."

# Configuration du Gateway
export OPENCLAW_PORT=18789
export OPENCLAW_BIND="loopback"

Démarrage et vérification

Démarrer le Gateway

# Exécution au premier plan (mode débogage)
openclaw gateway --verbose

# Exécution en arrière-plan (daemon)
openclaw gateway --daemon

# Spécifier un port
openclaw gateway --port 18790

Vérifier l’état de fonctionnement

# Vérifier l'état de santé
openclaw doctor

# Exemple de sortie :
# ✓ Node.js version: v22.12.0
# ✓ OpenClaw version: 2026.2.26
# ✓ Gateway running on port 18789
# ✓ API key configured
# ✓ Workspace directory exists

Accéder à la console Web

Après le démarrage du Gateway, ouvrez votre navigateur à l’adresse :

http://127.0.0.1:18789

Vous verrez l’interface de contrôle Web :

Tester une conversation

# Test en ligne de commande
openclaw agent --message "Bonjour, présente-toi"

# Exemple de sortie :
# Bonjour ! Je suis votre assistant OpenClaw. Je peux vous aider à...

Dépannage des problèmes courants

Problème 1 : Port déjà utilisé

Symptôme :

Error: EADDRINUSE: address already in use 127.0.0.1:18789

Solution :

# Identifier le processus utilisant le port
lsof -i :18789
# ou
netstat -tlnp | grep 18789

# Terminer le processus
kill -9 <PID>

# Ou utiliser un autre port
openclaw gateway --port 18790

Problème 2 : API Key invalide

Symptôme :

Error: Invalid API key

Solution :

# Vérifier la configuration
openclaw config get agent.model

# Vérifier la variable d'environnement
echo $ANTHROPIC_API_KEY

# Reconfigurer
openclaw onboard

Problème 3 : Version de Node trop ancienne

Symptôme :

Error: OpenClaw requires Node.js >= 22.0.0

Solution :

# Changer de version avec nvm
nvm install 22
nvm use 22
nvm alias default 22

# Vérifier
node --version

Problème 4 : Problème de permissions

Symptôme :

Error: EACCES: permission denied

Solution :

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

# Ou utiliser nvm pour gérer Node.js (recommandé)

Problème 5 : Problème réseau Docker

Symptôme :

Error: Cannot connect to Gateway from container

Solution :

# Vérifier le réseau
docker network ls
docker network inspect bridge

# Utiliser le réseau host
docker run --network host ...

# Ou mapper correctement les ports
docker run -p 127.0.0.1:18789:18789 ...

Problème 6 : Identifiants perdus

Symptôme :

Warning: Telegram credentials not found

Solution :

# Se reconnecter au canal
openclaw channels login telegram

# Vérifier les fichiers d'identifiants
ls ~/.openclaw/credentials/

# Sauvegarder les identifiants
cp -r ~/.openclaw/credentials/ ~/.openclaw/credentials.backup/

Problème 7 : Mémoire insuffisante

Symptôme :

Error: JavaScript heap out of memory

Solution :

# Augmenter la limite mémoire de Node.js
export NODE_OPTIONS="--max-old-space-size=8192"
openclaw gateway

# Ou dans Docker
docker run -e NODE_OPTIONS="--max-old-space-size=8192" ...

Mise à jour et maintenance

Mettre à jour OpenClaw

# Mise à jour npm
npm update -g openclaw@latest

# Mise à jour pnpm
pnpm update -g openclaw@latest

# Mise à jour Docker
docker pull openclaw/openclaw:latest
docker-compose up -d

# Vérifier la version
openclaw --version

Changer de canal de publication

# Version stable (recommandée)
openclaw update --channel stable

# Version bêta
openclaw update --channel beta

# Version de développement (dernières fonctionnalités, potentiellement instable)
openclaw update --channel dev

Sauvegarde et restauration

# Sauvegarder la configuration
tar -czvf openclaw-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/

# Restaurer la configuration
tar -xzvf openclaw-backup-20260226.tar.gz -C ~/

# Sauvegarder uniquement les fichiers essentiels
cp ~/.openclaw/openclaw.json ~/.openclaw/openclaw.json.backup
cp -r ~/.openclaw/credentials/ ~/.openclaw/credentials.backup/

Étapes suivantes

Félicitations ! Vous avez mis en place votre environnement OpenClaw avec succès. La suite :

1. Configurer le premier canal → Article suivant : Configuration des canaux
2. Installer le premier Skill → Rechercher et installer depuis l’interface Web
3. Personnaliser le personnage de l’Agent → Modifier ~/.openclaw/workspace/SOUL.md

Résumé de cet article :

• Maîtrise des 5 méthodes d’installation et de leurs cas d’usage
• Compréhension de la structure des fichiers de configuration et de leur priorité
• Apprentissage du démarrage, de la vérification et du dépannage des problèmes courants
• Connaissance des opérations de base de mise à jour et de maintenance

Historique des mises à jour :

• 2026-02-26 : Publication initiale, basée sur OpenClaw v2026.2

Navigation de la série :

• ← Précédent : Introduction à OpenClaw
• → Suivant : Configuration des canaux : commencer par Telegram