核心用法
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 密钥暴露于公网
- 下载内容需遵守当地版权法规，本工具仅提供技术自动化能力