OpenClaw Guide: Build Your AI Assistant

TL;DR

• OpenClaw è un assistente AI open-source con oltre 135.000 stelle su GitHub
• Funziona localmente sulla tua macchina — i tuoi dati rimangono privati
• Si connette tramite WhatsApp, Telegram, Discord, Slack, iMessage e altro ancora
• Oltre 3.000 skill della community per automazione, coding, smart home e altro
• Gratuito (paghi solo per i token delle API AI, tipicamente $10-50 al mese)
• La configurazione richiede circa 30 minuti con questa guida

Cos'è OpenClaw?

OpenClaw (precedentemente noto come Clawdbot, poi Moltbot) è il progetto AI open-source più caldo del 2026. È un assistente AI personale che:

• Gira sul tuo computer o server
• Si connette alle tue app di messaggistica preferite (WhatsApp, Telegram, Discord, ecc.)
• Ha pieno accesso al tuo file system, terminale e browser
• Può automatizzare task come un assistente personale potenziato

Il Percorso: Clawdbot → Moltbot → OpenClaw

Il progetto ha avuto una discreta avventura nella scelta del nome:

Non importa come lo chiami, la funzionalità rimane la stessa — un assistente AI incredibilmente potente che gira localmente.

Perché OpenClaw?

vs. ChatGPT / Claude Web

vs. Altri Agenti AI

Le caratteristiche killer di OpenClaw:

1. Inbox multi-canale: Un'unica AI, accessibile da WhatsApp, Telegram, Discord, Slack, iMessage e oltre 12 piattaforme
2. Memoria persistente: Ricorda il contesto tra le conversazioni
3. Ecosistema di skill: Oltre 3.000 plugin della community tramite ClawHub
4. Agnostico rispetto al modello: Funziona con Claude, GPT, Gemini, DeepSeek, modelli locali Ollama, ecc.
5. Open source: Licenza MIT, codice completamente verificabile

Prerequisiti

Prima di iniziare, assicurati di avere:

• [ ] Un computer (Mac, Windows con WSL2 o Linux)
• [ ] Node.js v22+ installato (scarica qui)
• [ ] Una chiave API per l'AI (Anthropic Claude, OpenAI o altri)
• [ ] Circa 30 minuti di tempo

Requisiti Hardware

Metodi di Installazione

Metodo 1: Installazione in una riga (Consigliato)

Il modo più veloce per iniziare:

curl -fsSL https://openclaw.bot/install.sh | bash

Questo script:

1. Verificherà i requisiti di sistema


2. Installerà OpenClaw


3. Avvierà l'onboarding guidato

Metodo 2: Docker (Consigliato per i Server)

Se preferisci una distribuzione containerizzata:

# Clona il repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Esegui il setup Docker
./docker-setup.sh

Il setup Docker crea due directory importanti:

• ~/.openclaw/ — Configurazione, memoria, chiavi API


• ~/openclaw/workspace/ — File accessibili all'agente AI

Metodo 3: Build dai sorgenti

Per gli sviluppatori che desiderano il pieno controllo:

# Clona il repository
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Installa le dipendenze
pnpm install

# Build della UI
pnpm ui:build

# Build del progetto
pnpm build

# Esegui l'onboarding
pnpm openclaw onboard --install-daemon

Configurazione Passo-Passo

Passo 1: Esegui l'Onboarding Guidato

Dopo l'installazione, l'onboarding guidato si avvia automaticamente. Se non succede, esegui:

openclaw onboard --install-daemon

La procedura ti guiderà attraverso:

1. Selezione del Provider del Modello
2. Configurazione della Chiave API
3. Setup della Piattaforma di Messaggistica
4. Impostazioni di Sicurezza

Passo 2: Configura il tuo Modello AI

OpenClaw supporta diversi provider AI. Scegline uno:

Opzione A: Anthropic Claude (Consigliata)

# Imposta la tua chiave API
export ANTHROPIC_API_KEY=sk-ant-xxxxx

# Oppure usa il comando config
openclaw config set 'models.default' 'claude-sonnet-4'

Opzione B: OpenAI

