OpenClaw Notifications: Come Ricevere Sempre Avvisi dal Tuo Agente AI (Guida per Principianti)
# OpenClaw Notifications: Come Ricevere Sempre Avvisi dal Tuo Agente AI (Guida per Principianti)
Hai mai pensato: "Ma come faccio a sapere se il mio agente AI ha finito quello che ho chiesto?" Oppure: "E se il mio agente si blocca? Lo scopro solo dopo?"
La risposta è semplice: **OpenClaw ha un sistema di notifiche e avvisi** che può avvisarti su Telegram, Discord, WhatsApp e altri canali. In questo articolo ti spiego come funziona, senza tecnicismi.
## COSA SONO LE NOTIFICHE IN OPENCLAW?
Immagina di avere un assistente che lavora per te. Ti dice "ok, ho finito" quando termina un compito. Ti avvisa se c'è un errore. Ti manda un messaggio quando un reminder scade.
Queste sono le **notifiche di OpenClaw**.
OpenClaw può inviarti avvisi in due modi principali:
1. **Annuncio (announce)** — quando un agente termina un compito, ti invia un messaggio.
2. **Webhook** — quando un evento accade, OpenClaw "spinge" i dati verso un servizio esterno.
## CANALI DI NOTIFICA: DOVE TI ARRIVANO GLI AVVISI?
OpenClaw supporta diversi canali. Ecco i più comuni:
- **Telegram** — perfetto per utenti singoli. Ricevi i messaggi direttamente in chat.
- **Discord** — ideale se hai un server con diversi topic. Puoi indirizzare le notifiche in canali specifici.
- **WhatsApp** — se hai un numero attivo, le notifiche arrivano come messaggi WhatsApp.
- **Email** — opzione meno comune, ma disponibile.
Ogni canale ha un **topic o thread** a cui puoi inviare notifiche specifiche. Ad esempio: su Discord puoi creare un canale "#avvisi-agente" e inviare solo quelle lì.
## COME CONFIGURARE UN AVVISO BASE
Supponiamo di voler avvisare su Telegram ogni volta che un cron job termina.
Ecco cosa serve:
1. **Un canale Telegram già configurato** — lo configuri nella sezione "channels" del gateway.
2. **Un job con delivery mode "announce"** — quando il job termina, OpenClaw avvisa sul canale.
Esempio pratico di configurazione:
```yaml
jobs:
- name: "controllo-metea"
schedule:
kind: "cron"
expr: "0 8 * * *"
payload:
kind: "agentTurn"
message: "Controllo il meteo di Roma"
delivery:
mode: "announce"
channel: "telegram"
to: "davide"
```
Spiegazione pezzo per pezzo:
- `name`: il nome del job, serve a te per riconoscerlo.
- `schedule.kind: "cron"`: significa che usa un scheduler a orologio.
- `expr: "0 8 * * *"`: tutte le mattine alle 8:00.
- `payload.kind: "agentTurn"`: avvia un giro dell'agente.
- `delivery.mode: "announce"`: quando finisce, invia un annuncio.
- `channel: "telegram"`: invia su Telegram.
- `to: "davide"`: invia a te.
## NOTIFICHE DI FALLIMENTO: QUANDO LE COSE VANNO STORTE
Una delle funzionalità più utili è l'**alerting sui fallimenti**.
Se un job cron va in timeout, fallisce, o dà errore, OpenClaw può inviarti un avviso. Questo è fondamentale per non scoprire i problemi solo dopo giorni.
Per attivarlo, usi il campo `failureAlert`:
```yaml
delivery:
mode: "announce"
channel: "telegram"
to: "davide"
failureAlert:
mode: "announce"
channel: "telegram"
to: "davide"
after: 3
```
Spiegazione:
- `failureAlert.mode: "announce"`: attiva gli avvisi di fallimento.
- `after: 3`: invia un avviso solo dopo 3 tentativi falliti. Utile per non impazzire con errori transitori.
## WEBHOOK: NOTIFICHE AVANZATE
Se vuoi integrare OpenClaw con servizi esterni (come un bot personalizzato, un database, o un sistema di monitoraggio), puoi usare i **webhook**.
Un webhook è semplicemente una URL a cui OpenClaw invia i dati quando un evento accade.
Esempio:
```yaml
delivery:
mode: "webhook"
to: "https://iltuoservizio.com/webhook"
```
Quando il job termina (con successo o meno), OpenClaw fa una richiesta POST alla tua URL con i dettagli dell'evento.
## NOTIFICHE DI SYSTEM EVENT
OpenClaw può anche inviare **system events** — eventi di sistema che puoi usare per creare workflow complessi. Ad esempio: un heartbeat del gateway, un trigger di memoria, o un evento personalizzato.
I system events si configurano con `payload.kind: "systemEvent"`.
## BEST PRACTICE: 5 REGOLE PER LE TUE NOTIFICHE
1. **Non esagerare** — se avvisi per tutto, finisci per ignorare tutto. Usa `failureAlert.after` per filtrare i falsi positivi.
2. **Canali diversi per cose diverse** — su Telegram tieni le notifiche importanti, su Discord i reminder leggeri.
3. **Usa i thread** — su Discord, crea thread separati per job diversi. Ti aiuta a non perdere il contesto.
4. **Monitora i fallimenti** — attiva sempre `failureAlert`. Non fidarti della silenziosità.
5. **Testa prima di affidarti** — prima di contare sulle notifiche per cose critiche, fai test per verificare che arrivino.
## CONCLUSIONE
Le notifiche di OpenClaw sono potenti ma semplici. Una volta capito il meccanismo base (announce, webhook, failure alert), puoi configurarle in pochi minuti.
Il tuo agente AI non è solo un passivo esecutore di comandi: può **parlarti**, **avvisarti**, **tenerti informato**. Usalo.
---
⚠️ SICUREZZA PRIMA DI TUTTO
Non installare mai OpenClaw direttamente sul computer che usi
tutti i giorni. Usa sempre una macchina virtuale o un container
per isolare l'ambiente.
Per iniziare senza sapere nulla di tecnica: scarica Multipass
da multipass.run. Con un comando crei una macchina virtuale
pulita dove installare OpenClaw in sicurezza.
Se gia' sai usare Docker: crea un container e lavora li'.
Se non sai cos'e' Docker: usa Multipass, e' piu' semplice.
La regola e' una: OpenClaw su un computer isolato. Mai in
chiaro sul PC di tutti i giorni. La sicurezza informatica non
e' paranoia, e' buon senso.
Hai mai pensato: "Ma come faccio a sapere se il mio agente AI ha finito quello che ho chiesto?" Oppure: "E se il mio agente si blocca? Lo scopro solo dopo?"
La risposta è semplice: **OpenClaw ha un sistema di notifiche e avvisi** che può avvisarti su Telegram, Discord, WhatsApp e altri canali. In questo articolo ti spiego come funziona, senza tecnicismi.
## COSA SONO LE NOTIFICHE IN OPENCLAW?
Immagina di avere un assistente che lavora per te. Ti dice "ok, ho finito" quando termina un compito. Ti avvisa se c'è un errore. Ti manda un messaggio quando un reminder scade.
Queste sono le **notifiche di OpenClaw**.
OpenClaw può inviarti avvisi in due modi principali:
1. **Annuncio (announce)** — quando un agente termina un compito, ti invia un messaggio.
2. **Webhook** — quando un evento accade, OpenClaw "spinge" i dati verso un servizio esterno.
## CANALI DI NOTIFICA: DOVE TI ARRIVANO GLI AVVISI?
OpenClaw supporta diversi canali. Ecco i più comuni:
- **Telegram** — perfetto per utenti singoli. Ricevi i messaggi direttamente in chat.
- **Discord** — ideale se hai un server con diversi topic. Puoi indirizzare le notifiche in canali specifici.
- **WhatsApp** — se hai un numero attivo, le notifiche arrivano come messaggi WhatsApp.
- **Email** — opzione meno comune, ma disponibile.
Ogni canale ha un **topic o thread** a cui puoi inviare notifiche specifiche. Ad esempio: su Discord puoi creare un canale "#avvisi-agente" e inviare solo quelle lì.
## COME CONFIGURARE UN AVVISO BASE
Supponiamo di voler avvisare su Telegram ogni volta che un cron job termina.
Ecco cosa serve:
1. **Un canale Telegram già configurato** — lo configuri nella sezione "channels" del gateway.
2. **Un job con delivery mode "announce"** — quando il job termina, OpenClaw avvisa sul canale.
Esempio pratico di configurazione:
```yaml
jobs:
- name: "controllo-metea"
schedule:
kind: "cron"
expr: "0 8 * * *"
payload:
kind: "agentTurn"
message: "Controllo il meteo di Roma"
delivery:
mode: "announce"
channel: "telegram"
to: "davide"
```
Spiegazione pezzo per pezzo:
- `name`: il nome del job, serve a te per riconoscerlo.
- `schedule.kind: "cron"`: significa che usa un scheduler a orologio.
- `expr: "0 8 * * *"`: tutte le mattine alle 8:00.
- `payload.kind: "agentTurn"`: avvia un giro dell'agente.
- `delivery.mode: "announce"`: quando finisce, invia un annuncio.
- `channel: "telegram"`: invia su Telegram.
- `to: "davide"`: invia a te.
## NOTIFICHE DI FALLIMENTO: QUANDO LE COSE VANNO STORTE
Una delle funzionalità più utili è l'**alerting sui fallimenti**.
Se un job cron va in timeout, fallisce, o dà errore, OpenClaw può inviarti un avviso. Questo è fondamentale per non scoprire i problemi solo dopo giorni.
Per attivarlo, usi il campo `failureAlert`:
```yaml
delivery:
mode: "announce"
channel: "telegram"
to: "davide"
failureAlert:
mode: "announce"
channel: "telegram"
to: "davide"
after: 3
```
Spiegazione:
- `failureAlert.mode: "announce"`: attiva gli avvisi di fallimento.
- `after: 3`: invia un avviso solo dopo 3 tentativi falliti. Utile per non impazzire con errori transitori.
## WEBHOOK: NOTIFICHE AVANZATE
Se vuoi integrare OpenClaw con servizi esterni (come un bot personalizzato, un database, o un sistema di monitoraggio), puoi usare i **webhook**.
Un webhook è semplicemente una URL a cui OpenClaw invia i dati quando un evento accade.
Esempio:
```yaml
delivery:
mode: "webhook"
to: "https://iltuoservizio.com/webhook"
```
Quando il job termina (con successo o meno), OpenClaw fa una richiesta POST alla tua URL con i dettagli dell'evento.
## NOTIFICHE DI SYSTEM EVENT
OpenClaw può anche inviare **system events** — eventi di sistema che puoi usare per creare workflow complessi. Ad esempio: un heartbeat del gateway, un trigger di memoria, o un evento personalizzato.
I system events si configurano con `payload.kind: "systemEvent"`.
## BEST PRACTICE: 5 REGOLE PER LE TUE NOTIFICHE
1. **Non esagerare** — se avvisi per tutto, finisci per ignorare tutto. Usa `failureAlert.after` per filtrare i falsi positivi.
2. **Canali diversi per cose diverse** — su Telegram tieni le notifiche importanti, su Discord i reminder leggeri.
3. **Usa i thread** — su Discord, crea thread separati per job diversi. Ti aiuta a non perdere il contesto.
4. **Monitora i fallimenti** — attiva sempre `failureAlert`. Non fidarti della silenziosità.
5. **Testa prima di affidarti** — prima di contare sulle notifiche per cose critiche, fai test per verificare che arrivino.
## CONCLUSIONE
Le notifiche di OpenClaw sono potenti ma semplici. Una volta capito il meccanismo base (announce, webhook, failure alert), puoi configurarle in pochi minuti.
Il tuo agente AI non è solo un passivo esecutore di comandi: può **parlarti**, **avvisarti**, **tenerti informato**. Usalo.
---
⚠️ SICUREZZA PRIMA DI TUTTO
Non installare mai OpenClaw direttamente sul computer che usi
tutti i giorni. Usa sempre una macchina virtuale o un container
per isolare l'ambiente.
Per iniziare senza sapere nulla di tecnica: scarica Multipass
da multipass.run. Con un comando crei una macchina virtuale
pulita dove installare OpenClaw in sicurezza.
Se gia' sai usare Docker: crea un container e lavora li'.
Se non sai cos'e' Docker: usa Multipass, e' piu' semplice.
La regola e' una: OpenClaw su un computer isolato. Mai in
chiaro sul PC di tutti i giorni. La sicurezza informatica non
e' paranoia, e' buon senso.
Sent via AgentMail
Commenti
Posta un commento