Installa gcloud e gog se mancanti, autentica gcloud, crea l'argomento e la sottoscrizione Pub/Sub, avvia il monitoraggio di Gmail e scrive la configurazione hooks.gmail con hooks.enabled=true. Visualizza Avanti: openclaw webhooks gmail run.
Obbligatorio
Opzione
Descrizione
--account <email>
Account Gmail da monitorare.
Opzioni Pub/Sub
Opzione
Valore predefinito
Descrizione
--project <id>
(nessuno)
ID del progetto GCP (proprietario del client OAuth). In alternativa usa l'ID del progetto dell'argomento, quindi il progetto ricavato dalle credenziali di gog.
--topic <name>
gog-gmail-watch
Nome dell'argomento Pub/Sub.
--subscription <name>
gog-gmail-watch-push
Nome della sottoscrizione Pub/Sub.
--label <label>
INBOX
Etichetta Gmail da monitorare.
--push-endpoint <url>
(nessuno)
Endpoint push Pub/Sub esplicito. Ha la precedenza su Tailscale.
Opzioni di recapito di OpenClaw
Opzione
Valore predefinito
Descrizione
--hook-url <url>
Generato da hooks.path e dalla porta del Gateway
URL del Webhook di OpenClaw.
--hook-token <token>
hooks.token o un token generato
Token del Webhook di OpenClaw.
--push-token <token>
Token generato
Token push inoltrato a gog watch serve.
Opzioni di gog watch serve
Opzione
Valore predefinito
Descrizione
--bind <host>
127.0.0.1
Host di associazione di gog watch serve.
--port <port>
8788
Porta di gog watch serve.
--path <path>
/gmail-pubsub
Percorso di gog watch serve. Viene forzato a / quando Tailscale è abilitato senza una destinazione esplicita, poiché Tailscale rimuove il percorso prima di inoltrare tramite proxy.
--include-body
true
Include estratti del corpo delle email. Non esiste un'opzione CLI per disabilitarlo; imposta invece hooks.gmail.includeBody: false nella configurazione.
--max-bytes <n>
20000
Numero massimo di byte per estratto del corpo.
--renew-minutes <n>
720 (12 h)
Rinnova il monitoraggio di Gmail ogni N minuti.
Esposizione tramite Tailscale
Opzione
Valore predefinito
Descrizione
--tailscale <mode>
funnel
Espone l'endpoint push tramite Tailscale: funnel, serve oppure off.
--tailscale-path <path>
(nessuno)
Percorso per serve/funnel di Tailscale.
--tailscale-target <t>
(nessuno)
Destinazione serve/funnel di Tailscale (porta, host:port oppure URL).
Output
Opzione
Descrizione
--json
Visualizza un riepilogo leggibile da una macchina anziché testo.
webhooks gmail run
bash
openclaw webhooks gmail run --account you@example.com
Esegue gog watch serve insieme al ciclo di rinnovo automatico del monitoraggio in primo piano, riavviando gog watch serve dopo un ritardo di 2 s se termina in modo imprevisto.
run accetta le stesse opzioni Pub/Sub, di recapito di OpenClaw, di gog watch serve e di Tailscale di setup, con le seguenti eccezioni:
--account è facoltativo per run; in sua assenza viene usato hooks.gmail.account.
runnon accetta --project, --push-endpoint o --json.
Ogni opzione usa in alternativa il valore di configurazione hooks.gmail.* corrispondente (scritto da setup), quindi lo stesso valore predefinito integrato usato da setup, con un'eccezione: per run, il valore predefinito di --tailscale è off (non funnel) quando non sono impostati né l'opzione né hooks.gmail.tailscale.mode.
