长亭百智云长亭百智云
登录
返回全部 Skills

gws-gmail-watch

数据处理 官方认证

Gmail：监控新邮件并以 NDJSON 格式流式传输

16.4k

下载量

AI SkillHub 能力展示图

安装方式

命令行安装

在项目根目录执行以下命令，完成 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——Pub/Sub 资源的 GCP 项目 ID
--subscription——现有 Pub/Sub 订阅名称（跳过设置）
--topic——已授予 Gmail 推送权限的现有 Pub/Sub 主题
--label-ids——用于过滤的逗号分隔的 Gmail 标签 ID（例如 INBOX,UNREAD）
--max-messages—10每次拉取批量的最大消息数
--poll-interval—5拉取间隔（秒）
--msg-format—fullGmail 消息格式：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 优雅停止。

另见