openclaw/docs/cli/webhooks.md

summary, read_when, title

summary	read_when	title
CLI reference for `openclaw webhooks` (webhook helpers + Gmail Pub/Sub)	You want to wire Gmail Pub/Sub events into OpenClaw You want webhook helper commands	webhooks

openclaw webhooks

Webhook helpers and integrations (Gmail Pub/Sub, webhook helpers).

Related:

• Webhooks: Webhooks
• Gmail Pub/Sub: Gmail Pub/Sub

Gmail

openclaw webhooks gmail setup --account you@example.com
openclaw webhooks gmail run

webhooks gmail setup

Configure Gmail watch, Pub/Sub, and OpenClaw webhook delivery.

Required:

• --account <email>

Options:

• --project <id>
• --topic <name>
• --subscription <name>
• --label <label>
• --hook-url <url>
• --hook-token <token>
• --push-token <token>
• --bind <host>
• --port <port>
• --path <path>
• --include-body
• --max-bytes <n>
• --renew-minutes <n>
• --tailscale <funnel|serve|off>
• --tailscale-path <path>
• --tailscale-target <target>
• --push-endpoint <url>
• --json

Examples:

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

webhooks gmail run

Run gog watch serve plus the watch auto-renew loop.

Options:

• --account <email>
• --topic <topic>
• --subscription <name>
• --label <label>
• --hook-url <url>
• --hook-token <token>
• --push-token <token>
• --bind <host>
• --port <port>
• --path <path>
• --include-body
• --max-bytes <n>
• --renew-minutes <n>
• --tailscale <funnel|serve|off>
• --tailscale-path <path>
• --tailscale-target <target>

Example:

openclaw webhooks gmail run --account you@example.com

See Gmail Pub/Sub documentation for the end-to-end setup flow and operational details.