gws-drive

What This Skill Does

The gws-drive skill provides a powerful interface for interacting with Google Drive directly through the OpenClaw agent. It allows for the management of files, folders, and shared drives by wrapping the Google Drive API v3. Users can perform granular operations ranging from retrieving user account information and system capabilities to managing complex collaboration features like access proposals and approvals. The skill is designed to handle administrative tasks, such as tracking changes within a Drive or managing installed third-party applications, making it an essential tool for streamlining document workflows.

Installation

To integrate this skill into your environment, use the OpenClaw command line interface. Before running the installation, ensure you have configured your Google Workspace authentication by following the guide located in gws-shared/SKILL.md. Once prerequisites are met, execute the following command in your terminal:

clawhub install openclaw/skills/skills/googleworkspace-bot/gws-drive

If you have not yet set up your global configuration files, running gws generate-skills is recommended to create the necessary boilerplate and directory structures.

Use Cases

This skill is ideal for automating file-centric operations. It is particularly useful for auditing shared access, managing pending approval requests for sensitive documents, and monitoring modifications within a shared drive. For developers and power users, it provides programmatic access to file change logs, allowing for the creation of custom backup scripts, synchronization tools, or automated notifications when documents are modified or accessed.

Example Prompts

1. "List all pending access proposals for the project proposal document in my Google Drive."
2. "Get the starting page token for change tracking on my main team shared drive."
3. "Show me a list of all installed apps that have access to my Google Drive data."

Tips & Limitations

When using the about resource, remember that the fields parameter is mandatory to prevent performance overhead and ensure you only retrieve the data you specifically need. Be mindful of API rate limits if you are programmatically watching for changes using the channels resource. Because this skill interacts directly with user files and permissions, ensure that your OpenClaw instance is governed by the security protocols defined in your workspace configuration. Only users with appropriate administrative or owner-level permissions can successfully execute commands involving access proposals or approvals.