bdpan-storage 让 AI Agent 一句话操作你的网盘
一直以来，百度网盘在命令行生态里几乎是"隐形"的。想在终端里上传文件？要么用第三方工具（BaiduPCS-Go），要么老老实实打开客户端拖文件。
我的日常工作流是这样的：下载播客音频 → 转MP3 → 复制到百度云盘同步空间 → 等同步。中间还踩过一个坑——文件名里有 | 字符，百度网盘同步直接报错，文件名静默失败。于是我在 podcast-downloader 里加了一层文件名清洗，用 - 替换特殊字符。
这种"被动同步"模式有两个问题：
直到最近发现百度网盘官方出了一个 AI Agent Skill——bdpan-storage，才真正实现了"主动上传"。
为 Agent 构建可交付的数字记忆——百度网盘官方Skill，让 AI Agent 拥有上传、下载、分享、备份记忆等完整云端能力。
bdpan-storage 是百度网盘官方团队开发的 AI Agent Skill，适配 Claude Code、OpenClaw、Cursor、Gemini CLI 等主流 Agent 平台。它包含两部分：
GitHub 仓库：github.com/baidu-netdisk/bdpan-storage
安装一条命令：
npx skills add https://github.com/baidu-netdisk/bdpan-storage/skills --skill baidu-drive单文件/文件夹上传，支持递归和进度显示。远端路径自动创建目录。
直接下载或通过分享链接下载。大文件自动后台下载+进度轮询。
生成分享链接（1天/7天/30天/永久），自动返回提取码。
将分享链接内容转存到自己网盘，不下载到本地。
按关键词/类型搜索，支持视频/音频/图片/文档等分类过滤。
移动、复制、重命名、创建文件夹，完整的文件管理能力。
自动备份 Agent 的 Workspace 文件（AGENTS.md、MEMORY.md 等）到网盘，支持恢复。
所有命令支持 --json 标志，便于脚本解析和自动化。
| 命令 | 功能 | 示例 |
|---|---|---|
bdpan upload | 上传文件/文件夹 | bdpan upload ./file.pdf docs/file.pdf |
bdpan download | 下载文件/文件夹 | bdpan download docs/file.pdf ./file.pdf |
bdpan ls | 查看文件列表 | bdpan ls podcast/ --desc |
bdpan share | 创建分享链接 | bdpan share file.pdf --period 7 |
bdpan transfer | 转存分享链接 | bdpan transfer "https://..." -p abcd |
bdpan search | 搜索文件 | bdpan search 报告 --category 4 |
bdpan mv | 移动文件 | bdpan mv file.pdf backup/ |
bdpan cp | 复制文件 | bdpan cp file.pdf archive/ |
bdpan rename | 重命名 | bdpan rename old.pdf new.pdf |
bdpan mkdir | 创建文件夹 | bdpan mkdir projects/2026 |
bdpan whoami | 查看登录状态 | bdpan whoami |
这是我觉得最值得说的一点。作为一个第三方 CLI 工具，bdpan 的安全设计比很多同类工具都严格：
| 安全特性 | 说明 |
|---|---|
| 作用域隔离 | 所有操作限制在 /apps/bdpan/ 目录，无法访问用户其他文件 |
| 无删除命令 | 不提供 rm 命令，从根本上防止误删 |
| OAuth 2.0 | 授权码模式认证，不存储用户密码 |
| Token 保护 | 配置文件含 Token，Agent 禁止读取或输出其内容 |
| 安全传码 | 授权码通过 stdin 传递，不暴露在进程列表中 |
| SHA256 校验 | 安装和更新的二进制文件强制完整性校验 |
| 更新需确认 | 禁止自动或静默更新，必须用户明确指令并确认 |
| 修改前确认 | 移动、重命名、覆盖等操作执行前必须用户确认 |
当然，这也意味着一个限制——你不能用它管理网盘根目录的文件，只能操作 /apps/bdpan/ 下的内容。对于大多数场景够用了。
npx skills add https://github.com/baidu-netdisk/bdpan-storage/skills --skill baidu-drive安装完成后，首次使用会自动引导 CLI 安装和登录授权。
# macOS ARM64
bash ~/.openclaw/workspace/skills/baidu-drive/scripts/install.sh
# 登录
bash ~/.openclaw/workspace/skills/baidu-drive/scripts/login.sh支持三种登录方式：
# 设备码登录（推荐）
bdpan login --device-code --accept-disclaimer
# 查看登录状态
bdpan whoami我之前写过一个 podcast-downloader Skill，用于从小宇宙下载播客。现在集成 bdpan 后，整个流程变成了一条龙：
UPLOAD_TO_BDPAN=true ./download.sh "https://www.xiaoyuzhoufm.com/episode/xxx"/apps/bdpan/podcast/Episode ID: 694180874c65abaff3576bc4
Podcast: 张小珺Jùn｜商业访谈录
Title: 125. Freda的投资札记第1集
Downloading m4a... ████████████████████ 100%
Converting to mp3... ✓
Deleting m4a...
Saving show notes...
Uploading to Baidu Netdisk...
✓ MP3 uploaded
✓ Show notes uploaded
✓ Download complete!|、： 等特殊字符，百度网盘会报错。脚本自动用 - 替换，确保上传成功。
/apps/bdpan/
└── podcast/
├── 张小珺-125.Freda投资札记1/
│ ├── 125.Freda投资札记1-OpenAI-Robinhood.mp3
│ └── 125.Freda投资札记1-ShowNotes.md
├── 忽左忽右-线下录音｜对谈朱宁/
│ ├── 线下录音｜对谈朱宁.mp3
│ └── 线下录音｜对谈朱宁.md
└── 旺仔信箱-高考特别节目/
├── 高考特别节目.mp3
└── 高考特别节目.md用了一天，整体体验不错，但有几个地方我觉得可以改进：
errno=-7，没有 skip/overwrite/rsync 策略。--policy skip|overwrite|rsync 参数，让用户选择冲突处理方式。bdpan ls --json 检查远端是否已存在。
/apps/bdpan/ 目录，无法访问用户其他网盘文件。--scope extended 参数，允许用户授权访问更多目录。bdpan upload ./podcasts/*.mp3 podcast/ 这样的批量上传。sync 命令，无法实现本地目录与网盘的增量同步。bdpan sync ./local-dir/ remote-dir/，只上传新增/修改的文件。curl --progress-bar 的实现，显示上传速度、已传大小、预计剩余时间。
bdpan-storage 是百度网盘在 AI Agent 生态里的一次重要布局。虽然还是公测阶段，但核心功能已经可用，安全设计也比很多第三方工具严格。
大厂出品，安全第一，功能够用，还有进步空间。比起"百度网盘出了个 CLI 工具"，更值得关注的是"百度在认真对待 AI Agent 生态"这件事本身。