export OPENAI_API_KEY=sk-xxxxx
openclaw config set 'models.default' 'gpt-4o'

Opzione C: DeepSeek (Economico)

openclaw config set 'models.providers.deepseek' --json '{
  "baseUrl": "https://api.deepseek.com/v1",
  "apiKey": "your-api-key",
  "api": "openai-completions",
  "models": [
    { "id": "deepseek-chat", "name": "DeepSeek Chat" },
    { "id": "deepseek-reasoner", "name": "DeepSeek Reasoner" }
  ]
}'

Opzione D: Modelli locali con Ollama

Per una privacy totale, fai girare i modelli localmente:

# Installa prima Ollama: https://ollama.ai
ollama pull llama3.3

# Configura OpenClaw per usarlo
openclaw config set 'models.providers.ollama' --json '{
  "baseUrl": "http://localhost:11434/v1",
  "api": "openai-completions",
  "models": [
    { "id": "llama3.3", "name": "Llama 3.3" }
  ]
}'

Passo 3: Connetti le Piattaforme di Messaggistica

Qui è dove OpenClaw brilla — chatta con la tua AI ovunque ti trovi.

Telegram (Il più semplice)

1. Invia un messaggio a @BotFather su Telegram
2. Invia /newbot e segui le istruzioni
3. Copia il token del tuo bot
4. Configura OpenClaw:

openclaw config set 'channels.telegram.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.telegram.allowlist' '["your_telegram_username"]'

WhatsApp

OpenClaw utilizza WhatsApp Web per la connessione:

# Abilita il canale WhatsApp
openclaw config set 'channels.whatsapp.enabled' true

# Riavvia il gateway
openclaw gateway restart

# Scansiona il codice QR che appare

Un codice QR apparirà nel tuo terminale. Scansionalo con WhatsApp sul tuo telefono (Impostazioni → Dispositivi collegati → Collega un dispositivo).

Discord

1. Crea un'applicazione Discord su discord.com/developers
2. Crea un bot e copia il token
3. Configura:

openclaw config set 'channels.discord.token' 'YOUR_BOT_TOKEN'
openclaw config set 'channels.discord.allowlist' '["your_discord_user_id"]'

iMessage (Solo Mac)

Per gli utenti Mac, OpenClaw può connettersi direttamente a iMessage:

openclaw config set 'channels.imessage.enabled' true

Passo 4: Avvia il Gateway

Il gateway è il servizio in background che mantiene OpenClaw in esecuzione:

# Avvia come demone (servizio in background)
openclaw gateway start

# Oppure esegui in primo piano per il debugging
openclaw gateway

# Controlla lo stato
openclaw gateway status

# Visualizza i log
openclaw logs --follow

Passo 5: Accedi alla Web Dashboard

OpenClaw include un'interfaccia web per la configurazione e la chat diretta:

# Apri la dashboard nel tuo browser
openclaw dashboard

Questo aprirà http://127.0.0.1:18789/ con un token di accesso temporaneo.

Dalla dashboard puoi:

• Chattare direttamente con la tua AI


• Gestire le impostazioni


• Visualizzare la cronologia delle conversazioni


• Installare skill

La Tua Prima Conversazione

