qBittorrent WebUI 远程管理
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-qbittorrent。
技能介绍
要解决什么问题
qBittorrent 日常运维往往离不开 Web UI:查进度、筛异常任务、改分类或暂停做种。纯浏览器点选可以,但在脚本、自动化助手或远程会话里,需要稳定、可解析的 API 契约,而不是截图或手工描述界面状态。
本技能面向 qBittorrent v4.1 及以上 的 WebUI API,把「列任务—看详情—加种—控制—读传输与应用信息」收成可复述的操作边界,并在应答里统一 torrent 字段语义(hash、state、progress、dlspeed、upspeed、eta、category、tags、save_path 等)。
技能如何工作
- 列种子:按
all、downloading、seeding、completed、paused、active、inactive、stalled、errored等过滤器拉列表 - 查详情:针对单个 hash 获取完整 torrent 对象与状态机含义(如
stalledDL、pausedUP、missingFiles等) - 加种:通过 API 提交新任务(路径与参数以技能与凭据配置为准)
- 控制任务:暂停、恢复、删除等 WebUI 支持的控制动作
- 分类与标签:读取或操作与 category、tags 相关的接口能力
- 传输与应用:
Transfer Info看全局上下行;App Info确认客户端版本与运行态
凭据约定写在 ~/.clawdbot/credentials/qbittorrent/config.json,助手据此连到你的实例,而不是在对话里复述账号密码。
适用边界与注意点
- 仅覆盖 WebUI API 能做的事;未在 SKILL 中列出的端点不要臆造
- 客户端版本需 4.1+;旧版 Web API 字段或行为可能不一致
- 状态名与过滤器以文档为准;
error、missingFiles类任务应结合save_path与磁盘实际情况排查 - 本技能是远程编排接口说明,不能替代你在 NAS/主机上对 qBittorrent 进程、网络与存储的底层排障
使用场景
- NAS 上 qBittorrent 做种异常,需用 `stalled`、`errored` 过滤器筛出任务再查 `state` 与 `save_path`
- 远程服务器只能通过 Web API 批量暂停 `downloading` 任务以腾带宽,再恢复指定 hash
- Homelab 里按 `category`、`tags` 核对未归类的新种,并通过 API 补齐分类
- 值班时需要 `Transfer Info` 与 `App Info` 确认客户端版本与全局上下行是否正常
适合人员
- 自建 NAS 下载机维护者:夜间希望用自然语言拉 `active` 列表并定位卡住的做种任务
- 家里跑 qBittorrent 的 Homelab 玩家:想按分类整理剧集/软件包且不想长期开着 Web 界面
- 管理机房 BT 转发或限速策略的运维:需在维护窗口批量 `paused` 再按 hash 恢复
- 写 Clawdbot/OpenClaw 自动化的人:要把列种、加种、控种接到 `config.json` 凭据后的同一套 API