C
Cody
Productivity

Connecting OpenClaw with Dropbox: A Practical Guide

·3 min read

Dropbox is where many teams store their operational files, client deliverables, and shared documents. Connecting OpenClaw to Dropbox lets your team search for files, check folder contents, and generate share links without leaving Slack.

How OpenClaw Integrations Work

OpenClaw is a self-hosted AI assistant that runs on your own server — typically an EC2 instance — and connects to Slack. It uses Claude under the hood to process requests. Out of the box, OpenClaw doesn't ship with pre-built connections to third-party tools. Instead, integrations are built using the skills system: markdown files in ~/.openclaw/skills/ that give Claude instructions for a particular domain, combined with HTTP tool calls to any API you expose to it.

In practice, adding a real integration means: getting API credentials from the third-party service, building or configuring a small proxy/endpoint that OpenClaw can call, and writing a skill file that tells Claude how to use it. For some tools this is an afternoon of work. For others — like Dropbox — it's considerably more involved.

Connecting OpenClaw with Dropbox: Step by Step

Step 1: Create a Dropbox App and Get an Access Token

Go to dropbox.com/developers/apps and create a new app. Choose the appropriate access type — 'Full Dropbox' if you need access to all files, or 'App folder' for a sandboxed approach. Generate an access token from the app's settings page. The Dropbox API v2 base URL is https://api.dropboxapi.com/2/.

Step 2: Use Search and List Endpoints

Key endpoints: /files/search_v2 (full-text search across filenames and content), /files/list_folder (list contents of a directory), /files/get_metadata (file info including last modified date and size), /sharing/create_shared_link_with_settings (generate a share link for a file).

Step 3: Build the Proxy and Skill File

Build your proxy around file search and metadata endpoints. Write ~/.openclaw/skills/dropbox.md with the folder structure your team uses most, and instructions for Claude on how to present results (file name, last modified, direct link vs share link).

Challenges and Caveats

Full-Text Search Requires Content Indexing

Dropbox's search API searches file names by default. Full-text content search (finding a file that contains specific text) only works for indexed content types and may not cover all file formats. Test your search queries with real data before relying on them.

Token Expiry for Long-Lived Integrations

Long-lived access tokens from Dropbox app settings don't expire, but OAuth tokens from the standard auth flow do. If you're using the OAuth flow (rather than a personal access token), implement token refresh handling in your proxy.


Skip All of This — Use Cody Instead

Cody has Dropbox integration built in. Search files and generate share links from Slack without app configuration.

Get started with Cody →


Related Guides


Need the model-flexible version? See: How to Connect Dropbox to OpenClaw: Setup, Models, and Workflow Guide.