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:

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:

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

File browsing & search

File content

Upload operations

File/folder operations

Sharing & collaboration

Shared folders

Shared files

File properties & tags

File requests

Copy references

Async job status

Contacts

File locking

Paper

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

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.