OpenClaw从入门到应用——自动化： Gmail

通过OpenClaw实现副业收入：《OpenClaw赚钱实录：从“养龙虾“到可持续变现的实践指南》

前提条件

• 已安装gcloud并已登录（安装指南）。
• 已安装gog（gogcli）并已授权 Gmail 账户（gogcli.sh）。
• 已启用 OpenClaw 钩子（参见 Webhooks）。
• 已登录tailscale（tailscale.com）。支持的设置使用 Tailscale Funnel 作为公共 HTTPS 端点。其他隧道服务也可用，但需要自行处理且不受官方支持，并需要手动对接。目前，我们仅支持 Tailscale。

示例钩子配置（启用 Gmail 预设映射）：

{ hooks: { enabled: true, token: "OPENCLAW_HOOK_TOKEN", path: "/hooks", presets: ["gmail"], }, }

为了将 Gmail 摘要传递到聊天界面，请使用映射覆盖预设，设置deliver以及可选的channel/to：

{ hooks: { enabled: true, token: "OPENCLAW_HOOK_TOKEN", presets: ["gmail"], mappings: [ { match: { path: "gmail" }, action: "agent", wakeMode: "now", name: "Gmail", sessionKey: "hook:gmail:{{messages[0].id}}", messageTemplate: "来自 {{messages[0].from}} 的新邮件\n主题：{{messages[0].subject}}\n摘要：{{messages[0].snippet}}\n正文：{{messages[0].body}}", model: "openai/gpt-5.2-mini", deliver: true, channel: "last", // to: "+15551234567" }, ], }, }

如果您想要一个固定的频道，请设置channel和to。否则，channel: "last"将使用最后传递的路由（回退到 WhatsApp）。

为了强制 Gmail 运行使用更便宜的模型，请在映射中设置model（provider/model或别名）。如果您强制设置了agents.defaults.models，请将模型包含在其中。

为了专门为 Gmail 钩子设置默认模型和思考级别，请在配置中添加hooks.gmail.model/hooks.gmail.thinking：

{ hooks: { gmail: { model: "openrouter/meta-llama/llama-3.3-70b-instruct:free", thinking: "off", }, }, }

注意事项：

• 映射中每个钩子的model/thinking仍会覆盖这些默认值。
• 回退顺序：hooks.gmail.model→agents.defaults.model.fallbacks→ 主模型（用于认证/速率限制/超时）。
• 如果设置了agents.defaults.models，Gmail 模型必须在允许列表中。
• 默认情况下，Gmail 钩子内容被外部内容安全边界包裹。要禁用它（危险操作），请设置hooks.gmail.allowUnsafeExternalContent: true。
• 要进一步自定义负载处理，请添加hooks.mappings或~/.openclaw/hooks/transforms下的 JS/TS 转换模块（参见 Webhooks）。

向导（推荐）

使用 OpenClaw 辅助工具将所有内容串联起来（在 macOS 上通过 brew 安装依赖项）：

openclaw webhooks gmail setup\--accountopenclaw@gmail.com

默认值：

• 使用 Tailscale Funnel 作为公共推送端点。
• 为openclaw webhooks gmail run写入hooks.gmail配置。
• 启用 Gmail 钩子预设（hooks.presets: ["gmail"]）。

路径说明：当tailscale.mode启用时，OpenClaw 会自动将hooks.gmail.serve.path设置为/，并保持公共路径为hooks.gmail.tailscale.path（默认为/gmail-pubsub），因为 Tailscale 在代理之前会去除设置的路径前缀。如果您需要后端接收带有前缀的路径，请将hooks.gmail.tailscale.target（或--tailscale-target）设置为完整 URL，例如http://127.0.0.1:8788/gmail-pubsub，并匹配hooks.gmail.serve.path。

想要自定义端点？请使用--push-endpoint或--tailscale off。

平台说明：在 macOS 上，向导会通过 Homebrew 安装gcloud、gogcli和tailscale；在 Linux 上，请先手动安装它们。

网关自动启动（推荐）：

• 当hooks.enabled=true且设置了hooks.gmail.account时，网关会在启动时启动gog gmail watch serve并自动续期监视。
• 设置OPENCLAW_SKIP_GMAIL_WATCHER=1可选择退出（如果您自己运行守护进程，则很有用）。
• 请勿同时手动运行守护进程，否则您将遇到listen tcp 127.0.0.1:8788: bind: address already in use错误。

手动守护进程（启动gog gmail watch serve+ 自动续期）：

openclaw webhooks gmail run

一次性设置

1. 选择拥有gog使用的 OAuth 客户端的 GCP 项目。

gcloud auth login gcloud configsetproject<项目ID>

注意：Gmail 监视要求 Pub/Sub 主题与 OAuth 客户端位于同一项目中。

2. 启用 API：

gcloud servicesenablegmail.googleapis.com pubsub.googleapis.com

3. 创建主题：

gcloud pubsub topics create gog-gmail-watch

4. 允许 Gmail 推送发布消息：

gcloud pubsub topics add-iam-policy-binding gog-gmail-watch\--member=serviceAccount:gmail-api-push@system.gserviceaccount.com\--role=roles/pubsub.publisher

启动监视

gog gmailwatchstart\--accountopenclaw@gmail.com\--labelINBOX\--topicprojects/<项目ID>/topics/gog-gmail-watch

从输出中保存history_id（用于调试）。

运行推送处理器

本地示例（共享令牌认证）：

gog gmailwatchserve\--accountopenclaw@gmail.com\--bind127.0.0.1\--port8788\--path/gmail-pubsub\--token<你的令牌>\--hook-url http://127.0.0.1:18789/hooks/gmail\--hook-token OPENCLAW_HOOK_TOKEN\--include-body\--max-bytes20000

注意事项：

• --token保护推送端点（x-gog-token或?token=）。
• --hook-url指向 OpenClaw 的/hooks/gmail（已映射；独立运行并将摘要发送到主入口）。

推荐：openclaw webhooks gmail run封装了相同的流程并自动续期监视。

暴露处理器（高级，不受支持）

如果您需要非 Tailscale 隧道，请手动连接并在推送订阅中使用公共 URL（不受支持，无保护措施）：

cloudflared tunnel--urlhttp://127.0.0.1:8788 --no-autoupdate

使用生成的 URL 作为推送端点：

gcloud pubsub subscriptions create gog-gmail-watch-push\--topicgog-gmail-watch\--push-endpoint"https://<隧道域名>/gmail-pubsub?token=<你的令牌>"

生产环境：使用稳定的 HTTPS 端点并配置 Pub/Sub OIDC JWT，然后运行：

gog gmailwatchserve --verify-oidc --oidc-email<你的邮箱>

测试

向被监视的收件箱发送一条消息：

gog gmail send\--accountopenclaw@gmail.com\--toopenclaw@gmail.com\--subject"watch test"\--body"ping"

检查监视状态和历史记录：

gog gmailwatchstatus--accountopenclaw@gmail.com gog gmailhistory--accountopenclaw@gmail.com--since<history_id>

故障排除

• Invalid topicName：项目不匹配（主题不在 OAuth 客户端项目中）。
• User not authorized：主题缺少roles/pubsub.publisher权限。
• 消息为空：Gmail 推送仅提供historyId；通过gog gmail history获取完整内容。

清理

gog gmailwatchstop--accountopenclaw@gmail.com gcloud pubsub subscriptions delete gog-gmail-watch-push gcloud pubsub topics delete gog-gmail-watch