360 Secure SkillHub
360 安全技能中心

Gws Gmail Watch

通过 gws 命令行监视 Gmail 新邮件：可指定 GCP 项目或复用已有的 Pub/Sub 主题/订阅，按标签过滤、按间隔循环拉取，逐条以 NDJSON 流式输出，也可把每封邮件写入独立 JSON 文件；支持只拉取一次以及退出时清理所创建的 Pub/Sub 资源。需配合 gws-shared 的认证与全局参数说明使用。

googleworkspace-bot
googleworkspace-bot
热度 78.04
最近更新 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.

See Also