← 返回 Skills 市场
Gws Events Subscribe
作者
googleworkspace-bot
· GitHub ↗
· v1.0.12
· MIT-0
455
总下载
0
收藏
13
当前安装
13
版本数
在 OpenClaw 中安装
/install gws-events-subscribe
功能描述
Google Workspace Events: Subscribe to Workspace events and stream them as NDJSON.
使用说明 (SKILL.md)
events +subscribe
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Subscribe to Workspace events and stream them as NDJSON
Usage
gws events +subscribe
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--target |
— | — | Workspace resource URI (e.g., //chat.googleapis.com/spaces/SPACE_ID) |
--event-types |
— | — | Comma-separated CloudEvents types to subscribe to |
--project |
— | — | GCP project ID for Pub/Sub resources |
--subscription |
— | — | Existing Pub/Sub subscription name (skip setup) |
--max-messages |
— | 10 | Max messages per pull batch (default: 10) |
--poll-interval |
— | 5 | Seconds between pulls (default: 5) |
--once |
— | — | Pull once and exit |
--cleanup |
— | — | Delete created Pub/Sub resources on exit |
--no-ack |
— | — | Don't auto-acknowledge messages |
--output-dir |
— | — | Write each event to a separate JSON file in this directory |
Examples
gws events +subscribe --target '//chat.googleapis.com/spaces/SPACE' --event-types 'google.workspace.chat.message.v1.created' --project my-project
gws events +subscribe --subscription projects/p/subscriptions/my-sub --once
gws events +subscribe ... --cleanup --output-dir ./events
Tips
- Without --cleanup, Pub/Sub resources persist for reconnection.
- Press Ctrl-C to stop gracefully.
[!CAUTION] This is a write command — confirm with the user before executing.
See Also
- gws-shared — Global flags and auth
- gws-events — All subscribe to google workspace events commands
安全使用建议
This skill appears to be a thin wrapper around the 'gws events +subscribe' CLI and is generally coherent — but it defers authentication and global flags to a referenced ../gws-shared/SKILL.md that is not included. Before installing or running: (1) inspect the gws-shared SKILL.md the skill references (or the output of `gws generate-skills`) to see exactly how credentials are obtained and stored; (2) verify which account/credentials the gws binary will use (ADC, gcloud user account, or a service account) and ensure least privilege; (3) confirm the origin and integrity of the 'gws' binary on your system; (4) be cautious when running commands that create Pub/Sub resources — use --cleanup or a sandbox GCP project for testing; (5) avoid providing broad service-account keys unless necessary. If you cannot locate the referenced gws-shared documentation or confirm auth flows, do not run this skill with high-privilege credentials.
功能分析
Type: OpenClaw Skill
Name: gws-events-subscribe
Version: 1.0.12
The skill bundle 'gws-events-subscribe' is a standard documentation wrapper for the 'gws' CLI tool, designed to manage Google Workspace event subscriptions via Pub/Sub. It contains no executable code, obfuscation, or suspicious instructions, and it includes a safety caution (SKILL.md) advising the agent to confirm with the user before execution.
能力评估
Purpose & Capability
The name/description (subscribe to Workspace events and stream NDJSON) aligns with the required binary (gws) and the documented CLI flags. Requiring a gws CLI to subscribe to Google Workspace events is reasonable.
Instruction Scope
SKILL.md only documents the gws events +subscribe command and flags. However it explicitly instructs the agent to read ../gws-shared/SKILL.md for auth, global flags, and security rules — that external dependency is not included in the package, so the agent may attempt to access or create files and follow instructions outside this skill. The skill otherwise doesn't instruct reading unrelated system files or sending data to unexpected endpoints.
Install Mechanism
Instruction-only skill with no install spec and no code files — lowest install risk. It assumes an existing 'gws' binary is present on PATH.
Credentials
The skill declares no required environment variables or primary credential, yet subscribing to Workspace events and creating/using Pub/Sub resources requires GCP/Workspace auth and permissions. The lack of explicit credential/env declarations (and deferral to a missing ../gws-shared file) makes it unclear what secrets or accounts will be used, where they are sourced from, and whether the agent will access additional credentials.
Persistence & Privilege
always is false and the skill does not request persistent presence or modify other skills. It may create cloud resources (Pub/Sub) when run, which is expected for its purpose; SKILL.md includes a CAUTION to confirm write actions.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install gws-events-subscribe - 安装完成后，直接呼叫该 Skill 的名称或使用
/gws-events-subscribe触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.12
- Updated version metadata from 0.22.4 to 0.22.5 in SKILL.md.
- No other content or functionality changes.
v1.0.11
- Updated version metadata from 0.22.3 to 0.22.4 in SKILL.md.
- No functional changes; documentation version correction only.
v1.0.10
- Bumped metadata version from 0.22.2 to 0.22.3 in SKILL.md.
- No other user-facing changes.
v1.0.9
- Update skill metadata version from 0.22.1 to 0.22.2 in SKILL.md.
- No functional or documentation changes besides the version bump.
v1.0.8
- Updated skill metadata version from 0.22.0 to 0.22.1 in SKILL.md.
- No functional or usage changes; documentation version bump only.
v1.0.7
- Bumped skill version to 0.22.0 in SKILL.md (from 0.21.2).
- No functional or documentation changes apart from the version update.
v1.0.6
- Bumped internal version from 0.21.1 to 0.21.2 in SKILL.md.
- No user-facing or functional changes; documentation version update only.
v1.0.5
- Updated skill version to 0.21.1 in metadata.
- No functional or usage changes; documentation updated to reflect new version.
v1.0.4
- Updated version in metadata from 0.20.0 to 0.20.1 in SKILL.md.
- No changes to usage, flags, examples, or documentation content.
v1.0.3
- Version updated from 0.19.0 to 0.20.0 in documentation metadata.
- No other content or functional changes.
v1.0.2
- Updated skill metadata format and structure in SKILL.md.
- Versioning moved under the metadata block (now "version: 0.19.0").
- Removed the top-level version field.
- No changes to usage, flags, examples, or command functionality.
v1.0.1
- Updated SKILL.md formatting for consistency (minor YAML reformatting).
- No functional or feature changes—documentation update only.
v1.0.0
Initial release of gws-events-subscribe.
- Subscribe to Google Workspace events and stream them as NDJSON.
- Supports multiple flags for targeting resources, filtering event types, managing Pub/Sub subscriptions, batching, polling interval, and output configuration.
- Optional cleanup of created Pub/Sub resources on exit.
- Allows for one-time pulls, output to directory, and manual acknowledgement of messages.
- Includes usage examples, tips, and links to related skills.
元数据
常见问题
Gws Events Subscribe 是什么？
Google Workspace Events: Subscribe to Workspace events and stream them as NDJSON. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 455 次。
如何安装 Gws Events Subscribe？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install gws-events-subscribe」即可一键安装，无需额外配置。
Gws Events Subscribe 是免费的吗？
是的，Gws Events Subscribe 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Gws Events Subscribe 支持哪些平台？
Gws Events Subscribe 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Gws Events Subscribe？
由 googleworkspace-bot（@googleworkspace-bot）开发并维护，当前版本 v1.0.12。
推荐 Skills