← Back to Skills Marketplace
Baidupan
by
Robin-Lee-China
· GitHub ↗
· v1.0.0
· MIT-0
152
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install baidupan
Description
百度网盘自动化工具,支持上传、下载、列表、同步等操作。
README (SKILL.md)
BaiduPan(百度网盘)
百度网盘自动化工具,基于 bypy 实现。支持文件上传、下载、列表查看、同步等操作。
前置要求
首次使用需要授权登录:
# 运行授权命令
{baseDir}/scripts/auth.sh
# 按提示操作:
# 1. 复制显示的链接到浏览器打开
# 2. 登录百度账号并授权
# 3. 复制授权码
# 4. 粘贴回终端
授权一次,长期有效(直到百度token过期)。
核心功能
| 功能 | 命令 | 说明 |
|---|---|---|
| 查看网盘文件 | list.sh |
列出指定目录内容 |
| 下载文件 | download.sh |
从网盘下载到本地 |
| 上传文件 | upload.sh |
从本地上传到网盘 |
| 同步目录 | sync.sh |
双向或单向同步 |
| 查看配额 | quota.sh |
查看网盘空间使用情况 |
功能详解
1. 查看网盘文件 (list.sh)
# 列出根目录
{baseDir}/scripts/list.sh
# 列出指定目录
{baseDir}/scripts/list.sh /我的视频/项目
# 显示文件详情(含大小、修改时间)
{baseDir}/scripts/list.sh /我的视频 --detail
2. 下载文件 (download.sh)
# 下载单个文件到当前目录
{baseDir}/scripts/download.sh /我的视频/长城素材/video1.mp4
# 下载到指定目录
{baseDir}/scripts/download.sh /我的视频/长城素材/video1.mp4 --out ~/Downloads/
# 下载整个目录
{baseDir}/scripts/download.sh /我的视频/长城素材/ --out ~/Downloads/长城素材/
# 覆盖已存在文件
{baseDir}/scripts/download.sh /我的视频/video.mp4 --out ~/Downloads/ --force
3. 上传文件 (upload.sh)
# 上传单个文件到网盘根目录
{baseDir}/scripts/upload.sh ~/Downloads/video.mp4
# 上传到指定目录
{baseDir}/scripts/upload.sh ~/Downloads/video.mp4 --remote /我的视频/项目/
# 上传整个目录
{baseDir}/scripts/upload.sh ~/Downloads/长城素材/ --remote /我的视频/
# 覆盖网盘上已存在文件
{baseDir}/scripts/upload.sh ~/Downloads/video.mp4 --remote /我的视频/ --force
4. 同步目录 (sync.sh)
# 从网盘同步到本地(网盘为主)
{baseDir}/scripts/sync.sh down /我的视频/项目 ~/本地备份/项目/
# 从本地同步到网盘(本地为主)
{baseDir}/scripts/sync.sh up ~/本地项目/ /我的视频/项目/
# 双向同步(谨慎使用)
{baseDir}/scripts/sync.sh both ~/本地项目/ /我的视频/项目/
5. 查看配额 (quota.sh)
{baseDir}/scripts/quota.sh
输出示例:
网盘配额:2.0 TB
已使用:1.2 TB (60%)
剩余可用:800 GB
视频项目工作流
场景:从网盘下载素材进行剪辑
# 1. 查看网盘素材目录
{baseDir}/scripts/list.sh /视频素材/长城春晚/
# 2. 下载所有素材到本地
{baseDir}/scripts/download.sh /视频素材/长城春晚/ --out ~/龙虾项目/长城赞助春晚/raw/
# 3. 剪辑完成后,上传成品回网盘
{baseDir}/scripts/upload.sh ~/龙虾项目/长城赞助春晚/output/final.mp4 --remote /视频成品/
故障排查
| 问题 | 可能原因 | 解决方法 |
|---|---|---|
Not authorized |
未授权或授权过期 | 运行 auth.sh 重新授权 |
Network error |
网络问题 | 检查网络,稍后重试 |
File not found |
路径错误 | 检查网盘路径,区分大小写 |
Quota exceeded |
网盘空间不足 | 清理网盘或购买会员 |
Rate limited |
请求过于频繁 | 等待几分钟后重试 |
注意事项
- 授权安全:授权信息保存在本地
~/.bypy/目录,不要分享给他人 - 大文件传输:上传/下载大文件可能需要较长时间,请保持网络稳定
- 路径格式:网盘路径以
/开头,如/我的视频/项目/ - 免费额度:百度网盘对非会员有下载限速,大文件建议开通会员或使用百度云同步盘
相关链接
- bypy 项目:https://github.com/houtianze/bypy
- 百度网盘开放平台:https://pan.baidu.com/union
Usage Guidance
This skill is a thin wrapper around the community 'bypy' tool and is internally consistent. Before installing: 1) Verify you trust the bypy package on PyPI (check the upstream repo: https://github.com/houtianze/bypy and package owner). 2) Be aware the OAuth tokens are stored locally in ~/.bypy — protect that directory and do not share it. 3) When running upload/sync commands, double-check the local paths you pass (to avoid accidentally uploading sensitive files). 4) If you require extra safety, run the scripts in a restricted environment or container and inspect the bypy config after authorization. 5) Note the SKILL.md includes a pip install suggestion even though the registry listed no install spec — ensure you control which bypy version is installed.
Capability Analysis
Type: OpenClaw Skill
Name: baidupan
Version: 1.0.0
The skill bundle is a legitimate automation tool for Baidu Netdisk (BaiduPan) based on the well-known open-source 'bypy' Python library. The scripts (auth.sh, download.sh, upload.sh, etc.) are straightforward wrappers for standard bypy commands, and the installation process correctly uses pip to fetch the official package. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
Name/description match the provided scripts and runtime instructions. The skill invokes the bypy CLI for upload/download/list/sync/quota and declares 'bypy' as the required binary; this is proportional to its stated purpose.
Instruction Scope
Runtime instructions and included shell scripts only call bypy and standard filesystem commands. They require running an OAuth-style auth flow (bypy info) which saves tokens to ~/.bypy (documented). The scripts allow uploading arbitrary local paths (expected for this tool) — which means a user could inadvertently upload sensitive local files if used carelessly. No instructions read unrelated system secrets or external endpoints.
Install Mechanism
The SKILL.md metadata suggests installing the bypy pip package (pip install bypy). Using PyPI for this dependency is expected and traceable; no obscure downloads, URL shorteners, or archive extraction are present. (Note: registry metadata indicated 'no install spec' while SKILL.md includes a pip install recommendation — a minor inconsistency but not a security red flag.)
Credentials
The skill does not request environment variables or external credentials. Authorization is handled via bypy's standard OAuth flow and stored locally under ~/.bypy. There are no unrelated credential requests or hidden env accesses in the scripts.
Persistence & Privilege
The skill is not always-enabled and does not modify other skills or system-wide configurations. Autonomous invocation is allowed (platform default) but not combined with broad privileges or credential access.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install baidupan - After installation, invoke the skill by name or use
/baidupan - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the baidupan skill.
- Provides automated tools for Baidu Netdisk (百度网盘) using bypy.
- Supports file upload, download, listing, syncing, and quota checking through simple scripts.
- Includes detailed usage instructions and troubleshooting guidance.
- Requires one-time user authorization for secure access.
- Easy integration via pip; minimal dependencies.
Metadata
Frequently Asked Questions
What is Baidupan?
百度网盘自动化工具,支持上传、下载、列表、同步等操作。 It is an AI Agent Skill for Claude Code / OpenClaw, with 152 downloads so far.
How do I install Baidupan?
Run "/install baidupan" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Baidupan free?
Yes, Baidupan is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Baidupan support?
Baidupan is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Baidupan?
It is built and maintained by Robin-Lee-China (@libin771018-sketch); the current version is v1.0.0.
More Skills