Ansible

Déployez OpenClaw sur des serveurs de production avec openclaw-ansible, un programme d’installation automatisé doté d’une architecture privilégiant la sécurité.

Le dépôt openclaw-ansible constitue la source de référence pour le déploiement Ansible. Cette page en donne un aperçu rapide.

Prérequis

Exigence	Détails
Système d’exploitation	Debian 11+ ou Ubuntu 20.04+
Accès	Privilèges root ou sudo
Réseau	Connexion Internet pour l’installation des paquets
Ansible	2.14+ (installé automatiquement par le script de démarrage rapide)

Ce que vous obtenez

Sécurité privilégiant le pare-feu : UFW + isolation Docker (seuls SSH + Tailscale sont accessibles)
VPN Tailscale pour l’accès à distance sans exposer publiquement les services
Docker pour des conteneurs sandbox isolés avec des liaisons limitées à localhost
Intégration à systemd avec renforcement de la sécurité et démarrage automatique au démarrage du système
Configuration en une seule commande

Démarrage rapide

curl -fsSL https://raw.githubusercontent.com/openclaw/openclaw-ansible/main/install.sh | bash

Éléments installés

Tailscale (VPN maillé pour un accès à distance sécurisé)
Pare-feu UFW (ports SSH + Tailscale uniquement)
Docker CE + Compose V2 (backend sandbox par défaut des agents)
Node.js et pnpm (OpenClaw nécessite Node 22.22.3+, 24.15+ ou 25.9+ ; Node 24 est recommandé)
OpenClaw, installé directement sur l’hôte et non conteneurisé
Un service systemd avec renforcement de la sécurité

Le Gateway s’exécute directement sur l’hôte, et non dans Docker. La mise en sandbox des agents est facultative ; ce playbook installe Docker, car il s’agit du backend sandbox par défaut. Consultez Mise en sandbox pour découvrir les autres backends.

Configuration après l’installation

Passer à l’utilisateur openclaw

sudo -i -u openclaw

Exécuter l’assistant d’intégration

Le script de post-installation vous guide dans la configuration d’OpenClaw.

Connecter les canaux de messagerie

Connectez-vous à WhatsApp, Telegram, Discord ou Signal :

openclaw channels login --channel <name>

Vérifier l’installation

sudo systemctl status openclaw
sudo journalctl -u openclaw -f

Se connecter à Tailscale

Rejoignez votre maillage VPN pour bénéficier d’un accès à distance sécurisé.

Commandes rapides

# Vérifier l’état du service
sudo systemctl status openclaw

# Afficher les journaux en direct
sudo journalctl -u openclaw -f

# Redémarrer le Gateway
sudo systemctl restart openclaw

# Connexion à un canal (à exécuter en tant qu’utilisateur openclaw)
sudo -i -u openclaw
openclaw channels login --channel <name>

Architecture de sécurité

Modèle de défense à quatre couches :

Pare-feu (UFW) : seuls SSH (22) et Tailscale (41641/udp) sont exposés publiquement
VPN (Tailscale) : le Gateway est accessible uniquement via le maillage VPN
Isolation Docker : la chaîne iptables DOCKER-USER empêche l’exposition externe des ports
Renforcement de systemd : NoNewPrivileges, PrivateTmp, utilisateur non privilégié

Vérifiez votre surface d’attaque externe :

nmap -p- YOUR_SERVER_IP

Seul le port 22 (SSH) doit être ouvert. Le Gateway et Docker restent verrouillés. Docker est installé pour les sandbox d’agents (exécution isolée des outils), et non pour exécuter le Gateway. Consultez Sandbox multi-agent et outils pour configurer la sandbox.

Installation manuelle

Installer les prérequis

sudo apt update && sudo apt install -y ansible git

Cloner le dépôt

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

Installer les collections Ansible

ansible-galaxy collection install -r requirements.yml

Exécuter le playbook

./run-playbook.sh

Vous pouvez également exécuter directement le playbook, puis lancer manuellement le script de configuration :

ansible-playbook playbook.yml --ask-become-pass
# Exécutez ensuite : /tmp/openclaw-setup.sh

Mise à jour

Le programme d’installation Ansible configure OpenClaw pour les mises à jour manuelles ; consultez Mise à jour pour connaître la procédure standard. Pour réexécuter le playbook (par exemple, après des modifications de configuration) :

cd openclaw-ansible
./run-playbook.sh

Cette opération est idempotente et peut être exécutée plusieurs fois en toute sécurité.

Dépannage

Le pare-feu bloque ma connexion

Connectez-vous d’abord via le VPN Tailscale ; par conception, le Gateway n’est accessible que de cette manière.
SSH (port 22) est toujours autorisé.

Le service ne démarre pas

# Vérifier les journaux
sudo journalctl -u openclaw -n 100

# Vérifier les autorisations
sudo ls -la /opt/openclaw

# Tester le démarrage manuel
sudo -i -u openclaw
cd ~/openclaw
openclaw gateway run

Problèmes liés à la sandbox Docker

# Vérifier que Docker est en cours d’exécution
sudo systemctl status docker

# Vérifier l’image de la sandbox
sudo docker images | grep openclaw-sandbox

# Construire l’image de la sandbox si elle est absente (nécessite un checkout des sources)
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh
# Pour les installations npm sans checkout des sources, consultez
# https://docs.openclaw.ai/gateway/sandboxing#images-and-setup

Échec de la connexion au canal

Vérifiez que vous exécutez les commandes en tant qu’utilisateur openclaw :

sudo -i -u openclaw
openclaw channels login --channel <name>

Configuration avancée

Pour obtenir des informations détaillées sur l’architecture de sécurité et le dépannage, consultez le dépôt openclaw-ansible :

Ressources associées

openclaw-ansible : guide de déploiement complet
Docker : configuration d’un Gateway conteneurisé
Mise en sandbox : configuration de la sandbox des agents
Sandbox multi-agent et outils : isolation par agent

Install overview

Maintenance

Containers

Hosting

Advanced setup

Prérequis

Ce que vous obtenez

Démarrage rapide

Éléments installés

Configuration après l’installation

Commandes rapides

Architecture de sécurité

Installation manuelle

Mise à jour

Dépannage

Configuration avancée

Ressources associées

​Prérequis

​Ce que vous obtenez

​Démarrage rapide

​Éléments installés

​Configuration après l’installation

​Commandes rapides

​Architecture de sécurité

​Installation manuelle

​Mise à jour

​Dépannage

​Configuration avancée

​Ressources associées

Prérequis

Ce que vous obtenez

Démarrage rapide

Éléments installés

Configuration après l’installation

Commandes rapides

Architecture de sécurité

Installation manuelle

Mise à jour

Dépannage

Configuration avancée

Ressources associées