Comment installer OpenClaw en 2026

Avant d'installer OpenClaw, assurez-vous que votre serveur respecte les exigences minimales. En dessous de ces spécifications, attendez-vous à des réponses lentes, des processus crashés et des utilisateurs frustrés.

Vous aurez aussi besoin de

• Accès SSH à votre serveur. Si vous pouvez exécuter ssh root@votre-ip-serveur, c'est bon.
• Une clé API de modèle IA d'Anthropic, OpenAI, Google, ou un modèle local via Ollama. Procurez-vous-en une avant de commencer.
• Un nom de domaine (optionnel). Pas obligatoire, mais recommandé pour le SSL et des URLs de webhook propres.

Le moyen le plus rapide d'installer OpenClaw. Une seule commande gère tout : vérification des dépendances, téléchargement, assistant de configuration et mise en service. Fonctionne sur Ubuntu, Debian, CentOS, Fedora, Arch et macOS.

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

Ce que l'installateur fait

Sortie attendue

[info] Detecting OS... Ubuntu 22.04 (x86_64)
[info] Node.js v20.18.1 found
[info] Installing pnpm...
[info] Downloading OpenClaw v2026.3.8...
[info] Running configuration wizard...
   → AI Provider: anthropic
   → Model: claude-sonnet-4-5
   → Port: 3100
[ok]   OpenClaw is running at http://localhost:3100
       Dashboard: http://localhost:3100/dashboard

Flags personnalisés

Passez des flags pour personnaliser l'installation sans l'assistant interactif.

# Skip the wizard with pre-set values
curl -fsSL https://openclaw.sh | bash -s -- \
  --provider anthropic \
  --model claude-sonnet-4-5 \
  --port 3100 \
  --no-systemd

Idéal pour les développeurs qui veulent un contrôle total du processus. Cette méthode offre une visibilité explicite sur chaque étape.

Étape 1 — Installer Node.js 20+

OpenClaw requiert Node.js 20 ou supérieur. Vérifiez votre version d'abord.

node --version
# If below v20, install via nvm:
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 20
nvm use 20

Étape 2 — Installer pnpm

npm install -g pnpm

Étape 3 — Installer OpenClaw globalement

pnpm install -g openclaw
# Or with npm:
npm install -g openclaw

Étape 4 — Initialiser la configuration

La commande init crée un fichier .env et un répertoire data/ dans votre dossier actuel.

mkdir ~/openclaw && cd ~/openclaw
openclaw init

Étape 5 — Éditer votre fichier .env

# ~/openclaw/.env
OPENCLAW_PORT=3100
AI_PROVIDER=anthropic
AI_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx
# Or for OpenAI:
# AI_PROVIDER=openai
# AI_MODEL=gpt-5
# OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx

Étape 6 — Démarrer OpenClaw

openclaw start
# Or run in background:
openclaw start --daemon

Docker isole OpenClaw de votre système hôte. Les mises à jour sont simples : tirez la nouvelle image et redémarrez. Cette méthode est idéale pour les serveurs de production et les équipes.

Étape 1 — Installer Docker

# Ubuntu / Debian
curl -fsSL https://get.docker.com | sh
sudo usermod -aG docker $USER
# Log out and back in for group changes to take effect

Étape 2 — Créer docker-compose.yml

version: "3.8"

services:
  openclaw:
    image: openclaw/openclaw:latest
    container_name: openclaw
    restart: unless-stopped
    ports:
      - "3100:3100"
    volumes:
      - ./data:/app/data        # Persistent memory & databases
      - ./config:/app/config    # Configuration files
      - ./.env:/app/.env        # Environment variables
    environment:
      - NODE_ENV=production
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:3100/health"]
      interval: 30s
      timeout: 10s
      retries: 3

Étape 3 — Créer votre fichier .env

OPENCLAW_PORT=3100
AI_PROVIDER=anthropic
AI_MODEL=claude-sonnet-4-5
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

# Optional: Enable persistent memory
MEMORY_ENABLED=true
MEMORY_PROVIDER=sqlite

# Optional: WhatsApp channel
WHATSAPP_ENABLED=false
WHATSAPP_PHONE_ID=
WHATSAPP_TOKEN=

Étape 4 — Démarrer le conteneur

docker compose up -d

# Check the logs
docker compose logs -f openclaw

