OpenClaw Quickstart: Installare con Docker (Ollama GPU o Claude + CPU)

OpenClaw è un assistente AI self-hosted progettato per funzionare con runtime LLM locali come Ollama o con modelli basati sul cloud come Claude Sonnet.

Questo guide rapida mostra come distribuire OpenClaw utilizzando Docker, configurare un modello locale alimentato da GPU o un modello cloud solo CPU e verificare che il tuo assistente AI funzioni correttamente dall’inizio alla fine.

Questa guida illustra una configurazione minima di OpenClaw per permetterti di vederlo in esecuzione e rispondere sulla tua macchina.

L’obiettivo è semplice:

• Avviare OpenClaw.
• Inviare una richiesta.
• Confermare che funziona.

Questa non è una guida per l’indurimento per la produzione.
Questa non è una guida per il tuning delle prestazioni.
Questo è un punto di partenza pratico.

Hai due opzioni:

• Percorso A — GPU Locale utilizzando Ollama (consigliato se disponi di una GPU)
• Percorso B — Solo CPU utilizzando Claude Sonnet 4.6 tramite API Anthropic

Entrambi i percorsi condividono lo stesso processo di installazione di base.

Se sei nuovo di OpenClaw e desideri una panoramica più approfondita su come è strutturato il sistema, leggi la panoramica del sistema OpenClaw. Se hai intenzione di eseguire un assistente sempre attivo con sandboxing più rigoroso e controlli delle policy, segui la guida alle operazioni sicure di NemoClaw.

Requisiti di sistema e configurazione dell’ambiente

OpenClaw è un sistema di tipo assistente che può connettersi a servizi esterni. Per questa guida rapida:

• Utilizzare account di test ove possibile.
• Evitare di connettere sistemi di produzione sensibili.
• Eseguirlo all’interno di Docker (consigliato).

L’isolamento è un’impostazione predefinita buona quando si sperimenta con software di tipo agente.

Prerequisiti OpenClaw (GPU con Ollama o CPU con Claude)

Richiesto per entrambi i percorsi

• Git
• Docker Desktop (o Docker + Docker Compose)
• Un terminale

Per il Percorso A (GPU Locale)

• Una macchina con una GPU compatibile (NVIDIA o AMD consigliate)
• Ollama installato

Per il Percorso B (CPU + Modello Cloud)

• Una chiave API Anthropic
• Accesso a Claude Sonnet 4.6

Passo 1 — Installare OpenClaw con Docker (Clonare & Avviare)

OpenClaw può essere avviato utilizzando Docker Compose. Questo mantiene la configurazione contenuta e riproducibile.

Clona il repository

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

Copia la configurazione dell’ambiente

cp .env.example .env

Apri .env nel tuo editor. Lo configureremo nel prossimo passo a seconda del percorso del modello che scegli.

Avvia i container

docker compose up -d

Se tutto si avvia correttamente, dovresti vedere i container in esecuzione:

docker ps

A questo punto, OpenClaw è in esecuzione — ma non è ancora connesso a un modello.

Passo 2 — Configurare il Provider LLM (Ollama GPU o Claude CPU)

Ora decidi come vuoi che funzioni l’inferenza.

Percorso A — GPU Locale con Ollama

Se hai una GPU disponibile, questa è l’opzione più semplice e autosufficiente.

Installa o verifica Ollama

Se hai bisogno di una guida di installazione più dettagliata o vuoi configurare le posizioni di archiviazione dei modelli, consulta:

• Installare Ollama e Configurare la Locazione dei Modelli
• Ollama CLI Cheatsheet: ls, serve, run, ps + altri comandi (aggiornamento 2026)

Se Ollama non è installato:

curl -fsSL https://ollama.com/install.sh | sh

Verifica che funzioni:

ollama pull llama3
ollama run llama3

Se il modello risponde, l’inferenza sta funzionando.

Configura OpenClaw per utilizzare Ollama

Nel tuo file .env, configura:

LLM_PROVIDER=ollama
OLLAMA_BASE_URL=http://host.docker.internal:11434
OLLAMA_MODEL=llama3

Riavvia i container:

docker compose restart

OpenClaw ora instraderà le richieste alla tua istanza locale di Ollama.

Se stai decidendo quale modello eseguire su una GPU con 16GB di VRAM o vuoi confronti delle benchmark, o hai bisogno di valori predefiniti sani per i sampler Qwen / Gemma per assistenti pesanti sugli strumenti, consulta:

