OpenClaw Delivery e Wake Events: come il tuo agente AI sa quando parlarti (e quando zittirsi)
# OpenClaw Delivery e Wake Events: come il tuo agente AI sa quando parlarti (e quando zittirsi)
Hai presente quando un assistente ti disturba sempre? Ti manda messaggi alle 3 di notte. Ti interrompe mentre mangi. Non smette mai.
Con OpenClaw questo non succede. E la ragione è semplice: **Delivery** e **Wake Events**.
Due parole che suonano tecniche, ma che in realtà sono la cosa più naturale del mondo. Te lo spiego io, senza gergo.
---
## COSA SONO I WAKE EVENT (IN PAROLE SEMPLICI)
Immagina di avere un gatto. Il gatto dorme. Ma se apri una confezione di croccantini, il gatto si sveglia di colpo.
Il **wake event** di OpenClaw funziona così. È un "svegliamatti" per il tuo agente AI.
Senza wake event, l'agente aspetta il prossimo controllo automatico (il heartbeat). Con il wake event, puoi dirgli: **"Sveglia, ho bisogno di te ORA"**.
È come un campanello. Lo premi, lui si presenta.
---
## I TRE MODI DI CONSEGNA (DELIVERY MODE)
Quando il tuo agente AI completa un compito — che sia un promemoria, un controllo automatico, o un lavoro in background — deve decidere **cosa fare con il risultato**.
Qui entrano in gioco i tre delivery mode:
### 1. ANNOUNCE (il più usato)
**Announce** significa: "Racconta al mio canale di chat cosa hai fatto."
Esempio pratico: imposti un promemoria per le 14:00. Quando scatta, OpenClaw ti manda un messaggio su Telegram (o WhatsApp, o dove preferisci) con dentro il risultato.
È il default. Funziona così: l'agente fa il suo lavoro, poi ti dice "Ecco fatto!" nel canale che usi normalmente.
### 2. WEBHOOK (per chi vuole integrare)
**Webhook** significa: "Non mandarmi un messaggio. Invece, invia il risultato a un altro sito web o servizio."
Pensa a un webhook come a un postino automatizzato. Quando il lavoro è finito, OpenClaw apre una busta e la consegna a un indirizzo specifico — per esempio un server che registra dati, o un altro software che deve ricevere l'informazione.
Non serve per principianti. Ma se un giorno vorrai collegare OpenClaw al tuo sito o al tuo sistema aziendale, il webhook è la strada.
### 3. NONE (silenzio totale)
**None** significa: "Fai il lavoro, ma non dirmi nulla."
Sembra strano, vero? Invece è utilissimo.
Esempio: vuoi che OpenClaw controlli qualcosa ogni ora (tipo lo stato di un server, o una pagina web). Se il risultato è "tutto ok", non serve che ti mandi un messaggio ogni volta. Usi `none` e l'agente lavora in silenzio.
Se invece qualcosa va storto, puoi configurare un alert separato che ti avvisa solo in quel caso.
---
## COMBINAZIONE VINCENTE: WAKE MODE + DELIVERY MODE
Quando crei un job (un compito programmato) in OpenClaw, puoi scegliere due cose indipendenti:
- **WAKE MODE**: quando svegliare l'agente (`next-heartbeat` o `now`)
- **DELIVERY MODE**: cosa fare con il risultato (`announce`, `webhook`, o `none`)
Esempio reale:
> Vuoi che OpenClaw faccia un controllo ogni mattina alle 8:00 e ti mandi il risultato su Telegram.
>
> - Schedule: cron alle 8:00 ogni giorno
> - Wake mode: `next-heartbeat` (si sveglia al prossimo controllo regolare, senza sovraccaricare il sistema)
> - Delivery mode: `announce` (ti manda il risultato in chat)
Oppure:
> Vuoi che OpenClaw faccia un controllo immediato E ti avvisi subito.
>
> - Schedule: one-shot per adesso
> - Wake mode: `now` (sveglia immediata)
> - Delivery mode: `announce` (risultato in chat)
---
## PERCHÉ QUESTO CONTA (davvero)
La maggior parte degli assistenti AI è rumorosa. Ti mandano notifiche ovunque, sempre.
OpenClaw ti dà il controllo. Decidi TU quando l'agente parla, quando lavora in silenzio, e dove manda i risultati.
È la differenza tra un assistente che ti infastidisce e uno che ti aiuta senza disturbare.
---
## COME SI USA NELLA PRATICA
In OpenClaw, i wake event e i delivery mode si gestiscono principalmente attraverso il comando `cron`. Non serve scrivere codice.
Per creare un promemoria che si sveglia subito e ti avvisa in chat:
```bash
openclaw cron add --name "Promemoria" \
--at "2026-07-15T15:00:00Z" \
--system-event "Ricordati di controllare l'email" \
--wake now
```
Spiegazione pezzo per pezzo:
- `openclaw cron add` → "aggiungi un nuovo compito programmato"
- `--name "Promemoria"` → dai un nome al compito (per ritrovarlo dopo)
- `--at "2026-07-15T15:00:00Z"` → quando farlo partire (in formato data/ora)
- `--system-event "..."` → cosa dire all'agente quando si sveglia
- `--wake now` → sveglialo subito, non aspettare il prossimo controllo
Per vedere tutti i tuoi compiti programmati:
```bash
openclaw cron list
```
Semplice. Pulito. Funziona.
---
## IN SINTESI
| Concetto | Cosa significa | Analogia |
|---|---|---|
| Wake Event | Svegliare l'agente | Campanello della porta |
| Wake Mode: `now` | Svegliato subito | Bussata alla porta |
| Wake Mode: `next-heartbeat` | Svegliato al prossimo controllo | Campanello al prossimo giro |
| Delivery: `announce` | Risultato in chat | Messaggio vocale |
| Delivery: `webhook` | Risultato inviato a un URL | Email a un indirizzo |
| Delivery: `none` | Nessun messaggio | Lavoro fatto in silenzio |
Se ricordi solo questa cosa: **OpenClaw decide quando parlare e come consegnare il risultato**. Tutto il resto è dettaglio.
---
⚠️ 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 presente quando un assistente ti disturba sempre? Ti manda messaggi alle 3 di notte. Ti interrompe mentre mangi. Non smette mai.
Con OpenClaw questo non succede. E la ragione è semplice: **Delivery** e **Wake Events**.
Due parole che suonano tecniche, ma che in realtà sono la cosa più naturale del mondo. Te lo spiego io, senza gergo.
---
## COSA SONO I WAKE EVENT (IN PAROLE SEMPLICI)
Immagina di avere un gatto. Il gatto dorme. Ma se apri una confezione di croccantini, il gatto si sveglia di colpo.
Il **wake event** di OpenClaw funziona così. È un "svegliamatti" per il tuo agente AI.
Senza wake event, l'agente aspetta il prossimo controllo automatico (il heartbeat). Con il wake event, puoi dirgli: **"Sveglia, ho bisogno di te ORA"**.
È come un campanello. Lo premi, lui si presenta.
---
## I TRE MODI DI CONSEGNA (DELIVERY MODE)
Quando il tuo agente AI completa un compito — che sia un promemoria, un controllo automatico, o un lavoro in background — deve decidere **cosa fare con il risultato**.
Qui entrano in gioco i tre delivery mode:
### 1. ANNOUNCE (il più usato)
**Announce** significa: "Racconta al mio canale di chat cosa hai fatto."
Esempio pratico: imposti un promemoria per le 14:00. Quando scatta, OpenClaw ti manda un messaggio su Telegram (o WhatsApp, o dove preferisci) con dentro il risultato.
È il default. Funziona così: l'agente fa il suo lavoro, poi ti dice "Ecco fatto!" nel canale che usi normalmente.
### 2. WEBHOOK (per chi vuole integrare)
**Webhook** significa: "Non mandarmi un messaggio. Invece, invia il risultato a un altro sito web o servizio."
Pensa a un webhook come a un postino automatizzato. Quando il lavoro è finito, OpenClaw apre una busta e la consegna a un indirizzo specifico — per esempio un server che registra dati, o un altro software che deve ricevere l'informazione.
Non serve per principianti. Ma se un giorno vorrai collegare OpenClaw al tuo sito o al tuo sistema aziendale, il webhook è la strada.
### 3. NONE (silenzio totale)
**None** significa: "Fai il lavoro, ma non dirmi nulla."
Sembra strano, vero? Invece è utilissimo.
Esempio: vuoi che OpenClaw controlli qualcosa ogni ora (tipo lo stato di un server, o una pagina web). Se il risultato è "tutto ok", non serve che ti mandi un messaggio ogni volta. Usi `none` e l'agente lavora in silenzio.
Se invece qualcosa va storto, puoi configurare un alert separato che ti avvisa solo in quel caso.
---
## COMBINAZIONE VINCENTE: WAKE MODE + DELIVERY MODE
Quando crei un job (un compito programmato) in OpenClaw, puoi scegliere due cose indipendenti:
- **WAKE MODE**: quando svegliare l'agente (`next-heartbeat` o `now`)
- **DELIVERY MODE**: cosa fare con il risultato (`announce`, `webhook`, o `none`)
Esempio reale:
> Vuoi che OpenClaw faccia un controllo ogni mattina alle 8:00 e ti mandi il risultato su Telegram.
>
> - Schedule: cron alle 8:00 ogni giorno
> - Wake mode: `next-heartbeat` (si sveglia al prossimo controllo regolare, senza sovraccaricare il sistema)
> - Delivery mode: `announce` (ti manda il risultato in chat)
Oppure:
> Vuoi che OpenClaw faccia un controllo immediato E ti avvisi subito.
>
> - Schedule: one-shot per adesso
> - Wake mode: `now` (sveglia immediata)
> - Delivery mode: `announce` (risultato in chat)
---
## PERCHÉ QUESTO CONTA (davvero)
La maggior parte degli assistenti AI è rumorosa. Ti mandano notifiche ovunque, sempre.
OpenClaw ti dà il controllo. Decidi TU quando l'agente parla, quando lavora in silenzio, e dove manda i risultati.
È la differenza tra un assistente che ti infastidisce e uno che ti aiuta senza disturbare.
---
## COME SI USA NELLA PRATICA
In OpenClaw, i wake event e i delivery mode si gestiscono principalmente attraverso il comando `cron`. Non serve scrivere codice.
Per creare un promemoria che si sveglia subito e ti avvisa in chat:
```bash
openclaw cron add --name "Promemoria" \
--at "2026-07-15T15:00:00Z" \
--system-event "Ricordati di controllare l'email" \
--wake now
```
Spiegazione pezzo per pezzo:
- `openclaw cron add` → "aggiungi un nuovo compito programmato"
- `--name "Promemoria"` → dai un nome al compito (per ritrovarlo dopo)
- `--at "2026-07-15T15:00:00Z"` → quando farlo partire (in formato data/ora)
- `--system-event "..."` → cosa dire all'agente quando si sveglia
- `--wake now` → sveglialo subito, non aspettare il prossimo controllo
Per vedere tutti i tuoi compiti programmati:
```bash
openclaw cron list
```
Semplice. Pulito. Funziona.
---
## IN SINTESI
| Concetto | Cosa significa | Analogia |
|---|---|---|
| Wake Event | Svegliare l'agente | Campanello della porta |
| Wake Mode: `now` | Svegliato subito | Bussata alla porta |
| Wake Mode: `next-heartbeat` | Svegliato al prossimo controllo | Campanello al prossimo giro |
| Delivery: `announce` | Risultato in chat | Messaggio vocale |
| Delivery: `webhook` | Risultato inviato a un URL | Email a un indirizzo |
| Delivery: `none` | Nessun messaggio | Lavoro fatto in silenzio |
Se ricordi solo questa cosa: **OpenClaw decide quando parlare e come consegnare il risultato**. Tutto il resto è dettaglio.
---
⚠️ 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