OpenClaw · posta elettronica in entrata

Arriva una email. Il tuo agente OpenClaw si sveglia.

Installa una competenza, fornisci all'agente una casella di posta gratuita e instrada la posta in entrata in un gateway dedicato con autenticazione basata solo sull'intestazione.

Prerequisito: un agente OpenClaw funzionante con un provider di modelli configurato · nessun polling · dominio personalizzato in seguito

OpenClaw · installazione corrente
$openclaw skills install @gwendall/domani
Installato · @gwendall/domani
$openclaw skills verify @gwendall/domani
Verificato · ultima versione
$npx domani-cli login --surface skill
Approvato · credenziale salvata nel portachiavi del sistema operativo

Il percorso dell'evento

L'attivazione del webhook sostituisce un ciclo di polling della posta in arrivo.

01

Arriva l'e-mail

Un messaggio arriva a agent@domani.run.

02

Domani si autentica

L'Authorization e la X-Domani-Signature accompagnano l'evento.

03

Mappe dei gateway

/hooks/domani-email trasforma il carico utile in un'attività dell'agente isolata.

04

L'agente agisce

OpenClaw può fornire la risposta finale al canale configurato.

Sondaggio

Letture ripetute, richieste inattive e ritardo impostato dall'intervallo di polling.

Webhook

Una spinta quando la posta viene elaborata; riconciliare la casella di posta memorizzata solo dopo un periodo di inattività del ricevitore.

1 · Ingresso del gateway

Mappare il payload di Domani in un'esecuzione dell'agente isolata.

Unisci questo in `~/.openclaw/openclaw.json`; preservare le impostazioni esistenti più rigorose. Inserisci due diversi valori casuali lunghi nell'ambiente Gateway o `~/.openclaw/.env`: `OPENCLAW_GATEWAY_TOKEN` per l'autenticazione del piano di controllo e `OPENCLAW_HOOK_TOKEN` per questo ingresso. Le esecuzioni di hook dell'agente sono isolate per impostazione predefinita. Riavviare dopo la convalida.

openclaw.json · unisci, non sostituisci
${ gateway: { mode: "local", bind: "loopback", auth: { mode: "token", token: "${OPENCLAW_GATEWAY_TOKEN}" } }, hooks: { enabled: true, token: "${OPENCLAW_HOOK_TOKEN}", path: "/hooks", allowRequestSessionKey: false, allowedAgentIds: ["main"], mappings: [{ match: { path: "domani-email" }, action: "agent", agentId: "main", wakeMode: "now", name: "Domani email", messageTemplate: "New email for {{email}}\nFrom: {{message.from}}\nSubject: {{message.subject}}\n\n{{message.text}}", deliver: true, channel: "last" }] } }

Gettone dedicato

Utilizza un valore casuale lungo e non riutilizzare OPENCLAW_GATEWAY_TOKEN. OpenClaw segnala il riutilizzo come risultato critico per la sicurezza.

Esposizione affidabile

Mantieni il gateway limitato al loopback ed esponi l’hook tramite HTTPS usando una tailnet o un proxy inverso attendibile. Configura trustedProxies con gli IP esatti dei proxy, quando applicabile.

Agente limitato

Tratta la posta elettronica come input non attendibile. Utilizza una policy per gli strumenti limitati e mantieni disabilitate le esclusioni dei contenuti non sicuri.

Riferimento ufficiale al webhook OpenClawConfigurazione di sicurezza ufficiale

2 · Casella di posta Domani

Passa il token tramite variabile di ambiente, quindi dimostra la consegna.

Utilizza il modulo HTTPS raggiungibile esternamente del tuo hook mappato. Il prompt nascosto mantiene il valore portatore fuori dalla cronologia della shell e la CLI lo legge senza stamparlo.

Domani CLI · segreto sicuro
$read -rsp 'OpenClaw hook token: ' OPENCLAW_HOOK_TOKEN; echo
$export OPENCLAW_HOOK_AUTH="Bearer $OPENCLAW_HOOK_TOKEN"
$domani email webhook agent@domani.run --url 'https://YOUR_GATEWAY/hooks/domani-email' --authorization-env OPENCLAW_HOOK_AUTH
Webhook configurato · Authorization
$domani email webhook-test agent@domani.run
Test consegnato · HTTP 200
$unset OPENCLAW_HOOK_TOKEN OPENCLAW_HOOK_AUTH

Prova prima

Richiedi un risultato 2xx prima di inviare posta in tempo reale.

Vivi secondo

Invia un'e-mail reale e conferma che venga avviata esattamente un'attività isolata.

Riconciliarsi dopo i tempi di inattività

Le richiamate alle caselle postali live vengono tentate fino a tre volte. Leggi comunque la posta in arrivo archiviata dopo tempi di inattività del gateway più lunghi perché la consegna del webhook avviene almeno una volta e le finestre di ripetizione dei tentativi sono limitate.

Risoluzione dei problemi

Quattro confini da controllare.

401 / 429Controlla il token hook dedicato. I limiti di velocità di OpenClaw ripetono errori di autenticazione; attendere Retry-After invece di riprovare più duramente.
404Conferma hooks.enabled, hooks.path e il percorso di mappatura. L'URL Domani deve terminare con /hooks/domani-email per questo esempio.
TimeoutAccettazione del reso prima del lungo lavoro dell'agente. Il test di Domani prevede un timeout del ricevitore di 10 secondi.
L'agente non viene eseguitoConvalida la configurazione, riavvia il gateway, verifica allowedAgentIds, quindi controlla i log del gateway per individuare rifiuti di mappatura o della policy del modello.

Il test Domani dimostra che il Gateway ha accettato l'evento HTTP. Non misura il tempo di completamento del modello downstream.

Primo risultato

Crea la casella di posta. Prova il gancio. Invia l'e-mail.

Mantieni la decisione sul dominio personalizzato per dopo il funzionamento del ciclo di eventi.

Integrazione della comunità utilizzando le interfacce documentate OpenClaw e Domani.

API webhook DomaniScheda ClawHub