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.
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.
