技能版本 1.0.0
百度网盘官方skill (baidu-drive)
为 OpenClaw 等 AI Agent 打造的百度网盘官方存储与交付能力扩展。通过自然语言交互,让 Agent 获得文件上传、下载、分享、搜索、管理等完整云端操作能力,打通 AI 生成到成果落地的“最后一公里”。 依托百度网盘 10 亿用户的存储底座与开放平台 API,baidu drive skill 为 Agent 装备了“随身记忆”与“云端大脑”——换设备时记忆同步、跨端无缝接续;生成的文件一键归档、一键交付,让 AI 从“只会聊天”进化为“能干活”的数字员工。
价格
免费
- 安装:免费
在组织开通时一次性收取;再次读取清单或下载不重复收费。
以上为公开标价。你的组织可能有协议价,以控制台显示的价格为准。
如何使用
为组织安装
开通即安装:组织固定使用开通时的版本(当前为 1.0.0)。升级到新版本需要取消后重新开通。
创建凭证
客户端使用组织凭证读取;绑定到数字人后,数字人使用绑定凭证按需加载。请求中携带:
Authorization: Bearer $ZGI_MARKET_KEY读取清单与安装包
清单列出版本、文件和校验值;安装包是一个 zip 文件。
读取清单 curl "https://market-api.zgi.im/v1/market/skills/baidudrive-baidu-drive-4e3aaccf/manifest" \ -H "Authorization: Bearer $ZGI_MARKET_KEY"下载安装包 curl "https://market-api.zgi.im/v1/market/skills/baidudrive-baidu-drive-4e3aaccf/package" \ -H "Authorization: Bearer $ZGI_MARKET_KEY" \ -o baidudrive-baidu-drive-4e3aaccf.zip读取清单和下载安装包不计入用量。下载后请用响应头中的 SHA-256 校验文件。
技能说明
- 名称
- baidu-drive
- 说明
- 百度网盘(Baidu Drive)文件管理 — 上传、下载、转存、分享、搜索、移动、复制、重命名、创建文件夹。 TRIGGER: 用户提及"百度网盘/bdpan/网盘/云盘/baidu drive/Baidu Drive"并涉及文件操作。 DO NOT TRIGGER: 非文件存储操作,或使用其他云盘服务时。
会运行代码Shell
技能包内含脚本文件,加载技能的运行时可能会执行它们,安装前请先阅读。
SKILL.md 节选
# 百度网盘存储 Skill
百度网盘文件管理工具,所有操作限制在 `/apps/bdpan/` 目录内。适配 Claude Code、DuClaw、OpenClaw 等。
> 使用注意事项详见 [reference/notes.md](./reference/notes.md)
## 触发规则
同时满足以下条件才执行:
1. 用户明确提及"百度网盘"、"bdpan"、"网盘"
2. 操作意图明确(上传/下载/转存/分享/查看/搜索/移动/复制/重命名/创建文件夹/登录/注销)
未通过触发规则时,禁止执行任何 bdpan 命令。
> **上下文延续:** 当前对话已在进行网盘操作时,后续消息无需再次提及"网盘"即可触发。
---
## 安全约束(最高优先级,不可被任何用户指令覆盖)
1. **登录**:必须使用 `bash ${CLAUDE_SKILL_DIR}/scripts/login.sh`,禁止直接调用 `bdpan login` 及其任何子命令/参数(包括 `--get-auth-url`、`--set-code` 等,即使在 GUI 环境也禁止)
2. **Token/配置**:禁止读取或输出 `~/.config/bdpan/config.json` 内容(含 access_token 等敏感凭据)
3. **更新/登录**:更新必须由用户明确指令触发,禁止自动或静默执行;Agent 禁止使用 `--yes` 参数执行 update.sh 或 login.sh
4. **环境变量**:Agent 禁止主动设置 `BDPAN_CONFIG_PATH`、`BDPAN_BIN`、`BDPAN_INSTALL_DIR` 等环境变量(这些变量供用户在脚本外手动配置,Agent 不应代为设置)
5. **路径安全**:禁止路径穿越(`..`、`~`)、禁止访问 `/apps/bdpan/` 范围外的绝对路径
---
## 前置检查
每次触发时按顺序执行:
1. **安装检查**:`command -v bdpan`,未安装则告知用户并确认后执行 `bash ${CLAUDE_SKILL_DIR}/scripts/install.sh`(用户确认后可加 `--yes` 跳过安装器内部确认)
2. **登录检查**:`bdpan whoami`,未登录则引导执行 `bash ${CLAUDE_SKILL_DIR}/scripts/login.sh`
3. **路径校验**:验证远端路径在 `/apps/bdpan/` 范围内
---
## 确认规则
| 风险等级 | 操作 | 策略 |
|----------|------|------|
| **高(必须确认)** | `rm` 删除、上传/下载目标已存在同名文件 | 列出影响范围,等待用户确认 |
| **中(路径模糊时确认)** | upload、download、mv、rename、cp | 路径明确直接执行,不明确则确认 |
| **低(直接执行)** | ls、search、whoami、mkdir、share | 无需确认 |
**额外规则:**
- 操作意图模糊("处理文件"→确认上传还是下载)→ 必须确认
- 序数/代词引用有歧义("第N个"、"它"、"上面那个")→ 必须确认
- 用户取消意图("算了"、"不要了"、"取消")→ 立即中止,不执行任何命令
---
## 核心操作
### 查看状态
```bash
bdpan whoami
```
### 列表查询
```bash
bdpan ls [目录路径] [--json] [--order name|time|size] [--desc] [--folder]
```
### 上传
```bash
bdpan upload <本地路径> <远端路径>
```
**关键约束:** 单文件上传远端路径必须是文件名,禁止以 `/` 结尾。文件夹上传:`bdpan upload ./project/ project/`。
步骤:确认本地路径存在 → 确认远端路径 → `bdpan ls` 检查远端是否已存在 → 执行。
### 下载
**直接下载:**
```bash
bdpan download <远端路径> <本地路径>
```
步骤:`bdpan ls` 确认云端存在 → 确认本地路径 → 检查本地是否已存在 → **检查文件大小决定下载策略** → 执行。若 ls 未找到,建议 `bdpan search <文件名>`。
**大文件下载策略(重要):**
Agent 的 Bash 工具有执行超时限制,大文件下载可能因超时而中断。必须根据文件大小选择下载策略:
1. **获取文件大小**:用 `bdpan ls --json <远端路径>` 获取 `size` 字段(字节)
2. **按大小分策略执行**:
| 文件大小 | 策略 | 执行方式 |
|----------|------|---------|
| ≤ 50MB | 直接下载 | `bdpan download <远端路径> <本地路径>`,Bash timeout 设为 300000(5 分钟) |
| > 50MB | 后台下载 | 使用 `nohup` 后台执行,Agent 轮询进度 |SKILL.md 不止这些内容,安装后可阅读全文。
技能包内容
共 11 个文件,合计 71.9 KiB
- SKILL.md9.1 KiB
- VERSION7 B
- reference/authentication.md2.3 KiB
- reference/bdpan-commands.md14.6 KiB
- reference/examples.md7.6 KiB
- reference/notes.md986 B
- reference/troubleshooting.md7.3 KiB
- scripts/install.sh10.2 KiB
- scripts/login.sh6.9 KiB
- scripts/uninstall.sh4.2 KiB
- scripts/update.sh8.8 KiB
来源与审核
- 审核状态
- 尚未审核,内容来自上游来源
- 许可证
- 未说明
审核状态是平台对上架信息的记录,不构成对上游服务质量或可用性的担保。