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: InstallStep 2: Pair AccountStep 3: Connect Dropbox_App-specific connection GIF coming soon_Run the install command in OpenClawSign in and approve the deviceOpen the dashboard and connect Dropbox

Connection flow#

text

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

Step 1 — Install the ClawLink plugin:

text

openclaw plugins install clawhub:clawlink-plugin

Start a fresh chat after installing.

Step 2 — Pair ClawLink:

1. Call clawlink_begin_pairing
2. Open the returned URL in your browser
3. 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:

javascript

// 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#

text

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

Tool reference#

Account & identity#

ToolDescriptionRiskdropbox_check_userTest API connection and validate access tokensafedropbox_get_about_meGet current user's account info (email, name, type)safedropbox_get_accountGet account info by account IDsafedropbox_get_account_batchGet multiple accounts at once (max 300)safedropbox_get_space_usageGet storage usage and quota infosafedropbox_get_user_featuresGet enabled features (paper_as_files, file_locking, etc.)safedropbox_get_openid_configGet Dropbox OpenID Connect discovery documentsafedropbox_get_jwksGet public keys for JWT verificationsafe

File browsing & search#

ToolDescriptionRiskdropbox_list_files_in_folderList files and folders in a directorysafedropbox_list_folder_continuePaginate through folder contents with cursorsafedropbox_get_metadataGet metadata for a file or folder by pathsafedropbox_get_metadata_alphaGet metadata with advanced property filteringsafedropbox_list_file_revisionsGet revision history for a filesafedropbox_files_searchSearch files and folders by name or contentsafedropbox_search_continueFetch next page of search resultssafedropbox_search_file_or_folderSearch for a specific file or foldersafedropbox_list_paper_docsList all Paper docssafedropbox_list_paper_docs_continuePaginate through Paper docssafe

File content#

ToolDescriptionRiskdropbox_read_fileDownload file content (base64-encoded binary)safedropbox_get_file_previewGet file preview (PDF as PDF, spreadsheets as HTML)safedropbox_get_thumbnailGet image thumbnailsafedropbox_get_thumbnail_batchGet thumbnails for multiple images (max 25)safedropbox_get_thumbnail_v2Get image thumbnail (supports shared links)safedropbox_download_zipDownload folder as zip (max 20GB, 10000 entries)safedropbox_export_fileExport non-downloadable files (Paper, Google Docs) to Markdown/HTMLsafedropbox_get_temporary_linkGet expiring download link (expires in hours)safe

Upload operations#

ToolDescriptionRiskdropbox_alpha_upload_fileUpload file up to 150 MiB (alpha endpoint)confirmdropbox_append_upload_sessionAppend data to upload session (max 150 MiB/request)confirmdropbox_append_upload_session_batchAppend to multiple upload sessions at onceconfirmdropbox_finish_upload_sessionFinish upload session and save to pathconfirmdropbox_finish_upload_session_batchFinish multiple upload sessions at onceconfirmdropbox_get_temporary_upload_linkGet one-time expiring upload link (valid 4 hours)confirmdropbox_save_urlSave file directly from a public URL (async, up to 15 min)confirm

File/folder operations#

ToolDescriptionRiskdropbox_copy_file_or_folderCopy file or folder to a new locationconfirmdropbox_copy_batchCopy multiple files/folders at onceconfirmdropbox_move_file_or_folderMove file or folderconfirmdropbox_move_batchMove multiple files/folders at onceconfirmdropbox_delete_filePermanently delete file or folderhigh_impactdropbox_delete_batchDelete multiple files/folders at oncehigh_impactdropbox_restore_fileRestore file to a specific revisionconfirmdropbox_create_folderCreate new folder at pathconfirmdropbox_create_folder_batchCreate multiple folders at onceconfirm

Sharing & collaboration#

ToolDescriptionRiskdropbox_create_shared_linkCreate permanent shared linkconfirmdropbox_list_shared_linksList existing shared links (filter by path)safedropbox_modify_shared_link_settingsChange visibility, access, expiration, passwordconfirmdropbox_revoke_shared_linkRevoke a shared linkhigh_impactdropbox_get_shared_link_fileDownload file from shared linksafedropbox_get_shared_link_metadataResolve shared link URL to metadatasafe

