qBittorrent管理

技能简介

通过qBittorrent WebUI API连接本地或远程qBittorrent客户端，执行种子列表查看、添加、暂停、恢复、删除等操作，并支持分类标签管理与全局速度限制。

能做什么

• 列出所有种子，按状态或分类筛选
• 添加磁力链接或种子文件到下载队列
• 暂停、恢复、删除单个或全部种子
• 查看种子详情、文件列表与Tracker信息
• 管理分类与标签，设置下载路径
• 查看全局传输速度与统计信息
• 调整上传/下载速度限制

使用说明

1. 配置凭证

创建配置文件 ~/.clawdbot/credentials/qbittorrent/config.json：

{"url": "http://localhost:8080","username": "admin","password": "adminadmin"}

2. 安装依赖

确保系统已安装 curl 和 jq，脚本位于 ./scripts/qbit-api.sh。

3. 常用命令示例

列出下载中种子：./scripts/qbit-api.sh list --filter downloading

添加磁力链接：./scripts/qbit-api.sh add "magnet:?xt=..." --category movies

暂停指定种子：./scripts/qbit-api.sh pause <hash>

查看全局速度：./scripts/qbit-api.sh transfer

输入与输出

见下方输入与输出表格。

风险提示

• 需提前在qBittorrent中开启WebUI并设置访问密码
• 默认配置使用HTTP明文传输，公网环境建议配合HTTPS或VPN使用
• 删除操作带--files参数会永久移除已下载文件，无法恢复
• API版本要求qBittorrent v4.1及以上

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jmagar/qbittorrent/SKILL.md
来源类型：GitHub仓库