Webhook helpers
像门铃接线员，负责把外面的按铃动作送进来。
Cli 导读
Gmail 实时推送接入：两步命令搞定 Pub/Sub 监听
先跑 `setup` 配好 Gmail watch、Pub/Sub 主题和 webhook 投递，再跑 `run` 启动监听并自动续期。最容易漏的是 `--hook-token` 和 `--push-token` 两个 token，前者验证回调请求，后者用于 Pub/Sub 推送认证，填错会导致收不到邮件通知。
先讲这一页到底在解决什么
Gmail 实时推送接入：两步命令搞定 Pub/Sub 监听
先跑 `setup` 配好 Gmail watch、Pub/Sub 主题和 webhook 投递，再跑 `run` 启动监听并自动续期。最容易漏的是 `--hook-token` 和 `--push-token` 两个 token，前者验证回调请求，后者用于 Pub/Sub 推送认证，填错会导致收不到邮件通知。
第一站
📬 先想画面：邮箱来新信时，不是你一直守在门口，而是门铃自己响
官方这页虽然短，但核心思路很清楚。webhook 的价值就是让外部系统主动把消息推过来。
Gmail Pub/Sub
像邮箱管理员一看到新信，就立刻按一下提醒铃。
不是一直轮询
不是每隔几秒自己去翻邮箱，而是让外面主动喊你。
一句话
webhook 就是把“外面有事了”这声门铃接进来。
第二站
📮 这页最核心的两条命令，像“先接好邮箱门铃，再试着让它响一遍”
官方只给了 Gmail 这组例子，但已经足够说明路子。
openclaw webhooks gmail setup --account you@example.com像先把某个邮箱账号的门铃线路接好，告诉系统“以后这只邮箱一有动静，就按这只铃”。
openclaw webhooks gmail run像先把这套门铃助手跑起来，准备接住后面的来铃动作。
Gmail Pub/Sub 文档
像更细的接线图纸不在这页，而在那篇专门的 Gmail Pub/Sub 说明里。
🎈 一句话
这页是门铃总开关，细线路图去 Gmail Pub/Sub 那页看。
第三站
🧠 为什么这页很短？因为它更像一个入口牌，不是把整套接线细节都塞在这里
官方故意写得收敛，就是不想把 Gmail 细节和通用 webhook 思路都混在一起。
入口牌
告诉你“有 webhook helpers，而且 Gmail 这条线从这里进”。
细节另页
更细的参数、权限、事件格式，去相关专页慢慢看。
Related docs
官方给的两条 related link，就是门铃主文档和 Gmail 邮箱门铃专线图。
一句话
这里是门口牌子，不是全部电路图。
最后总结
🎈 把 openclaw webhooks 压成一句话
openclaw webhooks 就像给 OpenClaw 接门铃：先把 Gmail 之类外部事件的来铃线路接好，再让助手守在那儿，等外面一按铃就把消息送进来。