Openclaw ed AI

⚡ J.A.R.V.I.S. in casa: come ho costruito un assistente AI per la mia rete domestica

(e come puoi farlo anche tu con OpenClaw)

OpenClaw - Personal AI Assistant

OpenClaw - il framework AI personale

1. Perché un assistente AI per la rete di casa?

Se sei arrivato fin qui, probabilmente hai una home lab, un server Proxmox che rumoreggia in cantina, e una ventina di dispositivi IoT che ogni tanto fanno stranezze.

O forse hai solo sentito parlare di OpenClaw e vuoi capire cosa ci si può fare davvero.

Partiamo da una premessa: la mia rete domestica non è semplice.

  • 🔥 Un firewall IPFire a bordo di una VM Proxmox
  • 🏠 Home Assistant che gestisce luci e sensori
  • 🚫 Un Pi-Hole che blocca pubblicità a 70+ client
  • ☁️ Un Cloudflare Tunnel per esporre servizi all'esterno
  • 🚗 Sensori BYD per l'auto elettrica
  • 📡 Dispositivi IoT su rete segregata

Ogni mattina, invece di controllare manualmente cinque dashboard diverse, apro Telegram e trovo un riepilogo. Se c'è un problema, il mio assistente me lo dice prima ancora che io lo noti.

Se la RAM di IPFire sale troppo, se un container si ferma, se compare un dispositivo sconosciuto sulla rete — lo so in tempo reale.

Tutto questo si chiama J.A.R.V.I.S. (perché chiamarlo "assistente" era troppo banale) ed è basato su OpenClaw, un framework open-source per AI agent personali.

2. Cos'è OpenClaw?

OpenClaw è un framework che permette di eseguire agenti AI sul proprio hardware, in modo completamente privato e controllato.

Non è un chatbot. È un assistente che può:

  • ✅ Eseguire comandi sul tuo server
  • ✅ Leggere file e documenti
  • ✅ Chiamare API locali (Home Assistant, Proxmox, e altri)
  • ✅ Inviare messaggi su Telegram, Discord, WhatsApp
  • ✅ Parlare tramite altoparlanti smart (Edge TTS / Alexa)
  • ✅ Monitorare la rete in autonomia

💡 La differenza fondamentale rispetto ad Alexa o Google Home:

✅ Tutto rimane in casa tua — niente cloud esterno
✅ Può fare cose che nessun assistente commerciale può fare
✅ Lo estendi con skill personalizzate scaricabili dal registry

Installazione base? 10 minuti.

3. La mia architettura di rete

Vediamo cosa c'è sotto il cofano. La mia rete non è nata organizzata così, si è evoluta negli anni. Ma funziona.

🔧 Hardware

Dispositivo Ruolo Consumo
Chuwi RZBOX Host OpenClaw ~15W
Intel N100 Server Proxmox ~25W
Raspberry Pi 4 Backup NAS (NFS) ~5W

🐧 Servizi su Proxmox

  • IPFire (VM105) — Firewall 3 interfacce: WAN, LAN Verde, IoT Blu
  • Home Assistant OS (VM103) — Domotica, 60+ entità
  • OpenMediaVault (VM104) — NAS, documenti, foto
  • Cloudflared (LXC106) — Tunnel Cloudflare per accesso remoto
  • Pi-Hole (LXC112) — DNS blocker, 70 client, 590k domini bloccati
  • Immich (VM102) — Foto e video
Dashboard Monitoring

Esempio di dashboard monitoring — il tuo assistente vede tutto in tempo reale

4. Cosa ci faccio davvero (esempi reali)

🔹 Sentinella di Rete (la mia feature preferita)

Ogni 5 minuti J.A.R.V.I.S. esegue controlli automatici su tutti i servizi. Non via polling di terze parti, ma via API dirette:

  • Home Assistant API — controlla i sensori IPFire: CPU, RAM, disco, stato Internet
  • Proxmox API — verifica che tutte le VM e LXC siano in esecuzione
  • Cloudflared — controlla che il tunnel sia attivo
  • Pi-Hole — verifica gravity aggiornata, percentuale blocco
  • nmap differenziale — scansiona la LAN per nuovi dispositivi

✅ IPFire: RAM 92% (normale per IPFire)
✅ Pi-Hole: attivo, blocca 44%, 85k query
✅ Cloudflared: running, 178h uptime
✅ Proxmox: 4 VM + 3 LXC tutte running
✅ Chuwi: disco 45%, CPU 0%
✅ Rete: 10 dispositivi, nessun nuovo

Questo è il report che ricevo quando tutto funziona. Se c'è un problema, il messaggio cambia drasticamente e me lo dice su Telegram.

La parte figa: se c'è un allarme critico e sono a casa, me lo annuncia a voce in salotto via Alexa. Se non ci sono, solo Telegram. Niente spam quando non serva.

🔹 Analisi documenti con AI locale

