openclaw webhooks
Webhook 辅助工具，当前主要支持 Gmail Pub/Sub 流程，与内置 gog watcher 集成。
子命令
openclaw webhooks gmail setup --account <email> [...]
openclaw webhooks gmail run [--account <email>] [...]
webhooks gmail setup
配置 Gmail watch、Pub/Sub topic/subscription 和 OpenClaw webhook 投递目标。
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
必填参数
| 参数 | 说明 |
|---|
--account <email> | 要监听的 Gmail 账号 |
Pub/Sub 选项
| 参数 | 默认值 | 说明 |
|---|
--project <id> | — | GCP 项目 id |
--topic <name> | gog-gmail-watch | Pub/Sub topic 名称 |
--subscription <name> | gog-gmail-watch-push | Pub/Sub subscription 名称 |
--label <label> | INBOX | 监听的 Gmail 标签 |
--push-endpoint <url> | — | 显式 Pub/Sub push endpoint（覆盖 Tailscale） |
OpenClaw 投递选项
| 参数 | 说明 |
|---|
--hook-url <url> | OpenClaw webhook URL |
--hook-token <token> | OpenClaw webhook token |
--push-token <token> | 转发给 gog watch serve 的 push token |
gog watch serve 选项
| 参数 | 默认值 | 说明 |
|---|
--bind <host> | 127.0.0.1 | 绑定主机 |
--port <port> | 8788 | 端口 |
--path <path> | /gmail-pubsub | 路径 |
--include-body | true | 包含邮件正文片段 |
--max-bytes <n> | 20000 | 正文片段最大字节数 |
--renew-minutes <n> | 720（12h） | Gmail watch 续期间隔 |
Tailscale 暴露
| 参数 | 默认值 | 说明 |
|---|
--tailscale <mode> | funnel | funnel、serve 或 off |
--tailscale-path <path> | — | Tailscale serve/funnel 路径 |
--tailscale-target <t> | — | Tailscale serve/funnel 目标 |
webhooks gmail run
在前台运行 gog watch serve 和 watch 自动续期循环。
openclaw webhooks gmail run --account you@example.com
与 setup 的区别：
--account 可选（回退到已配置账号）- 不接受
--project、--push-endpoint、--json
- 缺失的参数值回退到
setup 写入的配置
相关链接
- cli-voicecall — 语音通话 Webhook 配置
- docs/automation/webhook — Webhook 自动化概念