Shared folders#

ToolDescriptionRiskdropbox_list_shared_foldersList all accessible shared folderssafedropbox_list_folders_continuePaginate through shared folderssafedropbox_get_shared_folder_metadataGet shared folder details by IDsafedropbox_list_folder_membersList members of a shared foldersafedropbox_list_folder_members_continuePaginate through folder memberssafedropbox_mount_folderMount a shared folder to access itconfirmdropbox_list_mountable_foldersList mountable (unmounted) shared folderssafedropbox_list_mountable_folders_continuePaginate through mountable folderssafedropbox_remove_folder_memberRemove member from shared folderhigh_impactdropbox_add_folder_member_actionAdd member to shared folder with access levelconfirm

Shared files#

ToolDescriptionRiskdropbox_get_shared_file_metadataGet shared file metadatasafedropbox_get_file_metadata_batchGet metadata for multiple shared filessafedropbox_list_file_membersList members with access to a shared filesafedropbox_list_file_members_batchList members for multiple shared filessafedropbox_add_file_memberAdd member to shared fileconfirmdropbox_remove_file_memberRemove member from shared filehigh_impact

File properties & tags#

ToolDescriptionRiskdropbox_add_file_propertiesAdd custom properties from a property templateconfirmdropbox_overwrite_file_propertiesOverwrite property groups on a fileconfirmdropbox_remove_file_propertiesRemove property groups from a filehigh_impactdropbox_list_user_templatesGet available custom property templatessafedropbox_add_file_tagsAdd a tag to a file or folderconfirmdropbox_get_file_tagsGet tags assigned to files/folderssafedropbox_remove_file_tagRemove a tag from a file or folderhigh_impact

File requests#

ToolDescriptionRiskdropbox_create_file_requestCreate a file request (upload link)confirmdropbox_get_file_requestGet file request details by IDsafedropbox_list_file_requestsList all file requestssafedropbox_list_file_requests_continuePaginate through file requestssafedropbox_delete_file_requestsDelete a batch of closed file requestshigh_impactdropbox_delete_all_closed_file_requestsDelete all closed file requestshigh_impactdropbox_count_file_requestsCount total file requestssafe

Copy references#

ToolDescriptionRiskdropbox_get_copy_referenceGet a copy reference for a file/foldersafedropbox_save_copy_referenceSave a copy reference to user's Dropboxconfirm

Async job status#

ToolDescriptionRiskdropbox_check_copy_batchCheck async copy batch job statussafedropbox_check_delete_batchCheck async delete batch job statussafedropbox_check_folder_batchCheck async folder creation job statussafedropbox_check_job_statusCheck async sharing job statussafedropbox_check_move_batchCheck async move batch job statussafedropbox_check_remove_memberCheck async remove folder member job statussafedropbox_check_save_url_statusCheck save_url job statussafedropbox_check_share_job_statusCheck async folder sharing job statussafedropbox_check_upload_batchCheck async upload batch job statussafe

Contacts#

ToolDescriptionRiskdropbox_delete_manual_contacts_batchDelete manually added contactshigh_impact

File locking#

ToolDescriptionRiskdropbox_get_file_lock_batchGet lock metadata for multiple filessafe

Paper#

ToolDescriptionRiskdropbox_create_paper_documentCreate Paper doc from HTML/Markdownconfirmdropbox_create_paper_folderCreate Paper folderconfirm

Code examples#

Example 1: Browse and search files#

javascript

// 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#

javascript

// 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#

javascript

// 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#

javascript

// 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 patternLikely causeResolutionpath_not_foundFile/folder doesn't exist at that pathVerify path with dropbox_list_files_in_folder``too_many_entriesZip download exceeds 10,000 entries or 20GBDownload in smaller batchesaccess_deniedNo permission for that pathCheck if file is in a shared folder user has access toshared_link_already_existsLink already exists for that pathUse dropbox_list_shared_links to retrieve existing linkapp_folder_permission_incompatibleOperation not supported for app folderSome operations require full Dropbox accessfile_lockedFile is locked by another userUse 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

---

Powered by ClawLink — your OpenClaw integration hub for Dropbox.