Mise à jour avec Docker

docker compose pull
docker compose up -d

Compilez depuis les sources si vous souhaitez modifier le comportement de base, contribuer au projet, ou exécuter une branche pré-release. Ce chemin nécessite une expérience en développement.

Étape 1 — Cloner le dépôt

git clone https://github.com/openclaw/openclaw.git
cd openclaw

Étape 2 — Installer les dépendances

# Requires Node.js 20+ and pnpm
pnpm install

Étape 3 — Copier et éditer le fichier d'environnement

cp .env.example .env
nano .env
# Set your AI_PROVIDER, API keys, and port

Étape 4 — Compiler et démarrer

pnpm build
pnpm start

# For development with hot reload:
pnpm dev

Mise à jour depuis les sources

git pull origin main
pnpm install
pnpm build
# Restart your OpenClaw process or service

OpenClaw tourne. Maintenant, configurez votre modèle IA, connectez un canal de messagerie et vérifiez que tout fonctionne.

Configurer votre modèle IA

OpenClaw supporte plusieurs fournisseurs d'IA. Définissez votre modèle préféré dans le fichier .env ou via le tableau de bord.

# Example: Switch to Claude Opus 4.6
AI_PROVIDER=anthropic
AI_MODEL=claude-opus-4-6
ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxx

# Example: Use a local model via Ollama
AI_PROVIDER=ollama
AI_MODEL=llama4:8b
OLLAMA_HOST=http://localhost:11434

Configurer votre premier canal (exemple WhatsApp)

OpenClaw supporte 191+ intégrations. WhatsApp est le point de départ le plus populaire. Voici comment le connecter.

WHATSAPP_ENABLED=true
WHATSAPP_PHONE_ID=123456789012345
WHATSAPP_TOKEN=EAAxxxxxxxxxxxxxxxx
WHATSAPP_VERIFY_TOKEN=your-random-verify-string

openclaw restart
# Or with Docker:
docker compose restart openclaw

Envoyer votre premier message

Ouvrez WhatsApp et envoyez « Bonjour » à votre numéro connecté. Vous devriez recevoir une réponse en 2 à 5 secondes. Si WhatsApp n'est pas configuré, testez via le tableau de bord.

# Quick test via CLI
curl -X POST http://localhost:3100/api/chat \
  -H "Content-Type: application/json" \
  -d '{"message": "Hello, what can you do?"}'

Une réponse réussie retourne du JSON avec la réponse de l'IA. En cas d'erreur, consultez la section dépannage ci-dessous.

La plupart des problèmes d'installation entrent dans cinq catégories. Voici comment les résoudre.

# Find what is using port 3100
sudo lsof -i :3100

# Option A: Kill the process
sudo kill -9 <PID>

# Option B: Change OpenClaw's port
# In .env, set:
OPENCLAW_PORT=3200

# Check your current version
node --version

# If below v20, upgrade with nvm:
nvm install 20
nvm alias default 20
nvm use 20

# Verify
node --version  # Should show v20.x.x or higher

# Add your user to the docker group
sudo usermod -aG docker $USER

# Log out and back in, then verify:
docker ps
# If you still get errors, restart the Docker service:
sudo systemctl restart docker

# Install Certbot and get a free Let's Encrypt certificate
sudo apt install certbot python3-certbot-nginx -y
sudo certbot --nginx -d your-domain.com

# Auto-renewal is configured automatically
# Test renewal:
sudo certbot renew --dry-run

# Check available memory
free -h

# Option A: Add swap space (quick fix)
sudo fallocate -l 2G /swapfile
sudo chmod 600 /swapfile
sudo mkswap /swapfile
sudo swapon /swapfile
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab

# Option B: Upgrade your VPS to 4+ GB RAM

# Option C: Use a lighter AI model
# In .env, switch from Opus to Haiku:
AI_MODEL=claude-haiku-4-5

Une instance OpenClaw sans sécurité est un risque. Les recherches montrent que 93,4 % des instances publiques n'ont pas d'authentification de base, et 42 665 sont exposées sur Internet. Ne devenez pas une statistique.

# Quick firewall setup (Ubuntu/Debian)
sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow 22/tcp    # SSH
sudo ufw allow 80/tcp    # HTTP
sudo ufw allow 443/tcp   # HTTPS
sudo ufw enable

# Verify
sudo ufw status