← Back to Skills Marketplace
Gws Events Subscribe
by
googleworkspace-bot
· GitHub ↗
· v1.0.12
· MIT-0
455
Downloads
0
Stars
13
Active Installs
13
Versions
Install in OpenClaw
/install gws-events-subscribe
Description
Google Workspace Events: Subscribe to Workspace events and stream them as NDJSON.
README (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
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gws-events-subscribe - After installation, invoke the skill by name or use
/gws-events-subscribe - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is Gws Events Subscribe?
Google Workspace Events: Subscribe to Workspace events and stream them as NDJSON. It is an AI Agent Skill for Claude Code / OpenClaw, with 455 downloads so far.
How do I install Gws Events Subscribe?
Run "/install gws-events-subscribe" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gws Events Subscribe free?
Yes, Gws Events Subscribe is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gws Events Subscribe support?
Gws Events Subscribe is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gws Events Subscribe?
It is built and maintained by googleworkspace-bot (@googleworkspace-bot); the current version is v1.0.12.
More Skills