Gmail PubSub

这就像给你的邮箱装了一个小喇叭，一有新邮件进来，它就“滴滴”响，然后让你的 OpenClaw 助手知道。你需要先准备好几样东西，就像搭积木一样把它们连起来。

你需要先准备好的东西：

1. gcloud：这是一个能和谷歌云说话的工具。你得先把它装好，并且登录你的谷歌账号。
2. gog：这是一个能帮你读 Gmail 邮件的工具。你也需要装好它，并且让它能访问你的 Gmail 邮箱。
3. OpenClaw 钩子：这是 OpenClaw 机器人接收消息的小耳朵。你得先把它打开。
4. tailscale：这是一个能帮你安全地把家里电脑的服务让外面访问的工具。我们现在主要支持用它。你需要登录它。

最简单的办法（推荐！） 有一个像魔法一样的命令，能帮你把上面所有东西都自动连好。你只需要告诉它你的 Gmail 邮箱地址。

openclaw webhooks gmail setup --account 你的邮箱@gmail.com

它会自动帮你装好需要的东西（在苹果电脑上），并且设置好一切。之后，只要 OpenClaw 运行着，它就会自动帮你留意新邮件啦！

如果你想自己一步一步来：

1. 选对谷歌云项目：用 gcloud 登录，并选一个项目。这个项目必须和 gog 用来登录邮箱的那个项目是同一个。
2. 打开两个开关：告诉谷歌云，我们要用 Gmail 和 Pub/Sub（你可以把 Pub/Sub 想成一个邮局）这两个服务。
3. 在邮局建一个信箱：创建一个叫 gog-gmail-watch 的“话题”（Topic），这就像在邮局租了一个专属信箱。
4. 给 Gmail 发信的权限：告诉这个信箱，允许 Gmail 服务往里面投递新邮件通知。
5. 开始监听邮箱：用 gog 命令告诉 Gmail：“请帮我盯着收件箱（INBOX），一有新邮件就发通知到我刚建的信箱。”
6. 启动邮件处理员：运行一个服务，它会守在信箱旁边。一有通知，它就跑去 Gmail 把新邮件内容取出来，然后送给 OpenClaw 的小耳朵（webhook）。你可以用这个命令：

openclaw webhooks gmail run

这个命令会一直运行，并且自动更新监听，不会过期。

需要小心的事情：

• 如果你用推荐的魔法命令（setup），它默认会用 tailscale 来让外面能访问到你电脑上的服务。
• 不要同时运行两个“邮件处理员”，不然它们会吵架，抢同一个位置。
• 信箱（话题）必须和 gog 登录的项目在同一个地方，不然会出错说“Invalid topicName”。
• Gmail 发来的通知里只有邮件编号，处理员需要根据这个编号再去邮箱里把邮件内容拿出来。

试试看灵不灵： 给自己发一封测试邮件：

gog gmail send --account 你的邮箱@gmail.com --to 你的邮箱@gmail.com --subject “测试” --body “喂，听得到吗？”

如果设置对了，你的 OpenClaw 机器人应该会告诉你收到新邮件啦！

不用的时候怎么收拾： 记得关掉监听，删掉邮局的信箱和订阅，保持整洁。

gog gmail watch stop --account 你的邮箱@gmail.com
gcloud pubsub subscriptions delete gog-gmail-watch-push
gcloud pubsub topics delete gog-gmail-watch