Dropbox 文件管理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-dropbox。
技能介绍
要解决什么问题
在 Agent 或 IDE 里做自动化时,经常需要读写 Dropbox 里的文件:列目录、搜文件名或正文、上传下载、删到回收站、读 UTF-8 文本。直接调 REST API 要自己管 OAuth、token 刷新和限流。本技能用 MCP 服务 和 CLI 封装这些能力,底层是 Swift + SwiftyDropbox,认证走 OAuth 2.0 PKCE,token 优先存 macOS Keychain。
核心能力与工作方式
启动 MCP 后,可通过工具完成:
list_directory:指定路径(默认/)列文件与文件夹search:按名称或内容搜索,可限定pathupload/download:本地与云端路径需为绝对路径;upload可选overwritedelete:删除路径对应项(进垃圾箱)read_file:仅支持 UTF-8 文本get_account_info:账户名与邮箱
认证推荐交互式 OAuth 登录:生成 PKCE、打开授权 URL、粘贴 code 换 access/refresh token,并自动刷新。Keychain 不可用时回退 ~/.dropbook/auth.json。大批量备份、同步建议文档中提到的 rclone,与 MCP 的分工是:代理式单文件操作用 MCP,海量传输用 rclone。
边界与注意点
- 环境变量手填 token 的 legacy 方式不支持自动刷新,生产环境应走 OAuth。
- API 有严格 rate limit,
too_many_requests时需退避;bulk 操作前先用list_directory校验路径。 read_file只适合文本,不适合二进制或大文件场景;大文件应用download到本地再处理。- MCP 配置依赖项目
.mcp.json与 Claude Code/Desktop 侧设置;常见错误见文档表(如notConfigured、itemNotFound需先make login)。
使用场景
- Claude 项目里要让 Agent 在 `/Projects/2024` 下列出文件再决定读哪一个
- 自动化流水线把本地构建产物上传到 Dropbox 固定 `remotePath` 并可选覆盖
- 在对话中按关键词搜索 Dropbox 全文,定位含某配置片段的 markdown
- 需要删除误传的共享目录子路径,且要求走垃圾箱而非本地假删
适合人员
- 维护多环境配置、要把密钥类文本从 Dropbox 只读拉进 Agent 上下文的 SRE
- 用 Claude Code 做项目自动化、需在会话内 upload/download 而不想写 Python Dropbox SDK 的工程师
- 在 macOS 上跑 MCP、希望 token 进 Keychain 并自动刷新的个人开发者
- 定期把网盘目录备份到 NAS/Time Capsule、会按文档用 rclone 配合本技能做大批量同步的运维