Una volta configurato tutto, invia un messaggio al tuo bot (tramite Telegram, WhatsApp o l'interfaccia web):

Ciao! Puoi dirmi cosa sai fare?

OpenClaw si presenterà e mostrerà le sue capacità. Prova alcuni compiti reali:

Quali file ci sono nella mia cartella Download?

Cerca nei miei documenti qualsiasi cosa relativa a "tasse 2025"

Crea uno script Python che converte CSV in JSON

Cosa sta usando più spazio su disco sul mio computer?

Installazione delle Skill

Le skill estendono le capacità di OpenClaw. Sfoglia il registro ClawHub o installale direttamente:

Skill Popolari

# Integrazione GitHub
openclaw skill install github

# Automazione browser web
openclaw skill install agent-browser

# Gestione calendario
openclaw skill install calendar

# Automazione email
openclaw skill install email

# Controllo smart home
openclaw skill install homeassistant

# Generazione immagini
openclaw skill install dalle

# Conversazioni vocali (Discord)
openclaw skill install discord-voice

Categorie di Skill

Avviso di Sicurezza

⚠️ Importante: Revisiona le skill prima di installarle. La natura aperta di ClawHub implica che possono esistere skill malevole. Usa openclaw skill inspect per esaminare il codice, o chiedi a Claude Code / Codex di effettuarne l'audit.

Configurazione Avanzata

Struttura del File di Configurazione

OpenClaw memorizza la configurazione in ~/.openclaw/:

~/.openclaw/
├── openclaw.json    # Configurazione principale
├── env              # Variabili d'ambiente (chiavi API)
├── memory/          # Archiviazione memoria persistente
├── skills/          # Skill installate
├── backups/         # Backup della configurazione
└── logs/            # File di log

Modifica della Configurazione

# Visualizza la config attuale
openclaw config get

# Imposta un valore
openclaw config set 'key.path' 'value'

# Modifica nel tuo editor predefinito
openclaw config edit

Gestione della Memoria

OpenClaw mantiene una memoria persistente attraverso le conversazioni:

# Visualizza statistiche sulla memoria
openclaw memory stats

# Cancella tutta la memoria (attenzione!)
openclaw memory clear

# Esporta la memoria per il backup
openclaw memory export > memory-backup.json

Esecuzione di Controlli dello Stato (Health Checks)

# Controllo completo dello stato
openclaw doctor

# Controlla componenti specifici
openclaw doctor --check api
openclaw doctor --check channels
openclaw doctor --check skills

Best Practice per la Sicurezza

OpenClaw ha pieno accesso al sistema — questo lo rende potente, ma anche rischioso. Segui queste linee guida:

1. Usa una Macchina Dedicata

Non far girare OpenClaw sul tuo computer di lavoro principale. Opzioni:

• VPS: DigitalOcean, Vultr, AWS ($5-20/mese)
• Vecchio laptop: Riutilizza vecchio hardware
• Raspberry Pi: Funziona per un utilizzo leggero
• Docker: Fornisce un certo isolamento

2. Abilita la Modalità Sandbox

Per sessioni non affidabili (chat di gruppo, canali):

openclaw config set 'agents.defaults.sandbox.mode' 'non-main'

Questo esegue le sessioni di gruppo/canale all'interno di sandbox Docker.

3. Usa le Allowlists

Consenti solo a utenti specifici di interagire con il tuo bot:

# Telegram
openclaw config set 'channels.telegram.allowlist' '["username1", "username2"]'

# Discord
openclaw config set 'channels.discord.allowlist' '["user_id_1", "user_id_2"]'

4. Mantieni Aggiornato

Nelle versioni precedenti sono state trovate vulnerabilità di sicurezza. Esegui sempre l'ultima versione:

# Controlla gli aggiornamenti
openclaw update --check

# Aggiorna all'ultima versione
openclaw update

Nota: Le versioni precedenti alla 2026.1.29 hanno una vulnerabilità di sicurezza nota. Aggiorna immediatamente se sei su una versione più vecchia.

5. Controlla le Skill prima di Installarle

# Ispeziona il codice di una skill
openclaw skill inspect <skill-name>

# Controlla la reputazione di una skill
openclaw skill info <skill-name>

Esempi di Automazione

Ecco dove OpenClaw diventa davvero potente:

Briefing Mattutino

Imposta un riepilogo giornaliero alle 8:00:

# Nella tua configurazione, aggiungi un cron job
openclaw config set 'automations.morning-briefing' --json '{
  "cron": "0 8 * * *",
  "action": "Inviami un riepilogo di: previsioni meteo, eventi a calendario oggi, email importanti non lette e le prime 3 notizie principali"
}'

Bot per Revisione PR GitHub

Revisiona automaticamente le PR quando ti vengono assegnate:

openclaw skill install github

# Configura webhook o polling
openclaw config set 'automations.pr-review' --json '{
  "trigger": "github.pr.assigned",
  "action": "Review the PR, check for bugs, security issues, and style violations. Post a summary comment."
}'

Scene Smart Home

openclaw skill install homeassistant

