Dropbox

What This Skill Does

The Dropbox skill by ryanlisse is a high-performance, Swift-native interface that allows the OpenClaw agent to interact directly with your Dropbox storage. By utilizing the official SwiftyDropbox SDK, the skill provides a robust bridge between local operations and the cloud. It is designed with a heavy emphasis on security, implementing OAuth 2.0 with PKCE (Proof Key for Code Exchange) and utilizing the macOS Keychain for secure token storage. Whether you need to list directory contents, perform complex searches, upload local files, or retrieve account information, this skill provides a seamless MCP-powered gateway to manage your digital workspace without ever leaving your terminal or agent interface.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/ryanlisse/dropbox

Ensure you have your Dropbox App Key and Secret configured. You can initialize authentication by running make login within the cloned repository directory, which securely stores your access and refresh tokens using hardware-backed encryption.

Use Cases

This skill is ideal for automating file organization and retrieval tasks. Use it to:

• Automate backups of local project folders to a dedicated Dropbox archive.
• Search for specific project documents across large cloud-hosted folder structures.
• Sync notes or configuration files between local development environments and Dropbox.
• Quickly retrieve and review documents from an AI-driven chat session.

Example Prompts

1. "Search my Dropbox for any files related to 'Project Alpha' and tell me how many results you found."
2. "List the files in my '/Documents/Invoices' folder and then download 'invoice_october.pdf' to my desktop."
3. "Upload the file located at '/Users/me/reports/quarterly_review.docx' to my Dropbox root folder."

Tips & Limitations

• Always prefer the OAuth login method over manual environment variable tokens to ensure you benefit from automatic token refreshing.
• The skill currently handles files and folders natively; however, performance on extremely large directories may vary.
• Remember that 'delete' actions move files to the Dropbox trash, allowing for a safety buffer before permanent deletion. Ensure your Dropbox App permissions include both read and write access to function correctly.