Radarr+

核心用法

Radarr Skill 为 OpenClaw 提供与 Radarr 媒体管理器的深度集成，用户可通过自然语言对话完成电影搜索、添加和下载追踪。核心工作流分为四步：

1. 智能搜索 — 支持模糊片名或精确 TMDB ID 查询，返回匹配列表供用户确认
2. 配置解析 — 自动读取环境变量中的默认画质配置（profile/root folder），缺失时交互式提示用户选择
3. 富媒体卡片（可选）— 若配置 TMDB/OMDB API 密钥，自动生成含海报、评分、预告片的视觉化确认卡片
4. 一键添加与追踪 — 调用 Radarr API 添加电影并启用监控，同时加入本地追踪队列，通过轮询机制在下载完成后自动通知原聊天渠道

显著优点

• TMDB 优先架构：以 TMDB ID 为唯一标识，避免片名歧义，确保精确匹配
• 渐进式配置：必填项极简（URL + API Key），可选增强功能（Plex 链接、富卡片）按需开启
• 双向状态同步：不仅下发指令，还通过 poll_and_queue.py 主动轮询下载进度，实现闭环通知
• 多触点支持：支持私聊和群组场景，追踪通知可精准路由回原始会话

局限性与风险

• 依赖外部服务稳定性：Radarr、TMDB、Plex 任一节点故障将导致功能降级
• API 密钥管理：需手动维护 .env 文件，存在泄露风险；建议配合密钥管理工具
• 无内置权限控制：当前设计假设单用户/信任环境，多租户场景需额外封装
• 轮询延迟：文件队列机制非实时，下载完成通知存在分钟级延迟

适合人群

• 自建媒体服务器（NAS/Homelab）用户，追求「聊天即下载」的自动化体验
• 已有 Radarr + Plex 技术栈，希望降低家人/室友使用门槛的进阶用户

常规风险提示

• 请确保 Radarr 实例位于内网或受保护的反向代理后，避免 API 密钥暴露于公网
• 下载内容需遵守当地版权法规，本工具仅提供技术自动化能力

核心用法

Radarr Skill 是专为家庭媒体爱好者设计的 Radarr 集成工具，支持通过自然语言对话完成电影搜索、添加和质量管理。核心工作流包括：

1. 智能搜索：通过 TMDB ID 或电影名称模糊匹配，返回候选列表供用户确认
2. 一键添加：支持指定质量配置文件（如 HD-1080p）、根目录和监控设置
3. 进度追踪：内置文件队列系统，可轮询下载状态并主动推送通知
4. 富媒体卡片：可选集成 TMDB 海报、预告片链接和 IMDb 评分

显著优点

• 零依赖安全：纯 Python 标准库实现，无第三方包引入供应链风险
• 配置灵活：环境变量驱动，支持多 Radarr 实例和 Plex 联动
• 交互友好：提供紧凑/详细两种输出模式，群聊场景下支持确认交互
• 扩展性强：模块化脚本设计，可独立调用 lookup、add、track 等原子操作

潜在局限

• 网络依赖重：核心功能依赖外部 API（TMDB、OMDb、Radarr 自身），任一服务不可用将导致功能降级
• 无内置认证：依赖 Radarr 自身的 API 密钥机制，Skill 层无额外身份验证
• 状态管理简陋：基于文件队列的追踪系统，高并发场景下可能产生竞态条件
• Plex 链接非实时：通过标题/年份反查，匹配失败时无降级提示

适合人群

• 已部署 Radarr + Plex 家庭媒体栈的技术用户
• 希望通过聊天机器人简化电影请求流程的媒体管理员
• 需要自动化监控下载进度并推送通知的运营者

常规风险

• API 密钥泄露：.env 文件权限配置不当可能导致 Radarr/TMDB/Plex 密钥暴露
• HTTP 明文传输：默认配置可能使用 HTTP，建议强制 HTTPS
• 实例暴露风险：若 Radarr 管理界面暴露公网且未启用认证，Skill 可能成为攻击跳板
• 数据残留：workspace/state/radarr/ 目录持续累积跟踪文件，需定期清理