Installer OpenClaw avec Docker : Tutoriel Pas-a-Pas

Installer OpenClaw avec Docker : de zéro à un agent opérationnel

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.

Prérequis détaillés

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

Matériel minimum :

• 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)

Logiciels requis :

• 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)

Optionnel mais recommandé :

• 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 :

• Dans l'interface d'administration, cliquez sur Connecteurs → WhatsApp
• Un QR code s'affiche à l'écran
• Sur votre téléphone, ouvrez WhatsApp → Paramètres → Appareils liés → Lier un appareil
• Scannez le QR code
• 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

Problème : WhatsApp se déconnecte régulièrement

• 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

Problème : Réponses lentes de l'agent

• 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

Conclusion

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.