gws-workflow

What This Skill Does

The gws-workflow skill serves as the primary orchestration layer for the Google Workspace ecosystem within OpenClaw. It enables users to bridge disparate productivity tools—such as Gmail, Google Calendar, Google Drive, and Google Tasks—into unified, automated workflows. Rather than treating these apps as silos, the skill uses predefined logic to synthesize data across services. For instance, it can automatically parse information from an email and push it into a task list, or scan your calendar to generate a structured meeting briefing. It is designed for high-frequency productivity users who need to streamline their daily operations without manually switching between browser tabs.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/googleworkspace-bot/gws-workflow. Ensure that you have first verified your authentication status by reading the shared prerequisites in ../gws-shared/SKILL.md. If the directory structure is missing, execute gws generate-skills to initialize your local environment properly. This skill relies on the core gws CLI tool, so please ensure your OpenClaw environment is updated to the latest version before installation.

Use Cases

This skill is ideal for professionals balancing multiple communication channels and document repositories. A common use case includes the 'Meeting Preparation' flow, where the agent aggregates agendas, attendee profiles, and relevant shared documents into a single briefing file minutes before a session starts. Another critical use case is the 'Task Lifecycle', where incoming emails regarding project updates are converted directly into actionable tasks, ensuring nothing is lost in an overflowing inbox. Finally, users managing cross-functional teams can leverage automated announcements to notify specific Chat spaces when a new Drive file is ready for review, maintaining team momentum.

Example Prompts

1. "Analyze my next meeting from my calendar and generate a meeting prep document with all relevant context."
2. "Take the last email from John about the Q3 budget and create a Google Task for me with a due date of Friday."
3. "Summarize my upcoming week: list my primary meetings and let me know how many unread emails I currently have."

Tips & Limitations

To maximize efficiency, always use gws schema workflow.<resource>.<method> to check parameter requirements before execution. This prevents errors by ensuring you are passing the correct data types. Note that this skill requires active OAuth2 scopes for each Google service it accesses; if a specific command fails, verify your permissions. As with all automation tools, verify the output of 'Email-to-Task' conversions periodically to ensure context preservation. Do not use this skill for high-security administrative tasks that require direct human authorization at the Google Workspace Admin console level, as this is intended for personal productivity workflows.