安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install cloud-drive-downloader
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 cloud-drive-downloader。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Cloud Drive Downloader (网盘通) 为智能体和用户提供统一方式，用于识别云盘链接、遵循各平台的官方登录或授权要求、规划保存位置并下载文件。它将传输任务委托给 AList、rclone、BaiduPCS-Go、aria2、WebDAV 和 curl 等通用引擎，而不是自行实现每家服务商的私有协议，也不要求每项服务都使用单独的官方客户端。
可用于百度网盘、阿里云盘、夸克网盘、天翼云盘、迅雷云盘、115 网盘、OneDrive、Google Drive 和 Dropbox 等服务，具体取决于可用引擎和服务商支持情况。下载目标可以是本地文件夹、兼容的远程存储或 NAS 设备。Openclaw Skills 用户可通过实用且可脚本化的工作流进行试运行规划、任务报告和凭据保护；此技能不会绕过平台限制或安全检查。

应用场景

将用户提供的云盘分享链接下载到指定的本地目录。
test --dry-run 下载前，检查链接、服务商、引擎、目标位置和所需提取码是否就绪。
通过配置好的 AList 和 rclone 设置递归获取共享文件夹。
使用 SSH、rclone、WebDAV、SMB、S3 或已挂载路径，将下载内容直接保存到 NAS 或私有存储。
按类型整理已完成的文件，自动分类视频、音乐、文档、图片、压缩文件及其他文件。
通过本地任务中心 Web UI 监控、暂停、恢复、重试或查看下载任务。
自动执行后续工作，例如完成后运行钩子、处理 JSON 事件或发送下载完成通知。

工作原理

使用 doctor 检查环境，包括 Python、curl、凭据存储、可用下载引擎和目标目录。
提供受支持的分享 URL。CLI 会识别服务商并选择已配置的引擎；detect 和 test 可在不启动下载的情况下检查就绪状态。
按服务商要求，通过平台官方流程自行完成授权。在本地终端输入账户密钥，并将其存储在操作系统凭据存储区或引擎的受保护配置中。
使用 get

• --dry-run 预览传输，可选指定提取码、目标位置、远程目标、分类或文件夹路径。 确认计划并开始下载。此技能会将工作委托给选定的引擎，并在支持的情况下使用可续传传输和保守的默认设置。
  通过 CLI 或本地 Web UI 跟踪进度并管理任务。可选的实时状态会报告传输进度，任务事件也可以 JSON 格式输出以用于智能体工作流。
  检查目标位置和生成的报告，并在需要时运行已配置的完成钩子或通知。

配置指南

获取技能文件后，在技能目录中运行设置向导。查看检测到的依赖项；只有在希望向导调用包管理器时才使用 --apply。Windows 用户可以使用提供的 PowerShell 或 CMD 包装脚本。
python3 scripts/pan.py doctor
python3 scripts/pan.py setup

可选：执行 setup 提供的依赖安装命令

