Preferisci che se ne occupino gli esperti?
Salta il terminale. Il nostro team installa, mette in sicurezza e configura OpenClaw per te. Piani a partire da $169.
Prerequisiti
Prima di installare OpenClaw, assicurati che il tuo server soddisfi questi requisiti minimi. Specifiche inferiori comportano risposte lente, processi che si bloccano e utenti frustrati.
Minimo 2 core vCPU. 4 vCPU consigliati per configurazioni multi-canale.
Minimo 4 GB. 8 GB consigliati se esegui LLM locali tramite Ollama.
Minimo 20 GB SSD. I database di memoria e i log crescono nel tempo. Prevedi 50 GB a lungo termine.
Ubuntu 22.04+, Debian 12+ o qualsiasi Linux con supporto Docker. Anche macOS e Windows (WSL2) funzionano.
Ti serviranno anche
- Accesso SSH al tuo server. Se puoi eseguire ssh root@your-server-ip, sei a posto.
- Una chiave API per un modello AI di Anthropic, OpenAI, Google o un modello locale tramite Ollama. Procuratene una prima di iniziare.
- Un nome di dominio (opzionale). Non obbligatorio, ma consigliato per SSL e URL di webhook puliti.
1.One-Liner (Consigliato)
Il modo più veloce per installare OpenClaw. Un singolo comando gestisce tutto: controllo delle dipendenze, download, procedura guidata di configurazione e installazione del servizio. Funziona su Ubuntu, Debian, CentOS, Fedora, Arch e macOS.
curl -fsSL https://openclaw.sh | bashCosa fa l'installer
Rileva il tuo sistema operativo e gestore di pacchetti
Installa Node.js 20 LTS se non presente
Installa pnpm globalmente per una risoluzione delle dipendenze più rapida
Scarica l'ultima release stabile di OpenClaw
Esegue la procedura guidata di configurazione interattiva
Crea un servizio systemd (Linux) o un agent launchd (macOS)
Avvia OpenClaw e conferma che sia in esecuzione
Output atteso
[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/dashboardFlag personalizzati
Passa flag per personalizzare l'installazione senza la procedura guidata interattiva.
# Skip the wizard with pre-set values
curl -fsSL https://openclaw.sh | bash -s -- \
--provider anthropic \
--model claude-sonnet-4-5 \
--port 3100 \
--no-systemd2.npm / pnpm
Ideale per gli sviluppatori che vogliono il controllo completo del processo. Questo metodo offre visibilità esplicita su ogni passaggio.
Passo 1: Installa Node.js 20+
OpenClaw richiede Node.js 20 o successivo. Verifica prima la tua versione.
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 20Passo 2: Installa pnpm
npm install -g pnpmPasso 3: Installa OpenClaw globalmente
pnpm install -g openclaw
# Or with npm:
npm install -g openclawPasso 4: Inizializza la configurazione
Il comando init crea un file .env e una directory data/ nella tua cartella corrente.
mkdir ~/openclaw && cd ~/openclaw
openclaw initPasso 5: Modifica il tuo file .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-xxxxxxxxxxxxxxxxPasso 6: Avvia OpenClaw
openclaw start
# Or run in background:
openclaw start --daemon3.Docker
Docker isola OpenClaw dal sistema host. Gli aggiornamenti sono semplici: scarica la nuova immagine e riavvia. Questo metodo è ideale per server di produzione e team.
Passo 1: Installa 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 effectPasso 2: Crea 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: 3Passo 3: Crea il tuo file .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=Passo 4: Avvia il container
docker compose up -d
# Check the logs
docker compose logs -f openclawAggiornamento con Docker
docker compose pull
docker compose up -d4.Da Sorgente
Compila da sorgente quando vuoi modificare il comportamento del core, contribuire upstream o eseguire un branch pre-release. Questo percorso richiede esperienza da sviluppatore.
Passo 1: Clona il repository
git clone https://github.com/openclaw/openclaw.git
cd openclawPasso 2: Installa le dipendenze
# Requires Node.js 20+ and pnpm
pnpm installPasso 3: Copia e modifica il file dell'ambiente
cp .env.example .env
nano .env
# Set your AI_PROVIDER, API keys, and portPasso 4: Compila e avvia
pnpm build
pnpm start
# For development with hot reload:
pnpm devAggiornamento da sorgente
git pull origin main
pnpm install
pnpm build
# Restart your OpenClaw process or servicePost-Installazione
OpenClaw è in esecuzione. Ora configura il tuo modello AI, connetti un canale di messaggistica e verifica che tutto funzioni.
Configura il Tuo Modello AI
OpenClaw supporta diversi provider AI. Imposta il tuo modello preferito nel file .env o tramite la dashboard.
| Provider | Modelli | Costo / msg |
|---|---|---|
| Anthropic | Claude Opus 4.8, Sonnet 5, Haiku 4.5 | $0.001 – $0.05 |
| OpenAI | GPT-5.6 Terra, GPT-5.6 Luna | $0.002 – $0.03 |
| Gemini 3 Pro, Gemini 3.5 Flash | $0.001 – $0.02 | |
| DeepSeek | DeepSeek V3 | ~$0.005 |
| Mistral | Mistral Large | ~$0.01 |
| Ollama (local) | Llama 4, Qwen 3, Mistral, and any GGUF model | Free |
# Example: Switch to Claude Opus 4.8
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:11434Configura il Tuo Primo Canale (Esempio WhatsApp)
OpenClaw supporta oltre 191 integrazioni. WhatsApp è il punto di partenza più popolare. Ecco come collegarlo.
Crea una Meta Business App
Vai su developers.facebook.com. Crea una nuova app Business. Abilita il prodotto WhatsApp.
Ottieni il tuo Phone Number ID e token
Nelle impostazioni dell'API WhatsApp, copia il tuo Phone Number ID e genera un access token permanente.
Aggiungi le credenziali al .env
WHATSAPP_ENABLED=true
WHATSAPP_PHONE_ID=123456789012345
WHATSAPP_TOKEN=EAAxxxxxxxxxxxxxxxx
WHATSAPP_VERIFY_TOKEN=your-random-verify-stringImposta l'URL del webhook
Nella dashboard di Meta, imposta l'URL del webhook su https://your-domain.com/api/webhook/whatsapp e usa il verify token del passo 3.
Riavvia OpenClaw e invia un messaggio di prova
openclaw restart
# Or with Docker:
docker compose restart openclawInvia il Tuo Primo Messaggio
Apri WhatsApp e invia "Hello" al numero collegato. Dovresti ricevere una risposta entro 2-5 secondi. Se non hai configurato WhatsApp, prova tramite la dashboard.
# Quick test via CLI
curl -X POST http://localhost:3100/api/chat \
-H "Content-Type: application/json" \
-d '{"message": "Hello, what can you do?"}'Una risposta riuscita restituisce JSON con la risposta dell'AI. Se ricevi un errore, consulta la sezione di risoluzione dei problemi qui sotto.
Errori Comuni e Soluzioni
La maggior parte dei problemi di installazione rientra in cinque categorie. Ecco come risolvere ciascuno.
Error: Porta 3100 già in uso
Un altro processo occupa la porta predefinita di OpenClaw.
# 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=3200Error: Versione di Node non compatibile
OpenClaw richiede Node.js 20 o successivo. Le versioni precedenti causano errori di sintassi all'avvio.
# 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 higherError: Permesso Docker negato
Vedi "permission denied while trying to connect to the Docker daemon socket".
# 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 dockerError: Problemi con il certificato SSL
I provider di webhook come Meta rifiutano gli endpoint HTTP. Serve HTTPS.
# 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-runError: Memoria esaurita / processo terminato
L'OOM killer di Linux termina OpenClaw quando il server esaurisce la RAM.
# 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-5Il modello AI vero e proprio viene eseguito da remoto tramite API. I problemi di memoria derivano dal database di memoria di OpenClaw e dal processo Node.js, non dal modello. 4 GB di RAM sono il minimo pratico.
Sicurezza Post-Installazione
Un'istanza di OpenClaw in esecuzione senza sicurezza è un rischio. La ricerca di sicurezza (Maor Dayan, confermata da CSO Online) ha rilevato circa 42.665 istanze esposte sulla rete internet aperta, circa il 93% con condizioni di bypass dell'autenticazione, e ClawBleed (CVE-2026-25253) è attivamente sfruttata. Non diventare una statistica.
Checklist di sicurezza (versione rapida)
- Abilita l'autenticazione in .env: imposta AUTH_ENABLED=true e AUTH_SECRET su una stringa casuale di 32 caratteri
- Configura il firewall UFW: consenti solo le porte 22 (SSH), 80 (HTTP) e 443 (HTTPS)
- Configura SSL/TLS con Let's Encrypt o i certificati origin di Cloudflare
- Disabilita la dashboard in produzione o proteggila con autenticazione
- Mantieni OpenClaw aggiornato: esegui openclaw update o docker compose pull settimanalmente
- Usa un reverse proxy (Nginx o Caddy) davanti a OpenClaw
- Non esporre mai la porta 3100 direttamente su internet
# 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 statusQuesta è la versione ridotta. Per l'audit di sicurezza completo in 12 punti che applichiamo a ogni installazione cliente, leggi la nostra Guida alla Sicurezza & Checklist di Sicurezza.
FAQ
Hai bisogno di aiuto?
Il nostro team installa, mette in sicurezza e configura OpenClaw sul tuo server. Inclusi memoria persistente, configurazione multi-canale e un audit di sicurezza in 12 punti.