安装方式
命令行安装
在项目根目录执行以下命令，完成 Skill 安装。
npx bzskills add googleworkspace/cli --skill gws-gmail-watch
skill.md
name: gws-gmail-watch
description: Gmail：监控新邮件并将其流式传输为 NDJSON。
metadata:
version: 0.22.5
openclaw:
category: "productivity"
requires:
bins:
- gws
cliHelp: "gws gmail +watch --help"gmail +watch
先决条件： 请阅读../gws-shared/SKILL.md了解身份验证、全局标志和安全规则。如果该文件缺失，请运行gws generate-skills创建它。
监控新邮件并以 NDJSON 格式输出流
用法
gws gmail +watch
标志
| 标志 | 必填 | 默认值 | 描述 |
|---|---|---|---|
--project | — | — | GCP 项目 ID，用于 Pub/Sub 资源 |
--subscription | — | — | 现有的 Pub/Sub 订阅名称（跳过设置） |
--topic | — | — | 已授予 Gmail 推送权限的现有 Pub/Sub 主题 |
--label-ids | — | — | 用于过滤的逗号分隔的 Gmail 标签 ID（例如 INBOX,UNREAD） |
--max-messages | — | 10 | 每次拉取的最大消息数 |
--poll-interval | — | 5 | 拉取间隔（秒） |
--msg-format | — | full | Gmail 消息格式：full、metadata、minimal、raw |
--once | — | — | 仅拉取一次后退出 |
--cleanup | — | — | 退出时删除创建的 Pub/Sub 资源 |
--output-dir | — | — | 将每条消息写入此目录下的独立 JSON 文件 |
示例
gws gmail +watch --project my-gcp-project
gws gmail +watch --project my-project --label-ids INBOX --once
gws gmail +watch --subscription projects/p/subscriptions/my-sub
gws gmail +watch --project my-project --cleanup --output-dir ./emails
提示
- Gmail 监控会在 7 天后过期——重新运行以续期。
- 不使用
--cleanup时，Pub/Sub 资源会保留以便重新连接。 - 按 Ctrl-C 可优雅停止。
参见
- gws-shared — 全局标志和身份验证
- gws-gmail — 所有发送、读取和管理邮件的命令