gws-events

What This Skill Does

The gws-events skill provides a robust interface for interacting with Google Workspace Events, enabling the OpenClaw AI agent to monitor, subscribe to, and manage real-time updates within your Workspace environment. Acting as a bridge between the Google Workspace Events API and your automation workflows, this skill allows for granular control over subscriptions, task monitoring, and long-running operations. It is designed to handle both passive observation—through subscriptions that stream events as NDJSON—and active management—by allowing users to patch, renew, or reactivate event streams as needed. Whether you are tracking user activities, system changes, or specific task lifecycle updates, this tool ensures your agent stays synchronized with the latest data from the Google ecosystem.

Installation

To integrate this skill into your environment, use the OpenClaw CLI tool. Before proceeding, ensure that you have configured your authentication and global flags by running gws generate-skills or referring to the ../gws-shared/SKILL.md file in your repository. Install the skill using the following command: clawhub install openclaw/skills/skills/googleworkspace-bot/gws-events

Use Cases

• Automated Monitoring: Establish event subscriptions to receive immediate notifications when specific workspace resources change, allowing your agent to trigger secondary workflows.
• Task Lifecycle Management: Use the tasks resource to monitor ongoing operations. This is particularly useful for tracking long-running tasks and responding instantly when they reach a terminal state.
• Maintenance & Compliance: Utilize the subscriptions resource to audit currently active connections, renew expiring ones, or reactivate suspended subscriptions without requiring manual intervention.
• Real-time Data Streaming: Pipe incoming Google Workspace events directly into other data processing pipelines by leveraging the streaming capabilities of the message resource.

Example Prompts

1. "Subscribe me to all user activity events in my Google Workspace and stream the logs to my current console session."
2. "Check the status of my current long-running task associated with the latest data export operation."
3. "List all my active Google Workspace subscriptions and renew any that are set to expire in the next 24 hours."

Tips & Limitations

• Prerequisites: Always ensure that gws-shared is correctly set up. Without valid authentication scopes from the shared configuration, API calls will fail consistently.
• Streaming Constraints: When using the message:stream or tasks:subscribe methods, remember that these are persistent connections. Ensure your network policy allows for long-lived socket connections to avoid premature termination.
• Subscription Health: Keep an eye on the reactivate functionality. If a subscription enters a suspended state, the system will not resume automatically; you must manually invoke the reactivate command after resolving the underlying cause.
• Security: Because this skill interacts with sensitive workspace data, verify that your API credentials have the minimum viable scopes required for the specific resources you intend to monitor.