← 返回 Skills 市场
Gws Gmail Watch
作者
googleworkspace-bot
· GitHub ↗
· v1.0.12
· MIT-0
535
总下载
0
收藏
16
当前安装
13
版本数
在 OpenClaw 中安装
/install gws-gmail-watch
功能描述
Gmail: Watch for new emails and stream them as NDJSON.
使用说明 (SKILL.md)
gmail +watch
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto 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
- gws-shared — Global flags and auth
- gws-gmail — All send, read, and manage email commands
安全使用建议
This skill appears to just wrap a 'gws' CLI command to watch Gmail, but it hides its authentication steps in a referenced ../gws-shared/SKILL.md that is not included. Before installing or running it: 1) inspect the referenced gws-shared SKILL.md to see exactly how auth is performed and where credentials/config are stored; 2) verify the provenance and integrity of the 'gws' binary (where it comes from and what permissions it requires); 3) confirm what Google/GCP credentials or service account scopes are needed (Gmail API, Pub/Sub publisher/subscriber) and grant only least privilege; 4) be cautious about Pub/Sub resources left behind — prefer using --cleanup or a disposable project/account for testing; 5) if you cannot review the shared auth file or trust the gws binary source, do not install or run this skill.
功能分析
Type: OpenClaw Skill
Name: gws-gmail-watch
Version: 1.0.12
The skill bundle provides documentation for a Gmail monitoring tool using the 'gws' CLI and Google Cloud Pub/Sub. The functionality described in SKILL.md is consistent with its stated purpose of watching for new emails and streaming them as NDJSON, and it contains no evidence of malicious intent, hidden commands, or prompt injection.
能力评估
Purpose & Capability
The skill is instruction-only and simply invokes the 'gws' CLI to watch Gmail and stream NDJSON, which aligns with the name/description. Requiring the 'gws' binary is expected for this purpose.
Instruction Scope
SKILL.md explicitly directs the agent to read ../gws-shared/SKILL.md for auth, global flags, and security rules. That external file likely contains authentication steps and possibly references to credentials or config paths — a hidden dependency not included here. The instructions also create/use GCP Pub/Sub resources (topic/subscription) which imply access to GCP IAM and Gmail push configuration even though those details are not surfaced.
Install Mechanism
There is no install spec and no code files — lowest-risk delivery model. The only runtime requirement is that a 'gws' binary exists on PATH; the skill does not itself download or execute additional artifacts.
Credentials
The skill operates on Gmail and GCP Pub/Sub but declares no required environment variables or primary credential. Because it references another SKILL.md for auth, required credentials (Google OAuth tokens, service account keys, GCP project credentials) are hidden rather than declared, which is disproportionate and opaque.
Persistence & Privilege
The skill is not always-enabled and does not request persistent presence or elevated platform privileges. It does have options to create persistent GCP Pub/Sub resources, but that behavior is controlled by flags (e.g., --cleanup) and is within the user's control.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install gws-gmail-watch - 安装完成后，直接呼叫该 Skill 的名称或使用
/gws-gmail-watch触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.12
- Bumped skill version from 0.22.4 to 0.22.5 in SKILL.md.
- No other changes were made.
v1.0.11
- Bumped metadata version from 0.22.3 to 0.22.4 in SKILL.md.
- No other functional or usage changes.
v1.0.10
- Updated version in SKILL.md metadata from 0.22.2 to 0.22.3.
- No functional or usage changes; documentation version only.
v1.0.9
- Updated version in SKILL.md metadata to 0.22.2.
- No functional or documentation changes beyond the version bump.
v1.0.8
- Bumped metadata version from 0.22.0 to 0.22.1 in SKILL.md.
- No functional or usage changes.
- Documentation only update.
v1.0.7
- Bumped version from 0.21.2 to 0.22.0 in SKILL.md.
- No changes to usage, flags, examples, or functionality documented.
- No other file modifications indicated.
v1.0.6
- Updated internal version from 0.21.1 to 0.21.2 in SKILL.md.
- No changes to usage, features, commands, or documentation content.
v1.0.5
- Bumped skill version from 0.20.1 to 0.21.1 in SKILL.md.
v1.0.4
- Updated skill version metadata from 0.20.0 to 0.20.1 in SKILL.md.
v1.0.3
- Version updated from 0.19.0 to 0.20.0 in SKILL.md.
- No functional or documentation changes other than the version bump.
v1.0.2
- Metadata version key updated to 0.19.0; top-level version field removed.
- No functional changes to usage, interface, or documentation content.
- Minor internal metadata structure update for compatibility.
v1.0.1
- No functional changes; only SKILL.md formatting was updated.
- List formatting for the required binaries improved for consistency.
- No user-facing or CLI changes.
v1.0.0
Initial release of gws-gmail-watch.
- Adds a command to watch for new Gmail emails and stream them as NDJSON.
- Supports filtering by label, configuring message batch size, polling interval, message format, and output directory.
- Integrates with Google Pub/Sub for event delivery; can manage or reuse Pub/Sub resources.
- Includes options for one-off pulls, resource cleanup, and output file generation.
- Detailed flag descriptions, usage examples, and tips provided in documentation.
- Requires gws CLI and gws-shared SKILL for authentication and common flags.
元数据
常见问题
Gws Gmail Watch 是什么？
Gmail: Watch for new emails and stream them as NDJSON. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 535 次。
如何安装 Gws Gmail Watch？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install gws-gmail-watch」即可一键安装，无需额外配置。
Gws Gmail Watch 是免费的吗？
是的，Gws Gmail Watch 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Gws Gmail Watch 支持哪些平台？
Gws Gmail Watch 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Gws Gmail Watch？
由 googleworkspace-bot（@googleworkspace-bot）开发并维护，当前版本 v1.0.12。
推荐 Skills