通过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一次性设置
- 选择拥有
gog使用的 OAuth 客户端的 GCP 项目。
gcloud auth login gcloud configsetproject<项目ID>注意：Gmail 监视要求 Pub/Sub 主题与 OAuth 客户端位于同一项目中。
- 启用 API：
gcloud servicesenablegmail.googleapis.com pubsub.googleapis.com- 创建主题：
gcloud pubsub topics create gog-gmail-watch- 允许 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
