`openclaw webhooks`

Assistants et intégrations Webhook. Actuellement, cette interface est limitée aux flux Gmail Pub/Sub reposant sur l’observateur gog intégré.

Sous-commandes

openclaw webhooks gmail setup --account <email> [...]
openclaw webhooks gmail run   [--account <email>] [...]

Sous-commande	Description
`gmail setup`	Assistant de configuration initiale : surveillance Gmail, sujet/abonnement Pub/Sub et transmission au hook OpenClaw.
`gmail run`	Exécute `gog watch serve` et la boucle de renouvellement automatique de la surveillance au premier plan.

Le Gateway démarre également automatiquement gog gmail watch serve au démarrage lorsque hooks.enabled=true et que hooks.gmail.account est défini (par gmail setup). gmail run exécute la même logique au premier plan, ce qui est utile pour le débogage ou lorsque l’observateur du Gateway est désactivé. Consultez Intégration Gmail Pub/Sub pour plus de détails sur le démarrage automatique et sur OPENCLAW_SKIP_GMAIL_WATCHER, qui permet de le désactiver.

`webhooks gmail setup`

openclaw webhooks gmail setup --account you@example.com
openclaw webhooks gmail setup --account you@example.com --project my-gcp-project --json
openclaw webhooks gmail setup --account you@example.com --hook-url https://gateway.example.com/hooks/gmail

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`

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.

Catégorie	Options
Pub/Sub	`--account`, `--topic`, `--subscription`, `--label`
Transmission à OpenClaw	`--hook-url`, `--hook-token`, `--push-token`
`gog watch serve`	`--bind`, `--port`, `--path`, `--include-body`, `--max-bytes`, `--renew-minutes`
Tailscale	`--tailscale`, `--tailscale-path`, `--tailscale-target`

Avec run, la valeur de --topic est le chemin complet du sujet Pub/Sub (projects/.../topics/...), et non simplement son nom court.

CLI commands

RPC and API

Codex harness

Plugin reference

Plugin SDK reference

Plugin maintainer reference

Templates

Technical reference

Concept internals

Project

Contributing

Webhooks

`openclaw webhooks`

Sous-commandes

`webhooks gmail setup`

Obligatoire

Options Pub/Sub

Options de transmission à OpenClaw

Options de `gog watch serve`

Exposition via Tailscale

Sortie

`webhooks gmail run`

Voir aussi

​openclaw webhooks

​Sous-commandes

​webhooks gmail setup

​Obligatoire

​Options Pub/Sub

​Options de transmission à OpenClaw

​Options de gog watch serve

​Exposition via Tailscale

​Sortie

​webhooks gmail run

​Voir aussi

`openclaw webhooks`

Sous-commandes

`webhooks gmail setup`

Obligatoire

Options Pub/Sub

Options de transmission à OpenClaw

Options de `gog watch serve`

Exposition via Tailscale

Sortie

`webhooks gmail run`

Voir aussi