技能版本 1.0.0

百度网盘官方skill (baidu-drive)

为 OpenClaw 等 AI Agent 打造的百度网盘官方存储与交付能力扩展。通过自然语言交互,让 Agent 获得文件上传、下载、分享、搜索、管理等完整云端操作能力,打通 AI 生成到成果落地的“最后一公里”。 依托百度网盘 10 亿用户的存储底座与开放平台 API,baidu drive skill 为 Agent 装备了“随身记忆”与“云端大脑”——换设备时记忆同步、跨端无缝接续;生成的文件一键归档、一键交付,让 AI 从“只会聊天”进化为“能干活”的数字员工。

价格

免费

  • 安装:免费

在组织开通时一次性收取;再次读取清单或下载不重复收费。

以上为公开标价。你的组织可能有协议价,以控制台显示的价格为准。

如何使用

  1. 为组织安装

    开通即安装:组织固定使用开通时的版本(当前为 1.0.0)。升级到新版本需要取消后重新开通。

  2. 创建凭证

    客户端使用组织凭证读取;绑定到数字人后,数字人使用绑定凭证按需加载。请求中携带:

    Authorization: Bearer $ZGI_MARKET_KEY

  3. 读取清单与安装包

    清单列出版本、文件和校验值;安装包是一个 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

来源与审核

审核状态
尚未审核,内容来自上游来源
许可证
未说明

审核状态是平台对上架信息的记录,不构成对上游服务质量或可用性的担保。