Quali sono i requisiti minimi del server per OpenClaw?

Servono almeno 2 core vCPU, 4 GB di RAM e 20 GB di archiviazione SSD. Ubuntu 22.04+, Debian 12+ o qualsiasi distribuzione Linux con supporto Docker vanno bene. macOS e Windows (tramite WSL2) sono adatti allo sviluppo locale ma non consigliati per la produzione.

Quale metodo di installazione è il migliore per i principianti?

L'installer one-liner (curl -fsSL https://openclaw.sh | bash) è l'opzione più veloce e semplice. Rileva automaticamente il tuo OS, installa le dipendenze e ti guida nella configurazione. L'intero processo richiede circa 5 minuti su un VPS nuovo.

Posso eseguire OpenClaw con Docker?

Sì. OpenClaw pubblica un'immagine Docker ufficiale. Usa il template docker-compose.yml del Metodo 3 sopra. Docker è ideale per ambienti isolati, rollback semplici e deployment coerenti. Monta sempre la directory data/ come volume per non perdere memoria e cronologia delle conversazioni.

Mi serve un nome di dominio per eseguire OpenClaw?

No. OpenClaw funziona di default sull'indirizzo IP del tuo server. Tuttavia, un nome di dominio è consigliato se vuoi certificati SSL tramite Let's Encrypt e URL di webhook più puliti per canali di messaggistica come WhatsApp e Telegram.

Come aggiorno OpenClaw dopo l'installazione?

Per le installazioni one-liner e npm, esegui openclaw update. Per Docker, esegui docker compose pull && docker compose up -d. Per le installazioni da sorgente, esegui git pull && pnpm install && pnpm build. Fai sempre il backup del file .env e della directory data/ prima di aggiornare.

Come Installare OpenClaw nel 2026, Passo dopo Passo | VPS, Docker, Mac

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.

Vedi i Piani

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.

CPU

Minimo 2 core vCPU. 4 vCPU consigliati per configurazioni multi-canale.

RAM

Minimo 4 GB. 8 GB consigliati se esegui LLM locali tramite Ollama.

Archiviazione

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.

Ti serve un VPS? Consigliamo Hetzner (CX22 a ~$4,50/mese) o DigitalOcean (Basic Droplet a $6/mese). Entrambi superano i requisiti minimi.

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 | bash

Cosa 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/dashboard

L'installer non viene mai eseguito con privilegi elevati oltre il necessario. Esamina il sorgente dello script prima di eseguirlo. Lo consigliamo per tutti gli script passati tramite pipe.

Flag 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-systemd

2.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 20

Passo 2 — Installa pnpm

npm install -g pnpm

Passo 3 — Installa OpenClaw globalmente

pnpm install -g openclaw
# Or with npm:
npm install -g openclaw

Passo 4 — Inizializza la configurazione

Il comando init crea un file .env e una directory data/ nella tua cartella corrente.

mkdir ~/openclaw && cd ~/openclaw
openclaw init

Passo 5 — Modifica il tuo file .env

.envenv

# ~/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-xxxxxxxxxxxxxxxx

Passo 6 — Avvia OpenClaw

openclaw start
# Or run in background:
openclaw start --daemon

Usa openclaw logs per visualizzare l'output in tempo reale. Aggiungi --follow per trasmettere le nuove voci.

3.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 effect

Passo 2 — Crea docker-compose.yml

docker-compose.ymlyaml

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

Passo 3 — Crea il tuo file .env

.envenv

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 openclaw

Aggiornamento con Docker

docker compose pull
docker compose up -d

Effettua sempre il bind-mount della tua directory data/. Senza un volume, perderai tutta la memoria e la cronologia delle conversazioni al riavvio del container.

4.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 openclaw

Passo 2 — Installa le dipendenze

# Requires Node.js 20+ and pnpm
pnpm install

Passo 3 — Copia e modifica il file dell'ambiente

cp .env.example .env
nano .env
# Set your AI_PROVIDER, API keys, and port

Passo 4 — Compila e avvia

pnpm build
pnpm start

# For development with hot reload:
pnpm dev

Aggiornamento da sorgente

git pull origin main
pnpm install
pnpm build
# Restart your OpenClaw process or service

La compilazione da sorgente trasforma TypeScript in JavaScript. Il passaggio di build richiede da 30 a 90 secondi a seconda dell'hardware. Le build successive sono più rapide grazie alla cache.

Post-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.6, Sonnet 4.5, Haiku 4.5	$0.001 – $0.05
OpenAI	GPT-5, GPT-5 mini	$0.002 – $0.03
Google	Gemini 3 Pro, Gemini 3 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

.envenv

# Example: Switch to Claude Opus 4.6
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:11434

Inizia con un modello più economico come Haiku 4.5 o Gemini 3 Flash durante i test. Passa a un modello più potente una volta configurati i canali e la memoria.

Configura 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

.envenv

WHATSAPP_ENABLED=true
WHATSAPP_PHONE_ID=123456789012345
WHATSAPP_TOKEN=EAAxxxxxxxxxxxxxxxx
WHATSAPP_VERIFY_TOKEN=your-random-verify-string

Imposta 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 openclaw

Invia 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=3200

Error: 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 higher

Error: 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 docker

Error: 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-run

Se sei dietro Cloudflare, imposta la modalità SSL su "Full (Strict)" e usa i certificati origin di Cloudflare invece di Let's Encrypt.

Error: 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-5

Il 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. Le ricerche mostrano che il 93,4% delle istanze pubbliche è privo di autenticazione di base e 42.665 sono esposte su internet. 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 status

Questa è 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.

Vedi i Piani Fai una Domanda