Ho centinaia di documenti sul NAS: contratti assicurativi, manuali tecnici, estratti conto. Invece di cercare a mano, posso chiedere:

"J.A.R.V.I.S., trova nel contratto BYD la durata della batteria"

L'assistente cerca il PDF sul NAS, lo analizza con qwen2.5:7b su Ollama (locale, niente cloud), e mi risponde con la pagina e il contenuto esatto. Zero dati che lasciano casa mia.

🔹 Controllo domotica combinato

Accendere una luce è banale. La differenza è combinare comandi complessi in una frase:

"Accendi la luce in salotto, abbassa le tapparelle, e dimmi se la BYD ha finito di caricare"

Tre azioni, una frase. Funziona con qualsiasi skill Home Assistant.

🔹 Verifica backup automatica

Il backup di Home Assistant è schedulato su Proxmox ogni domenica alle 13:00 su storage NFS esterno (RPi4). J.A.R.V.I.S. può verificare che il backup sia stato eseguito senza dover aprire Proxmox — una cosa che facevo manualmente e che spesso dimenticavo.

5. Le skill installate

La forza di OpenClaw sono le skill: moduli che descrivono come interagire con un servizio. Ogni skill ha istruzioni, endpoint, comandi.

Skill Endpoint Cosa fa
Home Assistant :8123 Luci, sensori, presenze, termostato, auto BYD
Proxmox :8006 Stato VM/LXC, risorse, storage (read-only)
Document-RAG Locale Cerca documenti sul NAS, analisi con Ollama locale
Pi-Hole :80 (API v6) Statistiche DNS, monitoraggio gravity
Grafana Dashboard

Grafana + InfluxDB per metriche energetiche dell'auto BYD

6. Installazione passo-passo

Se ti ho incuriosito, ecco come partire in 10 minuti.

# 1. Installa Node.js 22+

npm install -g openclaw

# 2. Configura il gateway

openclaw gateway setup

# 3. Collega Telegram

openclaw connect telegram

# 4. Cerca skill

openclaw skills search home-assistant

# 5. Installa la prima skill

openclaw skills install homeassistant-skill

A questo punto hai un assistente funzionante. Puoi chiedergli "come sta la rete?" e ti risponderà.

Per estenderlo:

  • Scarica skill dal registry clawhub.ai
  • Configura heartbeat per controlli periodici
  • Aggiungi TTS per annunci vocali (Edge TTS, Amazon Polly)
  • Collega strumenti come nmap, snmpwalk, whois per diagnostica rete

7. Costi (spolier: quasi zero)

Server 15W (già acceso per altri servizi) €0
API sentinella DeepSeek ~$0.003/mese ~€0.003
LLM locale Ollama + qwen2.5:7b €0
Telegram Canale di comunicazione €0
TOTALE ~€0.003/mese

Il costo reale è praticamente zero. E tutto resta in casa tua: nessun dato personale lascia mai la tua rete verso cloud di terze parti.

8. Limiti onesti

Non è tutto rose. Ecco cosa devi sapere:

  • ⚠️ Serve competenza tecnica. Se non hai mai configurato un server Linux, forse non è il momento. OpenClaw è potente ma non è plug-and-play come Alexa.
  • 🐢 I LLM locali sono lenti. qwen2.5:7b su N100 impiega ~90 secondi per analizzare un PDF. Per operazioni rapide uso modelli cloud.
  • 🔑 Gestione token. Ogni servizio ha la sua autenticazione: Bearer token, API Token, App Password. Vanno tutte salvate in modo sicuro.
  • 🤖 L'AI a volte sbaglia. Per operazioni critiche ho script bash deterministici indipendenti dall'AI. Mai fidarsi ciecamente.
  • 🔧 Manutenzione. Le API cambiano, le skill vanno aggiornate, i token scadono. È un sistema vivo.

9. Conclusioni

OpenClaw è lo strumento che trasforma un insieme di servizi self-hosted in qualcosa di più: un ecosistema che parla con te, ti avvisa, ti aiuta.

Non sostituisce Home Assistant o Proxmox. Li rende accessibili senza dover aprire cinque dashboard diverse per capire cosa sta succedendo. È il punto di contatto tra te e la tua infrastruttura.

Nel mio caso, la differenza l'ha fatta quando:

  • 🔥 La RAM di IPFire è impazzita e ho saputo tutto via Telegram prima di arrivare a casa
  • 📄 Ho ritrovato una clausola assicurativa su oltre 1000 documenti in secondi
  • 💡 Ho spento tutte le luci di casa con una frase mentre ero già a letto
  • 🔍 La sentinella ha rilevato un dispositivo sconosciuto in rete (era un ospite, ma meglio saperlo)

Se hai una home lab, un server Proxmox, o anche solo un Raspberry Pi con qualche servizio — provalo. È uno di quei progetti che non sapevi di volere finché non lo vedi funzionare.


🔗 Link utili

Commenti