dropbox-integrationRead-only Dropbox integration for browsing, searching, and downloading files from your Dropbox account. Includes automatic OAuth token refresh, secure credential storage, and comprehensive setup guide. Perfect for accessing your Dropbox files from OpenClaw without giving write access.
Install via ClawdBot CLI:
clawdbot install tirandagan/dropbox-integrationThis skill provides read-only access to your Dropbox account, allowing you to browse folders, search files, and download content from OpenClaw. It uses OAuth 2.0 authentication with automatic token refresh for seamless long-term access.
Perfect for: Safely accessing your Dropbox files without worrying about accidental modifications or deletions.
This skill is configured for read-only access with the following Dropbox scopes:
files.metadata.read - Read file/folder metadatafiles.content.read - Read file contentaccount_info.read - Read account informationNOT included:
files.content.write - Cannot upload or modify filesfiles.metadata.write - Cannot rename or move filesfiles.permanent_delete - Cannot delete filesThis ensures your Dropbox content remains safe from accidental modifications.
Before using this skill, you need:
dropbox package (auto-installed)Setup time: ~10 minutes
See Setup Guide for step-by-step instructions.
Visit https://www.dropbox.com/developers/apps/create and create a new app:
In your app's settings:
http://localhost:3000/callbackfiles.metadata.readfiles.content.readaccount_info.readCreate credentials.json in the skill directory:
{
"app_key": "your_dropbox_app_key_here",
"app_secret": "your_dropbox_app_secret_here"
}Important: This file is gitignored and will never be committed.
node setup-oauth.jsThis will:
token.jsonnode test-connection.jsIf successful, you'll see your Dropbox account information!
# List root folder
node browse.js
# List specific folder
node browse.js "/Documents"
node browse.js "/Photos/2024"Output:
š Listing: /Documents
š report.pdf (2.3 MB) - 2024-02-01
š presentation.pptx (5.1 MB) - 2024-01-28
š Projects
š Archive
Total: 4 itemsnode search-files.js "budget 2024"
node search-files.js "contract"Output:
š Searching for: "budget 2024"
ā
Found 3 matches:
š /Finance/budget-2024-q1.xlsx
Size: 156.3 KB
Modified: 2024-01-15T10:30:00Z
š /Reports/budget-2024-summary.pdf
Size: 2.1 MB
Modified: 2024-02-01T14:22:00Z# Download to local file
node download.js "/Documents/report.pdf" "./downloads/report.pdf"
# Download to current directory
node download.js "/Photos/vacation.jpg" "./vacation.jpg"Output:
š„ Downloading: /Documents/report.pdf
ā
Saved to: ./downloads/report.pdf (2.3 MB)From OpenClaw, you can use the exec tool to run these scripts:
Browse files:
Run: node /path/to/dropbox-integration/browse.js "/Documents"Search for files:
Run: node /path/to/dropbox-integration/search-files.js "contract"Download a file:
Run: node /path/to/dropbox-integration/download.js "/path/in/dropbox" "./local/path"Or create custom automation workflows that use the dropbox-helper.js module directly.
token.jsondropbox-helper.jsdropbox-integration/
āāā SKILL.md # This file
āāā dropbox-helper.js # Auto-refresh Dropbox client
āāā setup-oauth.js # OAuth setup script
āāā browse.js # Browse folders
āāā search-files.js # Search files
āāā download.js # Download files
āāā test-connection.js # Test authentication
āāā credentials.json.example # Template for credentials
āāā .gitignore # Excludes credentials.json and token.json
āāā references/
āāā setup-guide.md # Detailed setup instructionsCreate credentials.json with your Dropbox app key and secret (see Quick Start step 3).
Your refresh token may have been revoked. Re-run node setup-oauth.js to re-authenticate.
Check that you enabled the required permissions in your Dropbox App settings under the Permissions tab.
Make sure you added http://localhost:3000/callback to your app's redirect URIs in Dropbox App Console.
If the local server doesn't catch the redirect, manually copy the full URL from your browser after authorization and look for the code= parameter.
credentials.json and token.json are gitignoredFor custom integrations, import the helper directly:
const { getDropboxClient } = require('./dropbox-helper');
async function myCustomFunction() {
const dbx = await getDropboxClient(); // Auto-refreshing client
// Use any Dropbox SDK method
const response = await dbx.filesListFolder({ path: '/Photos' });
console.log(response.result.entries);
}The helper automatically handles token refresh, so you never need to worry about expiration.
Download multiple files in sequence:
const { getDropboxClient } = require('./dropbox-helper');
const fs = require('fs').promises;
async function downloadMultiple(files) {
const dbx = await getDropboxClient();
for (const file of files) {
const response = await dbx.filesDownload({ path: file.dropboxPath });
await fs.writeFile(file.localPath, response.result.fileBinary);
console.log(`Downloaded: ${file.dropboxPath}`);
}
}This skill requires the dropbox npm package:
npm install dropboxThe package is automatically installed when you install this skill via ClawHub.
MIT - Free to use, modify, and distribute.
For issues or questions:
Note: This skill is designed for personal use. For production applications with multiple users, consider implementing proper OAuth flow with state management and error handling for concurrent users.
Generated Mar 1, 2026
Lawyers and paralegals can securely access case files, contracts, and legal documents stored in Dropbox for review during client meetings or remote work. The read-only access ensures no accidental modifications to sensitive legal materials, while search capabilities help quickly locate specific clauses or documents.
Researchers and students can browse and download shared academic papers, datasets, and project files from Dropbox for analysis or reference. The skill allows seamless access to collaborative folders without risking data loss from unintended edits, supporting remote education and team projects.
Marketing teams and content creators can search and retrieve images, videos, and branding assets from Dropbox for use in campaigns or presentations. Read-only access protects original media files from accidental deletion, while batch downloads streamline asset gathering for creative workflows.
Healthcare providers can access patient records, medical reports, and administrative documents stored in Dropbox for telemedicine consultations. The secure, read-only integration ensures compliance with data privacy regulations by preventing unauthorized modifications to critical health information.
Freelancers and consultants can download client files, project briefs, and deliverables from Dropbox to local systems for offline work. The skill simplifies file retrieval without needing full Dropbox sync, saving bandwidth and ensuring data integrity with no write permissions.
Offer this skill as a free add-on to attract users to a premium OpenClaw subscription with advanced features like analytics or multi-cloud support. Monetize through upsells to paid plans that include enhanced automation or priority support.
Package the skill as part of a custom enterprise toolkit for businesses needing secure, read-only Dropbox access in regulated industries. Charge per-user licenses or annual contracts with added services like custom integration support and compliance auditing.
List the skill on an AI agent marketplace where developers can purchase or subscribe to pre-built integrations. Generate revenue through one-time sales or recurring commissions, while offering optional customization services for specific use cases.
š¬ Integration Tip
Use the exec tool in OpenClaw to run the provided Node.js scripts directly, or integrate the dropbox-helper.js module into custom automation for seamless API calls with auto-refresh.
Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot
Perform advanced filesystem tasks including listing, recursive searching by name or content, batch copying/moving/deleting files, and analyzing directory siz...
Essential SSH commands for secure remote access, key management, tunneling, and file transfers.
Extract text from PDF files for LLM processing
The directory for AI agent services. Discover tools, platforms, and infrastructure built for agents.
Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot