Dropbox

Browse, search, upload, download, and manage files and folders in Dropbox — powered by ClawLink.

Install

openclaw skills install @hith3sh/dropbox-files

Dropbox

Work with Dropbox from chat — browse, search, upload, download, and manage files and folders.

Powered by ClawLink, an integration hub for OpenClaw that handles hosted connection flows and credentials so you don't need to configure Dropbox API access yourself.

Setup in 3 Steps

Step 1: Install	Step 2: Pair Account	Step 3: Connect Dropbox
		App-specific connection GIF coming soon
Run the install command in OpenClaw	Sign in and approve the device	Open the dashboard and connect Dropbox

Connection flow

User → ClawLink OAuth → Dropbox account
         ↓
    OpenClaw tools
    (via ClawLink)

Step 1 — Install the ClawLink plugin:

openclaw plugins install clawhub:clawlink-plugin

Start a fresh chat after installing.

Step 2 — Pair ClawLink:

Call clawlink_begin_pairing
Open the returned URL in your browser
Sign in to ClawLink and approve the device

Step 3 — Connect Dropbox: Open claw-link.dev/dashboard?add=dropbox, complete the OAuth flow, then confirm.

App-specific connection GIF coming soon

Step 4 — Verify and discover:

// 1. Verify Dropbox is connected
clawlink_list_integrations()

// 2. List available tools
clawlink_list_tools({ integration: "dropbox" })

// 3. Search tools if needed
clawlink_search_tools({ query: "upload", integration: "dropbox" })

Architecture

┌─────────────────────────────────────────────────────────┐
│                    OpenClaw (you)                       │
├─────────────────────────────────────────────────────────┤
│  ClawLink Plugin  →  clawlink_* tools                   │
├─────────────────────────────────────────────────────────┤
│                    ClawLink Cloud                       │
│         (credentials, connection state, routing)        │
├─────────────────────────────────────────────────────────┤
│             Dropbox API (user's account)                │
└─────────────────────────────────────────────────────────┘

Tool reference

Account & identity

Tool	Description	Risk
`dropbox_check_user`	Test API connection and validate access token	safe
`dropbox_get_about_me`	Get current user's account info (email, name, type)	safe
`dropbox_get_account`	Get account info by account ID	safe
`dropbox_get_account_batch`	Get multiple accounts at once (max 300)	safe
`dropbox_get_space_usage`	Get storage usage and quota info	safe
`dropbox_get_user_features`	Get enabled features (paper_as_files, file_locking, etc.)	safe
`dropbox_get_openid_config`	Get Dropbox OpenID Connect discovery document	safe
`dropbox_get_jwks`	Get public keys for JWT verification	safe

File browsing & search

Tool	Description	Risk
`dropbox_list_files_in_folder`	List files and folders in a directory	safe
`dropbox_list_folder_continue`	Paginate through folder contents with cursor	safe
`dropbox_get_metadata`	Get metadata for a file or folder by path	safe
`dropbox_get_metadata_alpha`	Get metadata with advanced property filtering	safe
`dropbox_list_file_revisions`	Get revision history for a file	safe
`dropbox_files_search`	Search files and folders by name or content	safe
`dropbox_search_continue`	Fetch next page of search results	safe
`dropbox_search_file_or_folder`	Search for a specific file or folder	safe
`dropbox_list_paper_docs`	List all Paper docs	safe
`dropbox_list_paper_docs_continue`	Paginate through Paper docs	safe

File content

Tool	Description	Risk
`dropbox_read_file`	Download file content (base64-encoded binary)	safe
`dropbox_get_file_preview`	Get file preview (PDF as PDF, spreadsheets as HTML)	safe
`dropbox_get_thumbnail`	Get image thumbnail	safe
`dropbox_get_thumbnail_batch`	Get thumbnails for multiple images (max 25)	safe
`dropbox_get_thumbnail_v2`	Get image thumbnail (supports shared links)	safe
`dropbox_download_zip`	Download folder as zip (max 20GB, 10000 entries)	safe
`dropbox_export_file`	Export non-downloadable files (Paper, Google Docs) to Markdown/HTML	safe
`dropbox_get_temporary_link`	Get expiring download link (expires in hours)	safe

Upload operations

Tool	Description	Risk
`dropbox_alpha_upload_file`	Upload file up to 150 MiB (alpha endpoint)	confirm
`dropbox_append_upload_session`	Append data to upload session (max 150 MiB/request)	confirm
`dropbox_append_upload_session_batch`	Append to multiple upload sessions at once	confirm
`dropbox_finish_upload_session`	Finish upload session and save to path	confirm
`dropbox_finish_upload_session_batch`	Finish multiple upload sessions at once	confirm
`dropbox_get_temporary_upload_link`	Get one-time expiring upload link (valid 4 hours)	confirm
`dropbox_save_url`	Save file directly from a public URL (async, up to 15 min)	confirm

File/folder operations

Tool	Description	Risk
`dropbox_copy_file_or_folder`	Copy file or folder to a new location	confirm
`dropbox_copy_batch`	Copy multiple files/folders at once	confirm
`dropbox_move_file_or_folder`	Move file or folder	confirm
`dropbox_move_batch`	Move multiple files/folders at once	confirm
`dropbox_delete_file`	Permanently delete file or folder	high_impact
`dropbox_delete_batch`	Delete multiple files/folders at once	high_impact
`dropbox_restore_file`	Restore file to a specific revision	confirm
`dropbox_create_folder`	Create new folder at path	confirm
`dropbox_create_folder_batch`	Create multiple folders at once	confirm

Sharing & collaboration

Tool	Description	Risk
`dropbox_create_shared_link`	Create permanent shared link	confirm
`dropbox_list_shared_links`	List existing shared links (filter by path)	safe
`dropbox_modify_shared_link_settings`	Change visibility, access, expiration, password	confirm
`dropbox_revoke_shared_link`	Revoke a shared link	high_impact
`dropbox_get_shared_link_file`	Download file from shared link	safe
`dropbox_get_shared_link_metadata`	Resolve shared link URL to metadata	safe

Shared folders

Tool	Description	Risk
`dropbox_list_shared_folders`	List all accessible shared folders	safe
`dropbox_list_folders_continue`	Paginate through shared folders	safe
`dropbox_get_shared_folder_metadata`	Get shared folder details by ID	safe
`dropbox_list_folder_members`	List members of a shared folder	safe
`dropbox_list_folder_members_continue`	Paginate through folder members	safe
`dropbox_mount_folder`	Mount a shared folder to access it	confirm
`dropbox_list_mountable_folders`	List mountable (unmounted) shared folders	safe
`dropbox_list_mountable_folders_continue`	Paginate through mountable folders	safe
`dropbox_remove_folder_member`	Remove member from shared folder	high_impact
`dropbox_add_folder_member_action`	Add member to shared folder with access level	confirm

Shared files

Tool	Description	Risk
`dropbox_get_shared_file_metadata`	Get shared file metadata	safe
`dropbox_get_file_metadata_batch`	Get metadata for multiple shared files	safe
`dropbox_list_file_members`	List members with access to a shared file	safe
`dropbox_list_file_members_batch`	List members for multiple shared files	safe
`dropbox_add_file_member`	Add member to shared file	confirm
`dropbox_remove_file_member`	Remove member from shared file	high_impact

File properties & tags

Tool	Description	Risk
`dropbox_add_file_properties`	Add custom properties from a property template	confirm
`dropbox_overwrite_file_properties`	Overwrite property groups on a file	confirm
`dropbox_remove_file_properties`	Remove property groups from a file	high_impact
`dropbox_list_user_templates`	Get available custom property templates	safe
`dropbox_add_file_tags`	Add a tag to a file or folder	confirm
`dropbox_get_file_tags`	Get tags assigned to files/folders	safe
`dropbox_remove_file_tag`	Remove a tag from a file or folder	high_impact

File requests

Tool	Description	Risk
`dropbox_create_file_request`	Create a file request (upload link)	confirm
`dropbox_get_file_request`	Get file request details by ID	safe
`dropbox_list_file_requests`	List all file requests	safe
`dropbox_list_file_requests_continue`	Paginate through file requests	safe
`dropbox_delete_file_requests`	Delete a batch of closed file requests	high_impact
`dropbox_delete_all_closed_file_requests`	Delete all closed file requests	high_impact
`dropbox_count_file_requests`	Count total file requests	safe

Copy references

Tool	Description	Risk
`dropbox_get_copy_reference`	Get a copy reference for a file/folder	safe
`dropbox_save_copy_reference`	Save a copy reference to user's Dropbox	confirm

Async job status

Tool	Description	Risk
`dropbox_check_copy_batch`	Check async copy batch job status	safe
`dropbox_check_delete_batch`	Check async delete batch job status	safe
`dropbox_check_folder_batch`	Check async folder creation job status	safe
`dropbox_check_job_status`	Check async sharing job status	safe
`dropbox_check_move_batch`	Check async move batch job status	safe
`dropbox_check_remove_member`	Check async remove folder member job status	safe
`dropbox_check_save_url_status`	Check save_url job status	safe
`dropbox_check_share_job_status`	Check async folder sharing job status	safe
`dropbox_check_upload_batch`	Check async upload batch job status	safe

Contacts

Tool	Description	Risk
`dropbox_delete_manual_contacts_batch`	Delete manually added contacts	high_impact

File locking

Tool	Description	Risk
`dropbox_get_file_lock_batch`	Get lock metadata for multiple files	safe

Paper

Tool	Description	Risk
`dropbox_create_paper_document`	Create Paper doc from HTML/Markdown	confirm
`dropbox_create_paper_folder`	Create Paper folder	confirm

Code examples

Example 1: Browse and search files

// List files in a folder
const files = await clawlink_call_tool({
  tool: "dropbox_list_files_in_folder",
  parameters: { path: "/Documents" }
});

// Search for files
const searchResults = await clawlink_call_tool({
  tool: "dropbox_files_search",
  parameters: {
    query: "report",
    path: "/Documents"
  }
});

// Get file metadata
const meta = await clawlink_call_tool({
  tool: "dropbox_get_metadata",
  parameters: { path: "/Documents/report.pdf" }
});

Example 2: Upload a file

// Upload a file directly
const upload = await clawlink_call_tool({
  tool: "dropbox_alpha_upload_file",
  parameters: {
    path: "/Documents/new-file.txt",
    contents: base64EncodedContent
  }
});

// Or get a temporary upload link for larger files
const uploadLink = await clawlink_call_tool({
  tool: "dropbox_get_temporary_upload_link",
  parameters: {}
});

Example 3: Share and manage sharing

// Create a shared link
const sharedLink = await clawlink_call_tool({
  tool: "dropbox_create_shared_link",
  parameters: {
    path: "/Documents/report.pdf",
    settings: {
      requested_visibility: "public"
    }
  }
});

// List existing shared links
const links = await clawlink_call_tool({
  tool: "dropbox_list_shared_links",
  parameters: { path: "/Documents/report.pdf" }
});

// Add a member to a shared file
await clawlink_call_tool({
  tool: "dropbox_add_file_member",
  parameters: {
    path: "/Documents/report.pdf",
    members: [{ email: "colleague@example.com" }],
    access_level: "viewer"
  }
});

Example 4: Manage shared folders

// List shared folders
const sharedFolders = await clawlink_call_tool({
  tool: "dropbox_list_shared_folders",
  parameters: {}
});

// Mount a shared folder
await clawlink_call_tool({
  tool: "dropbox_mount_folder",
  parameters: { shared_folder_id: "123456789" }
});

// List members of a shared folder
const members = await clawlink_call_tool({
  tool: "dropbox_list_folder_members",
  parameters: { shared_folder_id: "123456789" }
});

Error handling

Error pattern	Likely cause	Resolution
`path_not_found`	File/folder doesn't exist at that path	Verify path with `dropbox_list_files_in_folder`
`too_many_entries`	Zip download exceeds 10,000 entries or 20GB	Download in smaller batches
`access_denied`	No permission for that path	Check if file is in a shared folder user has access to
`shared_link_already_exists`	Link already exists for that path	Use `dropbox_list_shared_links` to retrieve existing link
`app_folder_permission_incompatible`	Operation not supported for app folder	Some operations require full Dropbox access
`file_locked`	File is locked by another user	Use `dropbox_get_file_lock_batch` to check lock status

Security & Permissions

ClawLink stores only the OAuth token, never raw credentials
Device credentials are stored locally in OpenClaw plugin config
files.content.read scope is required for dropbox_read_file
Some operations not supported for apps with app folder permission

Troubleshooting

Tools not showing up after install:

Start a fresh OpenClaw chat to reload the plugin catalog
Call clawlink_list_integrations to confirm ClawLink is paired

"Path not found" on file that exists:

File may be in a shared folder not yet mounted
Call dropbox_list_shared_folders and mount if needed
File may be in a team folder requiring different permissions

Upload fails for large files:

Use upload sessions (upload_session/start → append → finish)
Single request max is 150 MiB; max file size via sessions is ~2 TB
Consider using dropbox_get_temporary_upload_link for delayed upload