gws-events-subscribe

What This Skill Does

The gws-events-subscribe skill is a powerful automation utility designed for OpenClaw agents to interface directly with Google Workspace event streams. By leveraging Google Cloud Pub/Sub under the hood, it facilitates real-time monitoring and data streaming of workspace events, such as Chat message creation or other CloudEvent-compatible Workspace triggers. It streams these updates in Newline Delimited JSON (NDJSON) format, making it highly compatible with data processing pipelines, logging services, or reactive AI agents. The skill manages the lifecycle of Pub/Sub subscriptions, handles message polling intervals, and offers flexible output configurations including direct file writing or real-time streaming.

Installation

To install this skill, use the ClawHub CLI command: clawhub install openclaw/skills/skills/googleworkspace-bot/gws-events-subscribe

Ensure that you have completed the prerequisite setup outlined in gws-shared/SKILL.md, which includes configuring your Google Cloud authentication, project settings, and necessary API enablement for the Google Workspace Events API.

Use Cases

• Automated Workflow Integration: Trigger downstream business logic automatically whenever a new message is posted in a specific Google Chat space.
• Audit and Logging: Archive all workspace activity to local files or a cloud data lake for compliance and historical record-keeping using the --output-dir flag.
• Real-Time Dashboards: Feed live event streams into observability tools or custom dashboards to track team engagement or support ticket volume within chat spaces.
• Event-Driven AI Assistants: Create autonomous bots that 'listen' for user mentions or specific events to provide context-aware assistance without constant manual polling.

Example Prompts

1. "Start streaming new chat messages from the 'Project Alpha' space to my logs folder for the next hour."
2. "Listen to workspace events for the specified project and save every incoming event to a file in the ./workspace-events directory."
3. "Subscribe to events in my workspace and pull the latest 50 messages, then shut down the connection once finished."

Tips & Limitations

• Cleanup Management: By default, Pub/Sub resources will persist to ensure you can reconnect without losing events. Always consider using the --cleanup flag if you are performing ad-hoc, temporary monitoring to avoid cluttering your GCP project with orphaned subscriptions.
• Permissions: This skill requires significant IAM permissions on the target GCP project to create, modify, and delete Pub/Sub subscriptions. Ensure the service account used by the OpenClaw agent has the appropriate roles (e.g., Pub/Sub Editor).
• Safety Caution: This is a write-capable tool that interacts with your live Workspace environment. The OpenClaw agent should always prompt for human confirmation before executing any subscription setup or cleanup operations to prevent unintended modification of your cloud infrastructure.