Installer OpenClaw avec Docker : Tutoriel Pas-à-Pas

Comment installer OpenClaw avec Docker ?

Ce tutoriel vous guide pas à pas dans l'installation complète d'OpenClaw avec Docker. Que vous soyez sur un VPS OVH, une instance AWS, un serveur Hetzner ou même un Mac mini dans votre bureau, vous aurez un agent IA opérationnel en moins de 30 minutes.

Ce guide est rédigé pour les professionnels francophones — développeurs, administrateurs système, responsables IT — qui souhaitent déployer OpenClaw de manière fiable et sécurisée.

Quels sont les prérequis pour installer OpenClaw ?

Avant de commencer, vérifiez que votre environnement répond aux exigences suivantes :

• RAM : 2 Go minimum (4 Go recommandés pour une utilisation confortable)
• CPU : 2 vCPU minimum
• Stockage : 20 Go d'espace disque disponible
• Réseau : Connexion internet stable (nécessaire pour les appels API aux modèles LLM cloud)

• Docker version 24 ou supérieure
• Docker Compose version 2.x (inclus dans Docker Desktop sur Mac/Windows)
• Git pour cloner le dépôt
• Un éditeur de texte (nano, vim, ou VS Code via SSH)

• Un nom de domaine pointant vers votre serveur (pour l'accès HTTPS)
• Un certificat SSL (Let's Encrypt via Certbot ou Caddy)
• Une clé API pour votre modèle LLM préféré (OpenAI, Anthropic, Mistral, etc.)

Vérification de l'environnement

Commençons par vérifier que Docker est correctement installé :

# Vérifier la version de Docker
docker --version
# Attendu : Docker version 24.x.x ou supérieur

# Vérifier que Docker Compose est disponible
docker compose version
# Attendu : Docker Compose version v2.x.x

# Vérifier que Docker fonctionne correctement
docker run --rm hello-world
# Devrait afficher "Hello from Docker!"

Si Docker n'est pas installé, voici les commandes pour les distributions Linux les plus courantes :

# Ubuntu / Debian
sudo apt update
sudo apt install -y docker.io docker-compose-plugin
sudo systemctl enable --now docker
sudo usermod -aG docker $USER
# Déconnectez-vous et reconnectez-vous pour que le groupe prenne effet

# CentOS / Rocky Linux / AlmaLinux
sudo dnf install -y docker docker-compose-plugin
sudo systemctl enable --now docker
sudo usermod -aG docker $USER

Pour macOS, installez Docker Desktop depuis le site officiel de Docker.

Étape 1 : Cloner le dépôt OpenClaw

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

# Se placer dans le répertoire du projet
cd openclaw

# Vérifier la branche stable
git checkout main
git log --oneline -5

Si vous êtes derrière un pare-feu d'entreprise qui bloque Git via SSH, utilisez la variante HTTPS :

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

Étape 2 : Configuration du fichier .env

Le fichier .env est le cœur de la configuration d'OpenClaw. Créez-le à partir du modèle fourni :

cp .env.example .env

Ouvrez le fichier avec votre éditeur préféré et configurez les paramètres suivants :

# ============================================
# CONFIGURATION GÉNÉRALE
# ============================================
# Nom de votre agent (affiché dans les conversations)
BOT_NAME=MonAssistant

# Langue par défaut
LANGUAGE=fr

# Fuseau horaire (important pour les tâches planifiées)
TIMEZONE=Europe/Paris
# Autres options : Europe/Brussels, Europe/Zurich, America/Montreal

# Port d'écoute de l'interface web d'administration
PORT=3000

# ============================================
# MODÈLE LLM
# ============================================
# Choisissez votre fournisseur : openai, anthropic, mistral, ollama
LLM_PROVIDER=openai

# Clé API (selon le fournisseur choisi)
OPENAI_API_KEY=sk-votre-clé-api-openai
# ANTHROPIC_API_KEY=sk-ant-votre-clé-anthropic
# MISTRAL_API_KEY=votre-clé-mistral

# Modèle à utiliser
DEFAULT_MODEL=gpt-4o

# ============================================
# BASE DE DONNÉES
# ============================================
# SQLite par défaut (suffisant pour la plupart des usages)
DATABASE_URL=sqlite:///data/openclaw.db

# Pour PostgreSQL (recommandé en production) :
# DATABASE_URL=postgresql://user:password@localhost:5432/openclaw

# ============================================
# SÉCURITÉ
# ============================================
# Mot de passe de l'interface d'administration
ADMIN_PASSWORD=votre-mot-de-passe-tres-securise

# Clé secrète pour les sessions (générez-en une unique)
SECRET_KEY=une-chaine-aleatoire-de-32-caracteres-minimum

# ============================================
# CONNECTEURS (activez ceux dont vous avez besoin)
# ============================================
ENABLE_WHATSAPP=true
ENABLE_SLACK=false
ENABLE_DISCORD=false
ENABLE_TELEGRAM=false

Conseil de sécurité : Ne commitez jamais votre fichier .env dans un dépôt Git. Vérifiez qu'il est bien listé dans votre .gitignore.

Étape 3 : Lancement avec Docker Compose

Le fichier docker-compose.yml fourni configure tous les services nécessaires. Lancez l'ensemble avec :

# Construire et démarrer les conteneurs en arrière-plan
docker compose up -d

# Suivre les logs en temps réel pendant le démarrage
docker compose logs -f

Le premier démarrage peut prendre 2-3 minutes le temps de télécharger les images Docker et d'initialiser la base de données.

# Vérifier que tous les conteneurs sont en cours d'exécution
docker compose ps

# Résultat attendu :
# NAME          STATUS          PORTS
# molty         Up 2 minutes    0.0.0.0:3000->3000/tcp

Étape 4 : Accéder à l'interface d'administration

Ouvrez votre navigateur et accédez à :

http://votre-ip-serveur:3000

Si vous êtes en local : http://localhost:3000

Connectez-vous avec le mot de passe défini dans ADMIN_PASSWORD. L'interface d'administration vous permet de :

• Visualiser l'état des connecteurs actifs
• Consulter l'historique des conversations
• Modifier le system prompt de l'agent
• Gérer les documents indexés (RAG)
• Configurer les tâches planifiées
• Surveiller les performances et les coûts d'API

Étape 5 : Connecter WhatsApp

La connexion WhatsApp est l'une des fonctionnalités les plus populaires d'OpenClaw. Pour un guide complet sur l'intégration WhatsApp Business, consultez notre article dédié.

Voici les étapes rapides :

1. Dans l'interface d'administration, cliquez sur Connecteurs → WhatsApp
2. Un QR code s'affiche à l'écran
3. Sur votre téléphone, ouvrez WhatsApp → Paramètres → Appareils liés → Lier un appareil
4. Scannez le QR code
5. Attendez quelques secondes — le statut passe à « Connecté »

# Vérifier la connexion dans les logs
docker compose logs molty | grep -i whatsapp
# Attendu : "WhatsApp connector initialized successfully"

Étape 6 : Configurer le modèle IA

OpenClaw supporte plusieurs backends LLM. Voici comment configurer les plus courants :

Option A : OpenAI (GPT-4o)

LLM_PROVIDER=openai
OPENAI_API_KEY=sk-votre-clé
DEFAULT_MODEL=gpt-4o

Option B : Anthropic (Claude)

LLM_PROVIDER=anthropic
ANTHROPIC_API_KEY=sk-ant-votre-clé
DEFAULT_MODEL=claude-sonnet-4-20250514

Option C : Modèle local avec Ollama (aucune API externe requise)

# D'abord, installer Ollama sur le serveur
curl -fsSL https://ollama.ai/install.sh | bash

# Télécharger un modèle (ex: Llama 3.1 8B)
ollama pull llama3.1:8b

# Configurer OpenClaw pour utiliser Ollama
LLM_PROVIDER=ollama
OLLAMA_BASE_URL=http://host.docker.internal:11434
DEFAULT_MODEL=llama3.1:8b

Option D : Mistral AI (modèle français)

LLM_PROVIDER=mistral
MISTRAL_API_KEY=votre-clé
DEFAULT_MODEL=mistral-large-latest

Après modification du .env, redémarrez OpenClaw :

docker compose restart

Étape 7 : Personnaliser le system prompt

Le system prompt détermine la personnalité et le comportement de votre agent. Accédez à l'interface d'administration → Configuration → System Prompt.

Exemple de system prompt professionnel en français :

Tu es l'assistant virtuel de [Nom de l'entreprise], une entreprise spécialisée dans [domaine].

Règles de comportement :
- Réponds toujours en français, de manière professionnelle mais chaleureuse
- Utilise le vouvoiement sauf si l'interlocuteur te tutoie en premier
- Ne jamais inventer d'informations : si tu ne sais pas, dis-le clairement
- Pour les questions techniques, consulte d'abord la base de connaissances
- En cas de réclamation, propose de transférer vers un conseiller humain

Informations clés :
- Horaires d'ouverture : lundi-vendredi 9h-18h
- Téléphone : +33 1 XX XX XX XX
- Email : contact@entreprise.fr

Résolution des problèmes courants

Problème : Le conteneur ne démarre pas

# Consulter les logs détaillés
docker compose logs --tail 100

# Vérifier les ressources disponibles
docker system df
free -h

Problème : Erreur de connexion à l'API LLM

# Tester la connectivité depuis le conteneur
docker exec molty curl -s https://api.openai.com/v1/models   -H "Authorization: Bearer $OPENAI_API_KEY" | head -20

• Assurez-vous que votre téléphone reste connecté à Internet
• Vérifiez que la session WhatsApp n'est pas expirée (rescannez le QR code)
• Augmentez le timeout dans la configuration : WHATSAPP_TIMEOUT=60000

• Vérifiez la latence vers l'API LLM : docker exec molty ping api.openai.com
• Considérez un modèle plus léger pour les questions simples
• Augmentez les ressources du conteneur dans docker-compose.yml

Problème : Erreur de mémoire (OOM Kill)

# Vérifier la consommation mémoire
docker stats molty

# Augmenter la limite dans docker-compose.yml
# deploy:
#   resources:
#     limits:
#       memory: 4G

Configuration avancée : HTTPS avec Caddy

Pour un déploiement en production, configurez HTTPS avec un reverse proxy. Caddy est la solution la plus simple :

# Caddyfile
votre-domaine.fr {
    reverse_proxy localhost:3000
}

# Installer et démarrer Caddy
sudo apt install -y caddy
sudo systemctl enable --now caddy

Caddy obtient automatiquement un certificat SSL Let's Encrypt.

Configuration avancée : sauvegarde automatique

Protégez vos données avec une sauvegarde quotidienne :

#!/bin/bash
# Script de sauvegarde — /opt/openclaw/backup.sh
DATE=$(date +%Y%m%d_%H%M%S)
BACKUP_DIR=/opt/openclaw/backups

mkdir -p $BACKUP_DIR

# Sauvegarder la base de données et la configuration
docker compose exec -T molty tar czf - /data > "$BACKUP_DIR/openclaw_$DATE.tar.gz"

# Garder uniquement les 7 dernières sauvegardes
ls -t "$BACKUP_DIR"/openclaw_*.tar.gz | tail -n +8 | xargs rm -f

echo "Sauvegarde terminée : openclaw_$DATE.tar.gz"

# Ajouter au crontab pour une sauvegarde quotidienne à 3h du matin
echo "0 3 * * * /opt/openclaw/backup.sh" | crontab -

Mise à jour d'OpenClaw

Pour mettre à jour vers la dernière version :

# Arrêter les conteneurs
docker compose down

# Récupérer les dernières modifications
git pull origin main

# Reconstruire et redémarrer
docker compose up -d --build

# Vérifier que tout fonctionne
docker compose logs -f --tail 50

Pourquoi Docker est-il le meilleur choix pour OpenClaw ?

Vous disposez maintenant d'un agent IA personnel entièrement fonctionnel, auto-hébergé et connecté à vos messageries. En moins de 30 minutes, vous avez installé, configuré et sécurisé OpenClaw avec Docker.

Pour aller plus loin, explorez les agents autonomes et workflows avancés ou découvrez comment connecter OpenClaw à WhatsApp Business pour automatiser votre support client.

Si vous débutez avec OpenClaw, notre guide pour débutants vous aidera à comprendre les concepts fondamentaux et à tirer le meilleur parti de votre nouvel assistant IA.