openclaw webhooks
Webhook 辅助工具和集成。当前此功能范围仅限于与内置 gog watcher 集成的 Gmail Pub/Sub 流程。
子命令
openclaw webhooks gmail setup --account <email> [...]
openclaw webhooks gmail run [--account <email>] [...]
| 子命令 | 描述 |
|---|
gmail setup | 配置 Gmail 监听、Pub/Sub 主题/订阅，以及 OpenClaw webhook 投递目标。 |
gmail run | 运行 gog watch serve 以及监听自动续订循环。 |
webhooks gmail setup
配置 Gmail 监听、Pub/Sub 和 OpenClaw webhook 投递。
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
必需项
| 标志 | 描述 |
|---|
--account <email> | 要监听的 Gmail 账户。 |
Pub/Sub 选项
| 标志 | 默认值 | 描述 |
|---|
--project <id> | （无） | GCP 项目 ID（OAuth 客户端所有者）。 |
--topic <name> | gog-gmail-watch | Pub/Sub 主题名称。 |
--subscription <name> | gog-gmail-watch-push | Pub/Sub 订阅名称。 |
--label <label> | INBOX | 要监听的 Gmail 标签。 |
--push-endpoint <url> | （无） | 显式指定的 Pub/Sub 推送端点。会覆盖 Tailscale。 |
OpenClaw 投递选项
| 标志 | 默认值 | 描述 |
|---|
--hook-url <url> | （无） | OpenClaw webhook URL。 |
--hook-token <token> | （无） | OpenClaw webhook token。 |
--push-token <token> | （无） | 传递给 gog watch serve 的推送 token。 |
gog watch serve 选项
| 标志 | 默认值 | 描述 |
|---|
--bind <host> | 127.0.0.1 | gog watch serve 绑定主机。 |
--port <port> | 8788 | gog watch serve 端口。 |
--path <path> | /gmail-pubsub | gog watch serve 路径。 |
--include-body | true | 包含邮件正文片段。传入 --no-include-body 可禁用。 |
--max-bytes <n> | 20000 | 每个正文片段的最大字节数。 |
--renew-minutes <n> | 720 (12h) | 每 N 分钟续订一次 Gmail 监听。 |
Tailscale 暴露
| 标志 | 默认值 | 描述 |
|---|
--tailscale <mode> | funnel | 通过 tailscale 暴露推送端点：funnel、serve 或 off。 |
--tailscale-path <path> | （无） | tailscale serve/funnel 的路径。 |
--tailscale-target <t> | （无） | Tailscale serve/funnel 目标（端口、host:port 或 URL）。 |
| 标志 | 描述 |
|---|
--json | 输出机器可读的摘要，而不是文本。 |
webhooks gmail run
在前台运行 gog watch serve 以及监听自动续订循环。
run 接受与 setup 相同的 gog watch serve、OpenClaw 投递、Pub/Sub 和 Tailscale 标志，除了：
run 上的 --account 是可选的（它会回退到已配置的账户）。run 不接受 --project、--push-endpoint 或 --json。run 标志没有内置默认值；缺失的值会回退到 setup 写入的值。
| 类别 | 标志 |
|---|
| Pub/Sub | --account, --topic, --subscription, --label |
| 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 |
对于 run，--topic 的值是完整的 Pub/Sub 主题路径（projects/.../topics/...），而不只是短主题名。
端到端流程
有关与这些 CLI 命令配套的 GCP 项目、OAuth 和网关侧设置，请参见 Gmail Pub/Sub 集成。
相关内容
