Aller au contenu

Webhooks

Helpers et intégrations pour les webhooks. Actuellement, cette surface est limitée aux flux Gmail Pub/Sub qui s’intègrent à l’observateur gog inclus.

Fenêtre de terminal
openclaw webhooks gmail setup --account <email> [...]
openclaw webhooks gmail run [--account <email>] [...]
Sous-commandeDescription
gmail setupConfigurer la surveillance Gmail, le sujet/abonnement Pub/Sub et la cible de livraison webhook OpenClaw.
gmail runExécuter gog watch serve ainsi que la boucle de renouvellement automatique de la surveillance.

Configurer la surveillance Gmail, Pub/Sub et la livraison webhook OpenClaw.

Fenêtre de terminal
openclaw webhooks gmail setup --account [email protected]
openclaw webhooks gmail setup --account [email protected] --project my-gcp-project --json
openclaw webhooks gmail setup --account [email protected] --hook-url https://gateway.example.com/hooks/gmail
ParamètreDescription
--account <email>Compte Gmail à surveiller.
ParamètrePar défautDescription
--project <id>(aucun)ID de projet GCP (le propriétaire du client OAuth).
--topic <name>gog-gmail-watchNom du sujet Pub/Sub.
--subscription <name>gog-gmail-watch-pushNom de l’abonnement Pub/Sub.
--label <label>INBOXLibellé Gmail à surveiller.
--push-endpoint <url>(aucun)Point de terminaison push Pub/Sub explicite. Remplace Tailscale.
ParamètrePar défautDescription
--hook-url <url>(aucun)URL du webhook OpenClaw.
--hook-token <token>(aucun)Jeton du webhook OpenClaw.
--push-token <token>(aucun)Jeton push transféré à gog watch serve.
ParamètrePar défautDescription
--bind <host>127.0.0.1Hôte de liaison gog watch serve.
--port <port>8788Port gog watch serve.
--path <path>/gmail-pubsubChemin gog watch serve.
--include-bodytrueInclure des extraits du corps des e-mails. Passez --no-include-body pour désactiver.
--max-bytes <n>20000Octets maximum par extrait de corps.
--renew-minutes <n>720 (12h)Renouveler la surveillance Gmail toutes les N minutes.
FlagPar défautDescription
--tailscale <mode>funnelExposer le point de terminaison push via tailscale : funnel, serve, ou off.
--tailscale-path <path>(aucun)Chemin pour tailscale serve/funnel.
--tailscale-target <t>(aucun)Cible Tailscale serve/funnel (port, host:port, ou URL).
FlagDescription
--jsonImprimer un résumé lisible par machine au lieu du texte.

Exécuter gog watch serve plus la boucle de renouvellement automatique de la surveillance au premier plan.

Fenêtre de terminal
openclaw webhooks gmail run --account [email protected]

run accepte les mêmes drapeaux gog watch serve, de livraison OpenClaw, Pub/Sub et Tailscale que setup, excepté :

  • --account est optionnel sur run (il revient au compte configuré).
  • run n’accepte pas --project, --push-endpoint, ou --json.
  • Les drapeaux run n’ont pas de valeurs par défaut intégrées ; les valeurs manquantes reviennent aux valeurs écrites par setup.
CatégorieDrapeaux
Pub/Sub--account, --topic, --subscription, --label
Livraison 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

Voir Intégration Gmail Pub/Sub pour le projet GCP, OAuth et la configuration côté passerelle qui s’associent à ces commandes CLI.