Installe gcloud et gog s’ils sont absents, authentifie gcloud, crée le sujet et l’abonnement Pub/Sub, démarre la surveillance Gmail et écrit la configuration hooks.gmail avec hooks.enabled=true. Affiche Next: openclaw webhooks gmail run.
Obligatoire
Option
Description
--account <email>
Compte Gmail à surveiller.
Options Pub/Sub
Option
Valeur par défaut
Description
--project <id>
(aucune)
Identifiant du projet GCP (propriétaire du client OAuth). Utilise à défaut l’identifiant du projet propre au sujet, puis le projet déterminé à partir des identifiants gog.
--topic <name>
gog-gmail-watch
Nom du sujet Pub/Sub.
--subscription <name>
gog-gmail-watch-push
Nom de l’abonnement Pub/Sub.
--label <label>
INBOX
Libellé Gmail à surveiller.
--push-endpoint <url>
(aucune)
Point de terminaison push Pub/Sub explicite. Remplace Tailscale.
Options de transmission à OpenClaw
Option
Valeur par défaut
Description
--hook-url <url>
Construite à partir de hooks.path et du port du Gateway
URL du Webhook OpenClaw.
--hook-token <token>
hooks.token, ou un jeton généré
Jeton du Webhook OpenClaw.
--push-token <token>
Jeton généré
Jeton push transmis à gog watch serve.
Options de gog watch serve
Option
Valeur par défaut
Description
--bind <host>
127.0.0.1
Hôte d’écoute de gog watch serve.
--port <port>
8788
Port de gog watch serve.
--path <path>
/gmail-pubsub
Chemin de gog watch serve. Forcé à / lorsque Tailscale est activé sans cible explicite, car Tailscale supprime le chemin avant d’effectuer le proxy.
--include-body
true
Inclut des extraits du corps des e-mails. Aucune option de CLI ne permet de désactiver cette fonctionnalité ; définissez plutôt hooks.gmail.includeBody: false dans la configuration.
--max-bytes <n>
20000
Nombre maximal d’octets par extrait de corps.
--renew-minutes <n>
720 (12 h)
Renouvelle la surveillance Gmail toutes les N minutes.
Exposition via Tailscale
Option
Valeur par défaut
Description
--tailscale <mode>
funnel
Expose le point de terminaison push via Tailscale : funnel, serve ou off.
--tailscale-path <path>
(aucune)
Chemin pour le mode serve/funnel de Tailscale.
--tailscale-target <t>
(aucune)
Cible serve/funnel de Tailscale (port, host:port ou URL).
Sortie
Option
Description
--json
Affiche un résumé lisible par une machine plutôt que du texte.
webhooks gmail run
bash
openclaw webhooks gmail run --account you@example.com
Exécute gog watch serve et la boucle de renouvellement automatique de la surveillance au premier plan, en redémarrant gog watch serve après un délai de 2 s s’il s’arrête de manière inattendue.
run accepte les mêmes options Pub/Sub, de transmission à OpenClaw, de gog watch serve et de Tailscale que setup, à l’exception des points suivants :
--account est facultatif avec run ; sa valeur provient par défaut de hooks.gmail.account.
run n’accepte pas--project, --push-endpoint ni --json.
Chaque option utilise par défaut la valeur de configuration hooks.gmail.* correspondante (écrite par setup), puis la même valeur par défaut intégrée que celle utilisée par setup, à une exception près : avec run, --tailscale utilise par défaut off (et non funnel) lorsque ni l’option ni hooks.gmail.tailscale.mode ne sont définis.