# Automazione "Uscita di casa"
openclaw config set 'automations.leaving-home' --json '{
  "trigger": "location.leave_home",
  "action": "Spegni tutte le luci, imposta il termostato in modalità eco, inserisci il sistema di sicurezza"
}'

Organizzazione File

Dì a OpenClaw di organizzare la tua cartella Download:

Organizza la mia cartella Download: sposta le immagini in ~/Pictures, i documenti in ~/Documents e cancella tutto ciò che è più vecchio di 30 giorni

Risoluzione dei Problemi

Problemi Comuni

# Aggiungi al PATH
export PATH="$HOME/.openclaw/bin:$PATH"
# Aggiungi al profilo della tua shell (.bashrc, .zshrc)

# Controlla le tue variabili d'ambiente
openclaw config get models

# Riesegui l'onboarding
openclaw onboard

# Controlla i log
openclaw logs --channel whatsapp

# Riavvia il gateway
openclaw gateway restart

# Ricostruisci l'indice delle skill
openclaw skill rebuild

# Controlla eventuali conflitti
openclaw doctor --check skills

Ottenere Aiuto

• Documentazione: docs.openclaw.ai
• GitHub Issues: github.com/openclaw/openclaw/issues
• Community Discord: discord.gg/openclaw
• Reddit: r/OpenClaw

Analisi dei Costi

OpenClaw in sé è gratuito. I costi derivano dall'uso delle API AI:

Consigli per Risparmiare

1. Usa DeepSeek per i task di routine ($0.14/M token vs i $3/M di Claude)
2. Modelli locali per query semplici (gratis dopo l'acquisto dell'hardware)
3. Imposta limiti di token per conversazione
4. Usa il caching per query ripetute

Quali sono i prossimi passi?

Ora che OpenClaw è operativo, ecco alcune idee:

Crea le Tue Skill

Crea skill personalizzate per le tue esigenze specifiche:

# Crea una nuova skill
openclaw skill create my-custom-skill

# Modifica la skill
code ~/.openclaw/skills/my-custom-skill/SKILL.md

Connetti più Piattaforme

• Aggiungi più account WhatsApp (personale + lavoro)
• Connetti Slack per il lavoro, Discord per il tempo libero
• Configura iMessage per l'ecosistema Apple

Esplora l'Ecosistema

• Sfoglia ClawHub per oltre 3.000 skill
• Unisciti alla community Discord per suggerimenti e trucchi
• Segui @OpenClaw per gli aggiornamenti

Andare Oltre: Distribuisci i Tuoi Prodotti AI

Dopo aver sperimentato la potenza degli assistenti AI, potresti voler creare prodotti per altri. È qui che entra in gioco Y Build.

Y Build ti aiuta a passare da un'idea alimentata dall'AI a un prodotto lanciato:

1. AI Coding: Descrivi cosa desideri, l'AI genera il codice
2. Distribuzione con un Click: Vai live istantaneamente con una CDN globale
3. Strumenti di Crescita: Video demo, ottimizzazione SEO, analytics

• Uno strumento SaaS alimentato dall'AI
• Una piattaforma di automazione come OpenClaw
• Un chatbot personalizzato per la tua attività

Conclusione

OpenClaw rappresenta un nuovo paradigma nell'AI personale — un assistente che è:

• Locale: I tuoi dati non lasciano mai la tua macchina
• Potente: Il pieno accesso al sistema significa vera automazione
• Estensibile: Oltre 3.000 skill e in continua crescita
• Multi-piattaforma: Un'unica AI, accessibile ovunque

• Rispondere alle domande dal tuo WhatsApp
• Cercare e organizzare i tuoi file
• Automatizzare task ripetitivi
• Controllare la tua smart home
• E molto altro ancora

Benvenuto nella community di OpenClaw. 🦞

• Documentazione Ufficiale OpenClaw
• Repository GitHub OpenClaw
• Registro Skill ClawHub
• Codecademy: Tutorial OpenClaw
• DigitalOcean: Cos'è OpenClaw
• Hostinger: Come configurare OpenClaw
• CNBC: Da Clawdbot a OpenClaw
• Medium: Far girare OpenClaw in sicurezza con Docker