gws-drive-upload

What This Skill Does

The gws-drive-upload skill serves as a seamless integration between your local filesystem and your Google Drive environment. It is designed to automate the process of uploading documents, datasets, or media files to the cloud while maintaining organizational integrity. The skill excels by automatically detecting MIME types, ensuring that PDFs, spreadsheets, and images are handled with the correct Google Drive metadata. By leveraging this tool, you can offload repetitive file management tasks to your OpenClaw agent, effectively turning your local workspace into a bridge for your cloud storage architecture. It streamlines workflows by allowing you to specify parent directories via folder IDs, ensuring your files land exactly where they belong without requiring manual browser navigation.

Installation

To integrate this skill into your environment, use the OpenClaw repository installer. Execute the following command in your terminal: clawhub install openclaw/skills/skills/googleworkspace-bot/gws-drive-upload. Before running, ensure that your gws-shared prerequisites are met. If the authentication configuration is missing, run gws generate-skills to initialize your credentials and security rules. Once installed, the gws drive +upload command becomes immediately available for your agent to execute.

Use Cases

This skill is indispensable for professionals dealing with automated reporting and data synchronization. Common use cases include pushing generated data exports directly from a local build folder to a team-shared Google Drive, backing up specific project assets periodically, and archiving completed documentation without leaving your current context. It is especially useful for developers who need to export build artifacts or test results into a shared drive for stakeholder review.

Example Prompts

1. "Upload my latest Q3-Financial-Report.pdf to the shared team folder with ID 1abc2DEFg3HIJ."
2. "I have a file named raw_data_v2.csv in my local folder. Can you please upload this to Google Drive and rename it to 'Quarterly Sales Data'?"
3. "OpenClaw, please upload the current directory's build report to my Drive so the design team can access it."

Tips & Limitations

Always remember that the +upload command is a write operation, and as such, it requires user confirmation to prevent accidental data overwrites or incorrect placements. The skill will automatically infer filenames from your file path, but you can override this behavior using the --name flag for better organization. Since MIME detection is handled automatically, you don't need to specify file formats, but ensure your system has appropriate permissions to the target Google Drive directory. Be mindful of storage quotas and network bandwidth, as large file uploads are subject to your internet connection speed and your account's storage capacity.