百度网盘 Skill (Baidu Netdisk Skill)
AI Agent 的云端数据连接器 | Cloud Data Connector for AI Agents —— 无需本地存储即可访问百度网盘文件
安全状态：✅ 已自审 | 🔒 Token 加密存储 | 🌐 仅调用百度官方 API
简介
百度网盘 Skill 是一个专为 OpenClaw 设计的命令行工具，支持文件列表、搜索、下载、上传等核心功能。
核心优势：
- - 🔐 OAuth 一键授权 - 1 分钟完成，无需申请百度 API（推荐）
- ☁️ 云端零存储 - 流式读取，不占用本地磁盘空间
- 🗂️ 深层文件夹遍历 - 支持 4 层 + 深度目录
- 🔒 Token 加密存储 - 本地安全
- 🔧 灵活认证 - 支持自带 API key（适合高用量用户）
安装
CODEBLOCK0
授权（首次使用）
方式一：OAuth 一键授权 ⭐ 推荐
适合大多数用户，无需申请百度 API：
CODEBLOCK1
按提示操作：
- 1. 打开授权 URL
- 登录百度账号
- 授权应用
- 复制授权码粘贴回终端
方式二：自带 API key 🔧 高级
适合高用量用户或技术用户，使用自己的百度 API 配额：
CODEBLOCK2
获取 API key 步骤：
- 1. 访问 百度开放平台
- 创建应用获取 API Key 和 Secret Key
- 按提示完成授权获取 Access Token
使用示例
查看用户信息
CODEBLOCK3
列出文件
CODEBLOCK4
搜索文件
CODEBLOCK5
获取下载链接
CODEBLOCK6
上传文件
CODEBLOCK7
配置项
| 配置项 | 说明 | 必填 |
|---|
| INLINECODE0 | 百度 API Key（自带 API key 模式使用） | 否 |
| INLINECODE1 |
百度 Secret Key（自带 API key 模式使用） | 否 |
|
accessToken | Access Token（OAuth 授权后自动保存） | 否 |
|
refreshToken | Refresh Token（OAuth 授权后自动保存） | 否 |
|
encryptionKey | 自定义加密密钥（可选，增强安全性） | 否 |
安全说明
- - ✅ Token 本地加密存储（AES-256）
- ✅ 仅调用百度官方 API
- ✅ 代码开源可审计
- ✅ 无数据收集
注意：删除操作不可恢复，请谨慎使用。
常见问题
Q: 授权后提示凭证无效？
A: 授权码有效期较短，请在 5 分钟内完成授权。如已过期，重新运行 npx baidu-netdisk-auth。
Q: 列出文件时提示权限不足？
A: 请确认已正确完成 OAuth 授权，或检查 BDUSS/STOKEN 是否有效。
Q: 支持大文件上传吗？
A: 支持，但大文件上传时间较长，建议在稳定网络环境下使用。
更多文档
Made with ❤️ by Miaozai Studio百度网盘 Skill (Baidu Netdisk Skill)
AI Agent 的云端数据连接器 | Cloud Data Connector for AI Agents —— 无需本地存储即可访问百度网盘文件
安全状态：✅ 已自审 | 🔒 Token 加密存储 | 🌐 仅调用百度官方 API
简介
百度网盘 Skill 是一个专为 OpenClaw 设计的命令行工具，支持文件列表、搜索、下载、上传等核心功能。
核心优势：
- - 🔐 OAuth 一键授权 - 1 分钟完成，无需申请百度 API（推荐）
- ☁️ 云端零存储 - 流式读取，不占用本地磁盘空间
- 🗂️ 深层文件夹遍历 - 支持 4 层 + 深度目录
- 🔒 Token 加密存储 - 本地安全
- 🔧 灵活认证 - 支持自带 API key（适合高用量用户）
安装
bash
npx skills install github:niukesi/baidu-netdisk-skill
授权（首次使用）
方式一：OAuth 一键授权 ⭐ 推荐
适合大多数用户，无需申请百度 API：
bash
npx baidu-netdisk-auth
按提示操作：
- 1. 打开授权 URL
- 登录百度账号
- 授权应用
- 复制授权码粘贴回终端
方式二：自带 API key 🔧 高级
适合高用量用户或技术用户，使用自己的百度 API 配额：
bash
npx baidu-netdisk-skill config -k -s -t
获取 API key 步骤：
- 1. 访问 百度开放平台
- 创建应用获取 API Key 和 Secret Key
- 按提示完成授权获取 Access Token
使用示例
查看用户信息
bash
npx baidu-netdisk-skill whoami
列出文件
bash
根目录
npx baidu-netdisk-skill list /
指定目录（支持深层文件夹）
npx baidu-netdisk-skill list /教程/第一层/第二层
搜索文件
bash
npx baidu-netdisk-skill search 关键词
获取下载链接
bash
npx baidu-netdisk-skill download
上传文件
bash
npx baidu-netdisk-skill upload ./本地文件.pdf /备份/
配置项
| 配置项 | 说明 | 必填 |
|---|
| apiKey | 百度 API Key（自带 API key 模式使用） | 否 |
| secretKey |
百度 Secret Key（自带 API key 模式使用） | 否 |
| accessToken | Access Token（OAuth 授权后自动保存） | 否 |
| refreshToken | Refresh Token（OAuth 授权后自动保存） | 否 |
| encryptionKey | 自定义加密密钥（可选，增强安全性） | 否 |
安全说明
- - ✅ Token 本地加密存储（AES-256）
- ✅ 仅调用百度官方 API
- ✅ 代码开源可审计
- ✅ 无数据收集
注意：删除操作不可恢复，请谨慎使用。
常见问题
Q: 授权后提示凭证无效？
A: 授权码有效期较短，请在 5 分钟内完成授权。如已过期，重新运行 npx baidu-netdisk-auth。
Q: 列出文件时提示权限不足？
A: 请确认已正确完成 OAuth 授权，或检查 BDUSS/STOKEN 是否有效。
Q: 支持大文件上传吗？
A: 支持，但大文件上传时间较长，建议在稳定网络环境下使用。
更多文档
Made with ❤️ by Miaozai Studio