• Migliori LLM per Ollama su GPU con 16GB di VRAM
• Parametri di inferenza Agentic LLM per Qwen e Gemma

Per comprendere la concorrenza e il comportamento della CPU sotto carico:

• Come Ollama Gestisce le Richieste Parallele
• Test: Come Ollama sta utilizzando le Performance della CPU Intel e i Core Efficient

Percorso B — Solo CPU Utilizzando Claude Sonnet 4.6

Se non hai una GPU, puoi utilizzare un modello ospitato.

Aggiungi la tua Chiave API

Nel tuo file .env:

LLM_PROVIDER=anthropic
ANTHROPIC_API_KEY=la_tua_chiave_api_qui
ANTHROPIC_MODEL=claude-sonnet-4-6

Riavvia:

docker compose restart

OpenClaw ora utilizzerà Claude Sonnet 4.6 per l’inferenza mentre l’orchestrazione viene eseguita localmente.

Questa configurazione funziona bene su macchine solo CPU perché il calcolo pesante del modello avviene nel cloud.

Se stai utilizzando modelli Anthropic qui, questo cambiamento nella policy di abbonamento Claude spiega perché OpenClaw richiede la fatturazione basata su API invece del riutilizzo del piano Claude.

Passo 3 — Testare OpenClaw con il tuo primo Prompt

Una volta che i container sono in esecuzione e il modello è configurato, puoi testare l’assistente.

A seconda della tua configurazione, questo può essere attraverso:

• Un’interfaccia web
• Un’integrazione di messaggistica
• Un endpoint API locale

Per un test API di base:

curl http://localhost:3000/health

Dovresti vedere una risposta di stato sano.

Ora invia un prompt semplice:

curl -X POST http://localhost:3000/chat   -H "Content-Type: application/json"   -d '{"message": "Spiega cosa fa OpenClaw in termini semplici."}'

Se ricevi una risposta strutturata, il sistema sta funzionando.

Cosa hai appena eseguito

A questo punto, hai:

• Un’istanza OpenClaw in esecuzione
• Un provider LLM configurato (locale o cloud)
• Un ciclo di richiesta-risposta funzionante

Se hai scelto il percorso GPU, l’inferenza avviene localmente tramite Ollama.

Se hai scelto il percorso CPU, l’inferenza avviene tramite Claude Sonnet 4.6, mentre orchestrazione, instradamento e gestione della memoria vengono eseguiti all’interno dei tuoi container Docker locali.

L’interazione visibile può sembrare semplice. Sotto il cofano, molteplici componenti coordinano l’elaborazione della tua richiesta.

Risoluzione dei problemi di installazione e runtime di OpenClaw

Modello non risponde

• Verifica la configurazione del tuo .env.
• Controlla i log del container:

docker compose logs

Ollama non raggiungibile

• Conferma che Ollama sia in esecuzione:

ollama list

• Assicurati che l’URL base corrisponda al tuo ambiente.

Chiave API non valida

• Ricontrolla ANTHROPIC_API_KEY
• Riavvia i container dopo aver aggiornato .env

GPU non viene utilizzata

• Conferma che i driver GPU siano installati.
• Assicurati che Docker abbia l’accesso alla GPU abilitato.

Prossimi passi dopo l’installazione di OpenClaw

Hai ora un’istanza OpenClaw funzionante.

Da qui, puoi:

• Connettere piattaforme di messaggistica
• Abilitare il recupero di documenti
• Sperimentare con strategie di instradamento
• Aggiungere osservabilità e metriche
• Regolare le prestazioni e il comportamento dei costi

Le discussioni architetturali più approfondite hanno più senso una volta che il sistema è in esecuzione.

Renderlo operativo è il primo passo.

Una volta in esecuzione, i prossimi articoli naturali sono:

• Guida ai plugin OpenClaw — quali plugin installare per memoria, strumenti, canali e osservabilità, e come funziona il ciclo di vita
• Guida alle competenze OpenClaw — quali competenze vale la pena installare da ClawHub, e come gestirle in modo sicuro per ogni ruolo dell’agente
• Pattern di setup di produzione OpenClaw — come plugin e competenze si combinano per tipi di utenti reali come sviluppatori, team di automazione, ricercatori e operatori di supporto

Per ulteriori studi di caso sui sistemi AI, consulta la sezione Sistemi AI.