dropbox

What This Skill Does

The Dropbox skill enables OpenClaw AI agents to interface directly with the Dropbox API using managed OAuth authentication. By leveraging the Maton gateway, the skill allows for seamless file and folder manipulation without requiring users to manually manage individual OAuth tokens or credentials. It provides comprehensive capabilities for listing directory contents, managing file metadata, searching through stored files, and handling file revisions. The skill acts as a proxy, ensuring that all requests are authenticated securely while keeping the agent’s logic simple and focused on user-intent.

Installation

To integrate this skill, use the following command in your OpenClaw environment: clawhub install openclaw/skills/skills/byungkyu/dropbox-api After installation, ensure your MATON_API_KEY is set as an environment variable. Manage your specific Dropbox connections by navigating to https://ctrl.maton.ai, where you can initiate new OAuth handshakes to authorize your agent’s access to your Dropbox storage.

Use Cases

This skill is ideal for automating file-centric workflows. Common use cases include:

• Automated Organization: Periodically scanning a folder and moving files based on their naming convention or metadata.
• Content Retrieval: Quickly searching for specific documents within a large Dropbox hierarchy when requested by a user.
• Backup and Sync: Programmatically checking for the existence of backups or managing folder structures for project-based collaboration.
• Metadata Inspection: Fetching file details such as timestamps, sizes, and revision history to provide context in agent responses.

Example Prompts

1. "List all files in my 'Projects/Current' folder on Dropbox and tell me which one was modified most recently."
2. "Search my Dropbox for any documents containing the keyword 'Invoice' created in the last week."
3. "Check if 'backup.zip' exists in the root folder of my Dropbox account."

Tips & Limitations

• Security: Always verify the connection status at ctrl.maton.ai if your agent reports authentication errors. Never share your MATON_API_KEY in plain text logs.
• API Constraints: Dropbox API v2 requires all request bodies to be formatted as JSON. Ensure your logic adheres to the specific constraints of the target Dropbox endpoint.
• Connectivity: The skill requires active network access to the Maton gateway. If your local network is behind a strict firewall, ensure traffic to gateway.maton.ai is allowed.
• Scope: This skill is purpose-built for Dropbox. For integrations with other cloud storage providers like Google Drive or OneDrive, please utilize the api-gateway skill instead.