Passer au contenu principal

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

openclaw webhooks

Assistants et intégrations Webhook. Aujourd’hui, cette surface est limitée aux flux Gmail Pub/Sub qui s’intègrent à l’observateur gog intégré.

Sous-commandes

openclaw webhooks gmail setup --account <email> [...]
openclaw webhooks gmail run   [--account <email>] [...]
Sous-commandeDescription
gmail setupConfigurer la surveillance Gmail, le sujet/l’abonnement Pub/Sub et la cible de livraison Webhook OpenClaw.
gmail runExécuter gog watch serve plus la boucle de renouvellement automatique de la surveillance.

webhooks gmail setup

Configurer la surveillance Gmail, Pub/Sub et la livraison Webhook OpenClaw.
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

Requis

OptionDescription
--account <email>Compte Gmail à surveiller.

Options Pub/Sub

OptionValeur par défautDescription
--project <id>(aucune)ID du 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>(aucune)Point de terminaison push Pub/Sub explicite. Remplace Tailscale.

Options de livraison OpenClaw

OptionValeur par défautDescription
--hook-url <url>(aucune)URL Webhook OpenClaw.
--hook-token <token>(aucune)Jeton Webhook OpenClaw.
--push-token <token>(aucune)Jeton push transmis à gog watch serve.

Options gog watch serve

OptionValeur par défautDescription
--bind <host>127.0.0.1Hôte de liaison de gog watch serve.
--port <port>8788Port de gog watch serve.
--path <path>/gmail-pubsubChemin de gog watch serve.
--include-bodytrueInclure les extraits du corps des e-mails. Passez --no-include-body pour désactiver.
--max-bytes <n>20000Nombre maximal d’octets par extrait de corps.
--renew-minutes <n>720 (12h)Renouveler la surveillance Gmail toutes les N minutes.

Exposition Tailscale

OptionValeur par défautDescription
--tailscale <mode>funnelExposer le point de terminaison push via Tailscale : funnel, serve ou off.
--tailscale-path <path>(aucune)Chemin pour Tailscale serve/funnel.
--tailscale-target <t>(aucune)Cible Tailscale serve/funnel (port, host:port ou URL).

Sortie

OptionDescription
--jsonAfficher un résumé lisible par machine au lieu de texte.

webhooks gmail run

Exécuter gog watch serve plus la boucle de renouvellement automatique de la surveillance au premier plan.
openclaw webhooks gmail run --account you@example.com
run accepte les mêmes options gog watch serve, de livraison OpenClaw, Pub/Sub et Tailscale que setup, sauf :
  • --account est facultatif sur run (il revient au compte configuré).
  • run n’accepte pas --project, --push-endpoint ni --json.
  • Les options de run n’ont pas de valeurs par défaut intégrées ; les valeurs manquantes reviennent aux valeurs écrites par setup.
CatégorieOptions
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
Pour run, la valeur --topic est le chemin complet du sujet Pub/Sub (projects/.../topics/...), et pas seulement le nom court du sujet.

Flux de bout en bout

Consultez l’intégration Gmail Pub/Sub pour la configuration du projet GCP, d’OAuth et côté Gateway qui va avec ces commandes CLI.

Connexe