{"skill":{"slug":"dropbox-files","displayName":"Dropbox","summary":"Browse, search, upload, download, and manage files and folders in Dropbox — powered by ClawLink.","description":"---\nname: dropbox-files\ndescription: Browse, search, upload, download, and manage files and folders in Dropbox — powered by ClawLink.\n---\n\n# Dropbox\n\n![Dropbox](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/brand-logos/dropbox.svg)\n\nWork with Dropbox from chat — browse, search, upload, download, and manage files and folders.\n\nPowered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=dropbox-files), an integration hub for OpenClaw that handles hosted connection flows and credentials so you don't need to configure Dropbox API access yourself.\n\n### Setup in 3 Steps\n\n| Step 1: Install | Step 2: Pair Account | Step 3: Connect Dropbox |\n|:---:|:---:|:---:|\n| ![Install](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/pairing/initialstep_1.gif) | ![Pair](https://raw.githubusercontent.com/ClawLink-HQ/clawlink/main/public/images/approve_process.gif) | *App-specific connection GIF coming soon* |\n| Run the install command in OpenClaw | Sign in and approve the device | Open the dashboard and connect Dropbox |\n\n## Connection flow\n\n```\nUser → ClawLink OAuth → Dropbox account\n         ↓\n    OpenClaw tools\n    (via ClawLink)\n```\n\n**Step 1** — Install the ClawLink plugin:\n```\nopenclaw plugins install clawhub:clawlink-plugin\n```\nStart a fresh chat after installing.\n\n**Step 2** — Pair ClawLink:\n1. Call `clawlink_begin_pairing`\n2. Open the returned URL in your browser\n3. Sign in to ClawLink and approve the device\n\n**Step 3** — Connect Dropbox:\nOpen [claw-link.dev/dashboard?add=dropbox](https://claw-link.dev/dashboard?add=dropbox), complete the OAuth flow, then confirm.\n\n*App-specific connection GIF coming soon*\n\n**Step 4** — Verify and discover:\n```javascript\n// 1. Verify Dropbox is connected\nclawlink_list_integrations()\n\n// 2. List available tools\nclawlink_list_tools({ integration: \"dropbox\" })\n\n// 3. Search tools if needed\nclawlink_search_tools({ query: \"upload\", integration: \"dropbox\" })\n```\n\n## Architecture\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                    OpenClaw (you)                       │\n├─────────────────────────────────────────────────────────┤\n│  ClawLink Plugin  →  clawlink_* tools                   │\n├─────────────────────────────────────────────────────────┤\n│                    ClawLink Cloud                       │\n│         (credentials, connection state, routing)        │\n├─────────────────────────────────────────────────────────┤\n│             Dropbox API (user's account)                │\n└─────────────────────────────────────────────────────────┘\n```\n\n## Tool reference\n\n### Account & identity\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_check_user` | Test API connection and validate access token | safe |\n| `dropbox_get_about_me` | Get current user's account info (email, name, type) | safe |\n| `dropbox_get_account` | Get account info by account ID | safe |\n| `dropbox_get_account_batch` | Get multiple accounts at once (max 300) | safe |\n| `dropbox_get_space_usage` | Get storage usage and quota info | safe |\n| `dropbox_get_user_features` | Get enabled features (paper_as_files, file_locking, etc.) | safe |\n| `dropbox_get_openid_config` | Get Dropbox OpenID Connect discovery document | safe |\n| `dropbox_get_jwks` | Get public keys for JWT verification | safe |\n\n### File browsing & search\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_list_files_in_folder` | List files and folders in a directory | safe |\n| `dropbox_list_folder_continue` | Paginate through folder contents with cursor | safe |\n| `dropbox_get_metadata` | Get metadata for a file or folder by path | safe |\n| `dropbox_get_metadata_alpha` | Get metadata with advanced property filtering | safe |\n| `dropbox_list_file_revisions` | Get revision history for a file | safe |\n| `dropbox_files_search` | Search files and folders by name or content | safe |\n| `dropbox_search_continue` | Fetch next page of search results | safe |\n| `dropbox_search_file_or_folder` | Search for a specific file or folder | safe |\n| `dropbox_list_paper_docs` | List all Paper docs | safe |\n| `dropbox_list_paper_docs_continue` | Paginate through Paper docs | safe |\n\n### File content\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_read_file` | Download file content (base64-encoded binary) | safe |\n| `dropbox_get_file_preview` | Get file preview (PDF as PDF, spreadsheets as HTML) | safe |\n| `dropbox_get_thumbnail` | Get image thumbnail | safe |\n| `dropbox_get_thumbnail_batch` | Get thumbnails for multiple images (max 25) | safe |\n| `dropbox_get_thumbnail_v2` | Get image thumbnail (supports shared links) | safe |\n| `dropbox_download_zip` | Download folder as zip (max 20GB, 10000 entries) | safe |\n| `dropbox_export_file` | Export non-downloadable files (Paper, Google Docs) to Markdown/HTML | safe |\n| `dropbox_get_temporary_link` | Get expiring download link (expires in hours) | safe |\n\n### Upload operations\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_alpha_upload_file` | Upload file up to 150 MiB (alpha endpoint) | confirm |\n| `dropbox_append_upload_session` | Append data to upload session (max 150 MiB/request) | confirm |\n| `dropbox_append_upload_session_batch` | Append to multiple upload sessions at once | confirm |\n| `dropbox_finish_upload_session` | Finish upload session and save to path | confirm |\n| `dropbox_finish_upload_session_batch` | Finish multiple upload sessions at once | confirm |\n| `dropbox_get_temporary_upload_link` | Get one-time expiring upload link (valid 4 hours) | confirm |\n| `dropbox_save_url` | Save file directly from a public URL (async, up to 15 min) | confirm |\n\n### File/folder operations\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_copy_file_or_folder` | Copy file or folder to a new location | confirm |\n| `dropbox_copy_batch` | Copy multiple files/folders at once | confirm |\n| `dropbox_move_file_or_folder` | Move file or folder | confirm |\n| `dropbox_move_batch` | Move multiple files/folders at once | confirm |\n| `dropbox_delete_file` | Permanently delete file or folder | high_impact |\n| `dropbox_delete_batch` | Delete multiple files/folders at once | high_impact |\n| `dropbox_restore_file` | Restore file to a specific revision | confirm |\n| `dropbox_create_folder` | Create new folder at path | confirm |\n| `dropbox_create_folder_batch` | Create multiple folders at once | confirm |\n\n### Sharing & collaboration\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_create_shared_link` | Create permanent shared link | confirm |\n| `dropbox_list_shared_links` | List existing shared links (filter by path) | safe |\n| `dropbox_modify_shared_link_settings` | Change visibility, access, expiration, password | confirm |\n| `dropbox_revoke_shared_link` | Revoke a shared link | high_impact |\n| `dropbox_get_shared_link_file` | Download file from shared link | safe |\n| `dropbox_get_shared_link_metadata` | Resolve shared link URL to metadata | safe |\n\n### Shared folders\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_list_shared_folders` | List all accessible shared folders | safe |\n| `dropbox_list_folders_continue` | Paginate through shared folders | safe |\n| `dropbox_get_shared_folder_metadata` | Get shared folder details by ID | safe |\n| `dropbox_list_folder_members` | List members of a shared folder | safe |\n| `dropbox_list_folder_members_continue` | Paginate through folder members | safe |\n| `dropbox_mount_folder` | Mount a shared folder to access it | confirm |\n| `dropbox_list_mountable_folders` | List mountable (unmounted) shared folders | safe |\n| `dropbox_list_mountable_folders_continue` | Paginate through mountable folders | safe |\n| `dropbox_remove_folder_member` | Remove member from shared folder | high_impact |\n| `dropbox_add_folder_member_action` | Add member to shared folder with access level | confirm |\n\n### Shared files\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_get_shared_file_metadata` | Get shared file metadata | safe |\n| `dropbox_get_file_metadata_batch` | Get metadata for multiple shared files | safe |\n| `dropbox_list_file_members` | List members with access to a shared file | safe |\n| `dropbox_list_file_members_batch` | List members for multiple shared files | safe |\n| `dropbox_add_file_member` | Add member to shared file | confirm |\n| `dropbox_remove_file_member` | Remove member from shared file | high_impact |\n\n### File properties & tags\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_add_file_properties` | Add custom properties from a property template | confirm |\n| `dropbox_overwrite_file_properties` | Overwrite property groups on a file | confirm |\n| `dropbox_remove_file_properties` | Remove property groups from a file | high_impact |\n| `dropbox_list_user_templates` | Get available custom property templates | safe |\n| `dropbox_add_file_tags` | Add a tag to a file or folder | confirm |\n| `dropbox_get_file_tags` | Get tags assigned to files/folders | safe |\n| `dropbox_remove_file_tag` | Remove a tag from a file or folder | high_impact |\n\n### File requests\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_create_file_request` | Create a file request (upload link) | confirm |\n| `dropbox_get_file_request` | Get file request details by ID | safe |\n| `dropbox_list_file_requests` | List all file requests | safe |\n| `dropbox_list_file_requests_continue` | Paginate through file requests | safe |\n| `dropbox_delete_file_requests` | Delete a batch of closed file requests | high_impact |\n| `dropbox_delete_all_closed_file_requests` | Delete all closed file requests | high_impact |\n| `dropbox_count_file_requests` | Count total file requests | safe |\n\n### Copy references\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_get_copy_reference` | Get a copy reference for a file/folder | safe |\n| `dropbox_save_copy_reference` | Save a copy reference to user's Dropbox | confirm |\n\n### Async job status\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_check_copy_batch` | Check async copy batch job status | safe |\n| `dropbox_check_delete_batch` | Check async delete batch job status | safe |\n| `dropbox_check_folder_batch` | Check async folder creation job status | safe |\n| `dropbox_check_job_status` | Check async sharing job status | safe |\n| `dropbox_check_move_batch` | Check async move batch job status | safe |\n| `dropbox_check_remove_member` | Check async remove folder member job status | safe |\n| `dropbox_check_save_url_status` | Check save_url job status | safe |\n| `dropbox_check_share_job_status` | Check async folder sharing job status | safe |\n| `dropbox_check_upload_batch` | Check async upload batch job status | safe |\n\n### Contacts\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_delete_manual_contacts_batch` | Delete manually added contacts | high_impact |\n\n### File locking\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_get_file_lock_batch` | Get lock metadata for multiple files | safe |\n\n### Paper\n\n| Tool | Description | Risk |\n|------|-------------|------|\n| `dropbox_create_paper_document` | Create Paper doc from HTML/Markdown | confirm |\n| `dropbox_create_paper_folder` | Create Paper folder | confirm |\n\n## Code examples\n\n### Example 1: Browse and search files\n\n```javascript\n// List files in a folder\nconst files = await clawlink_call_tool({\n  tool: \"dropbox_list_files_in_folder\",\n  parameters: { path: \"/Documents\" }\n});\n\n// Search for files\nconst searchResults = await clawlink_call_tool({\n  tool: \"dropbox_files_search\",\n  parameters: {\n    query: \"report\",\n    path: \"/Documents\"\n  }\n});\n\n// Get file metadata\nconst meta = await clawlink_call_tool({\n  tool: \"dropbox_get_metadata\",\n  parameters: { path: \"/Documents/report.pdf\" }\n});\n```\n\n### Example 2: Upload a file\n\n```javascript\n// Upload a file directly\nconst upload = await clawlink_call_tool({\n  tool: \"dropbox_alpha_upload_file\",\n  parameters: {\n    path: \"/Documents/new-file.txt\",\n    contents: base64EncodedContent\n  }\n});\n\n// Or get a temporary upload link for larger files\nconst uploadLink = await clawlink_call_tool({\n  tool: \"dropbox_get_temporary_upload_link\",\n  parameters: {}\n});\n```\n\n### Example 3: Share and manage sharing\n\n```javascript\n// Create a shared link\nconst sharedLink = await clawlink_call_tool({\n  tool: \"dropbox_create_shared_link\",\n  parameters: {\n    path: \"/Documents/report.pdf\",\n    settings: {\n      requested_visibility: \"public\"\n    }\n  }\n});\n\n// List existing shared links\nconst links = await clawlink_call_tool({\n  tool: \"dropbox_list_shared_links\",\n  parameters: { path: \"/Documents/report.pdf\" }\n});\n\n// Add a member to a shared file\nawait clawlink_call_tool({\n  tool: \"dropbox_add_file_member\",\n  parameters: {\n    path: \"/Documents/report.pdf\",\n    members: [{ email: \"colleague@example.com\" }],\n    access_level: \"viewer\"\n  }\n});\n```\n\n### Example 4: Manage shared folders\n\n```javascript\n// List shared folders\nconst sharedFolders = await clawlink_call_tool({\n  tool: \"dropbox_list_shared_folders\",\n  parameters: {}\n});\n\n// Mount a shared folder\nawait clawlink_call_tool({\n  tool: \"dropbox_mount_folder\",\n  parameters: { shared_folder_id: \"123456789\" }\n});\n\n// List members of a shared folder\nconst members = await clawlink_call_tool({\n  tool: \"dropbox_list_folder_members\",\n  parameters: { shared_folder_id: \"123456789\" }\n});\n```\n\n## Error handling\n\n| Error pattern | Likely cause | Resolution |\n|---------------|--------------|------------|\n| `path_not_found` | File/folder doesn't exist at that path | Verify path with `dropbox_list_files_in_folder` |\n| `too_many_entries` | Zip download exceeds 10,000 entries or 20GB | Download in smaller batches |\n| `access_denied` | No permission for that path | Check if file is in a shared folder user has access to |\n| `shared_link_already_exists` | Link already exists for that path | Use `dropbox_list_shared_links` to retrieve existing link |\n| `app_folder_permission_incompatible` | Operation not supported for app folder | Some operations require full Dropbox access |\n| `file_locked` | File is locked by another user | Use `dropbox_get_file_lock_batch` to check lock status |\n\n## Security & Permissions\n\n- ClawLink stores only the OAuth token, never raw credentials\n- Device credentials are stored locally in OpenClaw plugin config\n- `files.content.read` scope is required for `dropbox_read_file`\n- Some operations not supported for apps with app folder permission\n\n## Troubleshooting\n\n**Tools not showing up after install:**\n- Start a fresh OpenClaw chat to reload the plugin catalog\n- Call `clawlink_list_integrations` to confirm ClawLink is paired\n\n**\"Path not found\" on file that exists:**\n- File may be in a shared folder not yet mounted\n- Call `dropbox_list_shared_folders` and mount if needed\n- File may be in a team folder requiring different permissions\n\n**Upload fails for large files:**\n- Use upload sessions (`upload_session/start` → `append` → `finish`)\n- Single request max is 150 MiB; max file size via sessions is ~2 TB\n- Consider using `dropbox_get_temporary_upload_link` for delayed upload\n\n---\n\nPowered by [ClawLink](https://claw-link.dev/?utm_source=clawhub&utm_medium=referral&utm_content=dropbox-files) — your OpenClaw integration hub for Dropbox.","tags":{"latest":"1.0.5"},"stats":{"comments":0,"downloads":1739,"installsAllTime":66,"installsCurrent":11,"stars":7,"versions":7},"createdAt":1777821488155,"updatedAt":1780988807949},"latestVersion":{"version":"1.0.5","createdAt":1780988807949,"changelog":"Add UTM attribution tags (utm_source=clawhub) to ClawLink branding links so visits from this skill page are tracked as a distinct traffic source.","license":"MIT-0"},"metadata":null,"owner":{"handle":"hith3sh","userId":"s173vws87a7ss71xf9rq53k5gd8568kv","displayName":"Jay","image":"https://avatars.githubusercontent.com/u/83839061?v=4"},"moderation":null}