Gws Gmail Watch

核心功能：借助GCP Pub/Sub监听Gmail新邮件，支持按标签过滤、多种消息格式设置，可输出为NDJSON流或独立JSON文件，支持复用现有Pub/Sub资源或自动创建后清理。典型场景：实时接收收件箱新邮件、批量提取未读邮件、自动化邮件处理。输入为带参数的命令行指令，可配置拉取频率、批量大小等。

googleworkspace-bot

热度 77.96

最近更新 2026-05-11 17:29:02

分类：自动化依赖：第三方 API / 读写文件应用场景：工作流 / 任务管理

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add gws-gmail-watch

Metadata

name: gws-gmail-watch
description: Gmail: Watch for new emails and stream them as NDJSON.
metadata: {"version":"0.22.5","openclaw":{"category":"productivity","requires":{"bins":["gws"]},"cliHelp":"gws gmail +watch --help"}}

gmail +watch

PREREQUISITE: Read ../gws-shared/SKILL.md for auth, global flags, and security rules. If missing, run gws generate-skills to create it.

Watch for new emails and stream them as NDJSON

Usage

gws gmail +watch

Flags

Flag	Required	Default	Description
`--project`	—	—	GCP project ID for Pub/Sub resources
`--subscription`	—	—	Existing Pub/Sub subscription name (skip setup)
`--topic`	—	—	Existing Pub/Sub topic with Gmail push permission already granted
`--label-ids`	—	—	Comma-separated Gmail label IDs to filter (e.g., INBOX,UNREAD)
`--max-messages`	—	10	Max messages per pull batch
`--poll-interval`	—	5	Seconds between pulls
`--msg-format`	—	full	Gmail message format: full, metadata, minimal, raw
`--once`	—	—	Pull once and exit
`--cleanup`	—	—	Delete created Pub/Sub resources on exit
`--output-dir`	—	—	Write each message to a separate JSON file in this directory

Examples

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

Tips

Gmail watch expires after 7 days — re-run to renew.
Without --cleanup, Pub/Sub resources persist for reconnection.
Press Ctrl-C to stop gracefully.