Automation 导读

Gmail PubSub:它会在什么时候自己动起来

Gmail PubSub 讲的不是“自动”两个字有多神,而是它什么时候会自己醒来、醒来后会留下什么脚印、又和 cron、heartbeat、tasks 这些近亲怎么分工。原文最响的一记鼓点,其实是:This page moved to Scheduled Tasks. See Scheduled Tasks for Gmail PubSub documentation.。

先讲这一页到底在解决什么

Gmail PubSub:它会在什么时候自己动起来

Gmail PubSub 讲的不是“自动”两个字有多神,而是它什么时候会自己醒来、醒来后会留下什么脚印、又和 cron、heartbeat、tasks 这些近亲怎么分工。原文最响的一记鼓点,其实是:This page moved to Scheduled Tasks. See Scheduled Tasks for Gmail PubSub documentation.。

原文共 2 节,先看 Start Here 路径:/automation/gmail-pubsub 查看官方原文

主线

📮 整条链路像这样:Gmail 盯邮箱 → Pub/Sub 敲钟 → 中转邮差取件 → OpenClaw webhook 收信

你只要先把这个画面记住,后面一长串命令就不会显得像咒语。

官方第一句话其实已经给了流程图:Gmail watch -> Pub/Sub push -> gog gmail watch serve -> OpenClaw webhook。翻成人话,就是“邮箱发现新信,交给邮局,邮局再叫本地邮差把信送进 OpenClaw”。

推荐路线

🧙 最推荐还是向导:openclaw webhooks gmail setup

官方把这个向导写成推荐路线,是有道理的。因为它会把一堆零件一次装起来。

它在做什么

像一个装配师傅,帮你把 GCP、Gmail watch、Tailscale Funnel、hook preset 这些零件串起来。

为什么推荐

因为手动链路很长,任何一环漏掉,邮箱邮差就会半路失踪。

🎈 一句话

能用向导,就别先手拧每颗螺丝。

手动理解

🧰 那堆 gcloud / gog 命令,其实就是“修邮局、发通行证、启用邮差”

如果你非要手动搭,也别一口气背命令,按角色看就行。

🏢

gcloud services enable ...

像把 Gmail 和 Pub/Sub 这两个邮局窗口正式开张。

📦

gcloud pubsub topics create ...

像建一个邮袋投递点,Gmail 以后往这里扔“有新信了”的通知。

✉️

gog gmail watch start

像正式告诉 Gmail:“以后帮我盯着这个邮箱,一有动静就往那个邮袋里扔通知。”

🧍

gog gmail watch serve

像启动一个本地邮差,负责从邮袋接消息,再送到 OpenClaw webhook 门口。

投递内容

📨 Gmail hook mapping,像“邮差附上一张摘要便签”

官方给的 mapping 不是装饰,而是在决定邮差送信时,便签上写什么。

messageTemplate 里写的发件人、标题、snippet、body,像邮差帮你先把信外面最重要的信息抄在便签上,送到 OpenClaw 时老师不用先自己拆半天信封。

公开入口

🌐 Tailscale Funnel 在这里像“给邮差搭一条能从外面敲门的安全通道”

官方当前支持路线里,Tailscale 是最推荐的公开入口搭法。

为什么需要它

Pub/Sub 要能从外面把消息推到你这儿,本地 127.0.0.1 门牌别人看不到,所以要搭个公开门铃口。

为什么官方一直强调 Tailscale

因为这条路他们自己支持、自己验过。其他隧道不是不行,只是你要自己扛更多接线风险。

最后总结

🎈 把 Gmail Pub/Sub 这页压成一句最好记的话

这整页都在讲“邮箱邮差链路”。Gmail 发现新信,Pub/Sub 敲钟,本地邮差取件,再把摘要送到 OpenClaw 的 webhook 门口。能走向导就走向导。