Ansible

Distribuisci OpenClaw sui server di produzione con openclaw-ansible, un programma di installazione automatizzato con un’architettura che mette la sicurezza al primo posto.

Il repository openclaw-ansible è la fonte autorevole per la distribuzione con Ansible. Questa pagina ne offre una rapida panoramica.

Prerequisiti

Requisito	Dettagli
Sistema operativo	Debian 11+ o Ubuntu 20.04+
Accesso	Privilegi root o sudo
Rete	Connessione Internet per l’installazione dei pacchetti
Ansible	2.14+ (installato automaticamente dallo script di avvio rapido)

Funzionalità incluse

Sicurezza incentrata sul firewall: UFW + isolamento Docker (sono raggiungibili solo SSH + Tailscale)
VPN Tailscale per l’accesso remoto senza esporre pubblicamente i servizi
Docker per container sandbox isolati con binding solo su localhost
Integrazione con systemd con protezioni avanzate e avvio automatico all’accensione
Configurazione con un solo comando

Avvio rapido

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

Componenti installati

Tailscale (VPN mesh per l’accesso remoto sicuro)
Firewall UFW (solo porte SSH + Tailscale)
Docker CE + Compose V2 (backend sandbox predefinito per gli agenti)
Node.js e pnpm (OpenClaw richiede Node 22.22.3+, 24.15+ o 25.9+; è consigliato Node 24)
OpenClaw, installato direttamente sull’host, non in un container
Un servizio systemd con protezioni di sicurezza avanzate

Il Gateway viene eseguito direttamente sull’host, non in Docker. L’uso della sandbox per gli agenti è facoltativo; questo playbook installa Docker perché è il backend sandbox predefinito. Per altri backend, consultare Uso della sandbox.

Configurazione successiva all’installazione

Passare all'utente openclaw

sudo -i -u openclaw

Eseguire la procedura guidata di onboarding

Lo script successivo all’installazione guida nella configurazione di OpenClaw.

Connettere i canali di messaggistica

Accedere a WhatsApp, Telegram, Discord o Signal:

openclaw channels login --channel <name>

Verificare l'installazione

sudo systemctl status openclaw
sudo journalctl -u openclaw -f

Connettersi a Tailscale

Entrare nella mesh VPN per un accesso remoto sicuro.

Comandi rapidi

# Controlla lo stato del servizio
sudo systemctl status openclaw

# Visualizza i log in tempo reale
sudo journalctl -u openclaw -f

# Riavvia il Gateway
sudo systemctl restart openclaw

# Accesso al canale (eseguire come utente openclaw)
sudo -i -u openclaw
openclaw channels login --channel <name>

Architettura di sicurezza

Modello di difesa a quattro livelli:

Firewall (UFW): solo SSH (22) e Tailscale (41641/udp) sono esposti pubblicamente
VPN (Tailscale): il Gateway è raggiungibile solo tramite la mesh VPN
Isolamento Docker: la catena iptables DOCKER-USER impedisce l’esposizione esterna delle porte
Protezione avanzata di systemd: NoNewPrivileges, PrivateTmp, utente senza privilegi

Verificare la superficie di attacco esterna:

nmap -p- YOUR_SERVER_IP

Dovrebbe essere aperta solo la porta 22 (SSH). Il Gateway e Docker rimangono protetti. Docker viene installato per le sandbox degli agenti (esecuzione isolata degli strumenti), non per eseguire il Gateway. Per la configurazione della sandbox, consultare Sandbox e strumenti multi-agente.

Installazione manuale

Installare i prerequisiti

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

Clonare il repository

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

Installare le raccolte Ansible

ansible-galaxy collection install -r requirements.yml

Eseguire il playbook

./run-playbook.sh

In alternativa, eseguire direttamente il playbook e poi eseguire manualmente lo script di configurazione:

ansible-playbook playbook.yml --ask-become-pass
# Quindi esegui: /tmp/openclaw-setup.sh

Aggiornamento

Il programma di installazione Ansible configura OpenClaw per gli aggiornamenti manuali; per la procedura standard, consultare Aggiornamento. Per eseguire nuovamente il playbook (ad esempio, dopo modifiche alla configurazione):

cd openclaw-ansible
./run-playbook.sh

L’operazione è idempotente e può essere eseguita più volte in sicurezza.

Risoluzione dei problemi

Il firewall blocca la connessione

Connettersi prima tramite la VPN Tailscale; per progettazione, il Gateway è raggiungibile solo in questo modo.
SSH (porta 22) è sempre consentito.

Il servizio non si avvia

# Controlla i log
sudo journalctl -u openclaw -n 100

# Verifica le autorizzazioni
sudo ls -la /opt/openclaw

# Verifica l'avvio manuale
sudo -i -u openclaw
cd ~/openclaw
openclaw gateway run

Problemi con la sandbox Docker

# Verifica che Docker sia in esecuzione
sudo systemctl status docker

# Controlla l'immagine della sandbox
sudo docker images | grep openclaw-sandbox

# Crea l'immagine della sandbox se manca (richiede un checkout del codice sorgente)
cd /opt/openclaw/openclaw
sudo -u openclaw ./scripts/sandbox-setup.sh
# Per le installazioni npm senza un checkout del codice sorgente, consulta
# https://docs.openclaw.ai/gateway/sandboxing#images-and-setup

L'accesso al canale non riesce

Assicurarsi di eseguire i comandi come utente openclaw:

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

Configurazione avanzata

Per informazioni dettagliate sull’architettura di sicurezza e sulla risoluzione dei problemi, consultare il repository openclaw-ansible:

Contenuti correlati

openclaw-ansible: guida completa alla distribuzione
Docker: configurazione del Gateway in container
Uso della sandbox: configurazione della sandbox per gli agenti
Sandbox e strumenti multi-agente: isolamento per agente

Install overview

Maintenance

Containers

Hosting

Advanced setup

Prerequisiti

Funzionalità incluse

Avvio rapido

Componenti installati

Configurazione successiva all’installazione

Comandi rapidi

Architettura di sicurezza

Installazione manuale

Aggiornamento

Risoluzione dei problemi

Configurazione avanzata

Contenuti correlati

​Prerequisiti

​Funzionalità incluse

​Avvio rapido

​Componenti installati

​Configurazione successiva all’installazione

​Comandi rapidi

​Architettura di sicurezza

​Installazione manuale

​Aggiornamento

​Risoluzione dei problemi

​Configurazione avanzata

​Contenuti correlati

Prerequisiti

Funzionalità incluse

Avvio rapido

Componenti installati

Configurazione successiva all’installazione

Comandi rapidi

Architettura di sicurezza

Installazione manuale

Aggiornamento

Risoluzione dei problemi

Configurazione avanzata

Contenuti correlati