（6762期）TMS (Telegram Media Server) – 远程控制媒体下载与种子搜索

远程控制媒体下载与种子搜索 通过 REST API 远程控制 Telegram Media Server，支持添加视频/磁力链接/种子下载、查询状态、删除任务及 Prowlarr 种子搜索。 使用说明 TMS (Telegram Media Server) API Skill 评估 核心用法 TMS Skill 为 OpenClaw 代理提供与 Telegram Media Server 后端交互的能力，主要覆盖四大操作场景： 添加下载：支持视频 URL（yt-dlp）、磁力链接（magnet:...）、HTTPS 种子文件地址，或直接提交 Base64 编码的种子文件内容。可选 title 字段覆盖显示名称。 查询状态：获取队列中、下载中、转码中、已完成/失败/已停止的任务列表，包含进度百分比、队列位置及错误信息。 删除任务：彻底移除指定 ID 的任务，包括活跃下载、队列条目、数据库记录、本地文件及 qBittorrent 条目。 种子搜索：通过 Prowlarr 集成搜索种子，返回标题、大小、磁力链接、做种人数等元数据，支持按质量（如 1080p）过滤。 API 采用 RESTful 设计，Base URL 可通过 TMSAPIURL 环境变量配置，默认本地监听 http://127.0.0.1:8080，端点前缀为 /api/v1。认证支持 Authorization: Bearer <TMSAPIKEY> 或 X-API-Key: <TMSAPIKEY> 两种头部方式。 显著优点 功能闭环：完整覆盖下载生命周期管理（添加→监控→删除），无需用户手动登录服务器。 多源兼容：原生支持 yt-dlp、BitTorrent 及 Prowlarr 索引器，适应主流视频与种子来源。 无状态设计：纯 HTTP API 调用，易于集成到自动化工作流或聊天机器人场景。 OpenAPI 规范内嵌：技能文档自带完整 YAML 规范，减少对外部文档的依赖。 可选 Webhook 推送：支持任务完成/失败/停止时向 OpenClaw 网关推送事件，实现异步通知。 潜在缺点与局限性 Prowlarr 依赖：搜索功能要求 TMS 后端预先配置 Prowlarr，否则返回 503 错误。 Base64 体积限制：种子文件通过 torrent_base64 字段提交时，受限于 JSON body 大小（约 1 MiB），超大种子需改用 HTTPS URL。 局域网假设：默认 127.0.0.1 配置暗示 TMS 与 OpenClaw 同机部署，跨网络场景需额外配置。 无重复检测机制：虽建议调用方在添加前查询列表避免重复，但 API 本身不提供去重逻辑，依赖客户端实现。 Webhook 交付不可靠：文档明确标注“best-effort”，不保证事件必达，关键场景需配合轮询兜底。 适合人群 已部署 TMS 的个人媒体服务器用户，希望通过 Telegram Bot 或聊天界面远程管理下载队列。 需要将 yt-dlp/BitTorrent 下载能力集成到 OpenClaw 自动化工作流的技术用户。 拥有 Prowlarr 索引器的种子爱好者，追求搜索→添加→监控的一站式体验。 常规风险 API 密钥泄露：TMSAPIKEY 若配置不当或日志泄露，可能导致未授权下载或资源滥用。 本地文件系统暴露：删除操作会级联删除本地文件，误操作 id 可能导致数据丢失。 版权合规：种子搜索与下载功能涉及版权内容，用户需自行承担合规责任。 依赖服务可用性：yt-dlp、qBittorrent、Prowlarr 任一组件故障均会导致对应功能异常。 安全评估说明 技能文档中包含占位性安全认证报告，未实际执行漏洞扫描。建议生产部署前对 TMS 后端进行独立的安全审计，包括认证绕过、路径遍历及命令注入测试。 原始说明 Control Telegram Media Server downloads over REST: add URLs/torrents, list status, delete, and search via Prowlarr.