python3 scripts/pan.py setup --apply
根据需要配置服务商或传输引擎。通过交互式凭据命令在本地存储密钥；不要将账户密码、Cookie 或令牌粘贴到智能体聊天中。通过服务商的官方登录、OAuth、二维码或其他受支持流程完成授权。
python3 scripts/pan.py secret set engine.webdav
python3 scripts/pan.py login
下载前预览传输。检查计划后再移除 --dry-run。使用 --to 指定本地目标位置；若要保存到 NAS 或私有存储，则配置远程目标。
python3 scripts/pan.py get "" --pwd "" --dry-run --json
python3 scripts/pan.py get "" --to ""
在 Windows 上，请使用 scripts/pan.ps1 或 scripts/pan.cmd，而不是直接调用 Python 入口。运行附带的自测以检查技能文件：
PYTHONDONTWRITEBYTECODE=1 python3 scripts/self_test.py
Cloud Drive Downloader (网盘通) 数据架构与分类体系
此技能将配置、凭据、传输输出和状态数据分别存放：
数据 位置或格式 用途
主配置 ~/ .config/pan-downloader/config.json 存储 URL、用户名、路径、凭据引用、引擎设置、远程目标和服务商扩展等非机密设置。设置程序会创建权限受限的配置文件。
账户密钥 macOS Keychain、Windows Credential Manager、Linux secret-tool，或受支持引擎管理的受保护配置 将密码、Cookie、令牌和类似凭据存储在明文 config.json 之外。
下载文件 配置的本地或远程目标位置 保存请求的文件和文件夹。默认位置因操作系统而异，可通过 pan set --root、get --to 或远程选项覆盖。
完成报告 默认位于目标目录中的 下载报告.json 记录开始和结束时间、持续时间、引擎步骤的退出代码和耗时、缺失的依赖项以及警告。http.report_dir 可更改报告目录。
实时传输状态 配置的实时目录、报告目录或目标目录中的 下载速度.live.json 启用实时监控时，记录速度、已下载字节数、当前步骤、状态和更新时间。使用 http.live_dir 和 http.live_interval 配置。
服务商扩展 config.json 中的 extensions 对象 将服务商名称和域名映射到自定义引擎命令，并支持 {url}、{pwd}、{dir}、{name} 和 {tier} 等占位符。
服务商和引擎分类包括直接 HTTP/HTTPS 链接、AList 和 rclone 集成、BaiduPCS-Go 等服务商专用工具，以及通过 SSH、WebDAV、SMB、S3、rclone 或已挂载路径访问的远程目标。支持情况取决于已配置的引擎和服务商当前的能力。

高级特性

安全处理凭据：在本地输入密钥，并避免其出现在明文配置、命令参数、日志和智能体对话中；迁移工具可以将旧版明文凭据移至受保护的存储区。
远程目标：注册并探测远程设备，适当时通过 SSH 部署，或使用已配置的 rclone 远程连接 WebDAV、SMB、S3 和其他受支持的目标。
任务控制与监控：通过本地 Web UI 和 CLI 列出、检查、暂停、恢复、取消、删除和重试任务；查看实时传输状态和报告。
智能体集成：使用 JSON 试运行计划、逐步 JSON 事件、MCP 指引以及文档化的 OpenAPI/agent 接口，将下载接入更高级的工作流。
自动化：按扩展名分类文件、为指定时间安排下载、运行完成钩子或发送已配置的通知。
传输韧性：在可用时使用重试和续传支持；HTTP 直链可选择使用基于 Range 的分段下载，前提是服务器声明支持该功能。
浏览器工作流：可选的 Chrome 扩展会将复制的链接发送到本地服务。剪贴板集成只处理链接文本，不会读取云盘页面的登录状态。
可扩展性：在配置中添加服务商映射和自定义引擎命令，然后通过服务商检测和试运行进行验证。
合规行为：免费账户默认采用保守的并发设置，会员设置只会调整本地调度；此技能不会绕过服务商限制、CAPTCHA、验证或风险控制。

name: cloud-drive-downloader slug: cloud-drive-downloader
displayName: 网盘通
version: "0.7.1"
author: lis
license: CC-BY-NC-SA-4.0
description: 统一从百度、阿里云盘、夸克、天翼、迅雷、115、123云盘、移动云盘、沃盘、UC、PikPak、坚果云、OneDrive/SharePoint、Google Drive、Dropbox、微云、蓝奏及更多网盘下载分享链接、转存文件夹或直链到本机、Windows、NAS 或远程私有存储。用户只需提供网盘下载地址；技能通过统一命令行和共享下载引擎完成识别、登录引导、目录规划和下载，不必逐个安装各家官方客户端。支持群晖、威联通、飞牛、TrueNAS、Unraid、绿联、极空间、华为家庭存储、蒲公英外接盘等通过 SSH/WebDAV/SMB/S3/rclone/挂载路径接入。免费账号默认单线程+断点续传，账号等级从已配置的可信探测器读取，探测不到按免费处理；会员仅按平台官方权益调整本地并发，不承诺不限速，不绕过平台风控。