核心用法
Radarr+ 是一款面向自托管媒体服务器用户的电影自动化管理工具，通过 Radarr HTTP API 实现从聊天界面直接请求电影并追踪下载进度。
主要功能模块：
| 功能 | 说明 |
|------|------|
| 电影搜索/查找 | 支持标题模糊搜索或 TMDB ID 精确查询，返回候选列表供用户选择 |
| 智能添加 | 自动绑定画质配置（Quality Profile）和存储根目录，支持监控+自动搜索开关 |
| 富媒体卡片 | 集成 TMDB 海报、YouTube 预告片链接、OMDb IMDb 评分，生成类 App Store 风格的请求确认卡片 |
| 进度追踪 | 基于文件队列的轮询机制，自动向原聊天会话推送下载状态（已添加 → 已抓取 → 已导入） |
| Plex 联动 | 可选生成 Plex Web 播放直链，实现"请求-下载-观看"闭环 |
典型交互流程：
1. 用户输入「添加 Inception」→ 2. 机器人返回 TMDB 候选列表 → 3. 用户确认年份 → 4. 推送带海报/评分/预告片的确认卡片 → 5. 调用 Radarr API 添加并启动搜索 → 6. 后台轮询推送进度更新 → 7. 下载完成后通知「已导入 ✅」
显著优点
- 完整的聊天原生体验：从请求到完成全程在同一会话中闭环，无需切换 Radarr Web UI
- 低门槛配置：通过环境变量管理多实例连接，支持默认值预设减少重复交互
- 可扩展的插件架构：TMDB/OMDb/Plex 均为可选依赖，无密钥时自动降级为文本模式
- 状态持久化：基于文件队列的追踪系统，不依赖外部数据库，容器化部署友好
- Radarr 原生兼容：直接调用官方 v3 API，支持所有画质配置、根目录、标签体系
潜在局限
- 需自托管基础设施：要求用户已部署 Radarr 实例并配置下载器（qBittorrent/Transmission 等）和索引器
- 网络可达性依赖：OpenClaw 主机需能访问 Radarr 的 7878 端口，NAT/防火墙需额外配置
- 轮询延迟：进度追踪依赖周期性脚本执行，非 WebSocket 实时推送，延迟取决于 cron 间隔
- TMDB 命中率：部分小众影片或非英语电影可能存在 TMDB 元数据缺失，导致卡片信息不完整
- Plex 链接准确性：依赖标题+年份匹配，存在同名电影误判风险
适合人群
- 已运行 Radarr + *arr 下载栈的进阶家庭影院用户
- 希望为亲友提供「Netflix 式」电影请求入口的 Plex/Jellyfin 服务器管理员
- 追求「聊天即控制台」自动化工作流的效率型用户
- 愿意维护 API 密钥（TMDB/OMDb）以获得 richer 体验的进阶用户
常规风险
| 风险类型 | 说明 | 缓解建议 |
|----------|------|----------|
| API 密钥泄露 | `~/.openclaw/.env` 中存储 Radarr API Key，权限配置不当可能导致未授权访问 | 设置 600 权限，避免提交到版本控制，定期轮换密钥 |
| 误添加影片 | 标题搜索可能匹配错误电影（尤其重名、翻拍作品） | 强制要求用户从候选列表二次确认，优先使用 TMDB ID |
| 存储空间失控 | 自动监控+搜索可能触发大量下载 | 设置 Radarr 磁盘空间阈值告警，启用下载队列大小限制 |
| 轮询资源消耗 | 高频轮询大量电影状态可能产生 API 和 I/O 负载 | 调整 `poll_and_queue.py` 执行间隔，清理已完成追踪项 |
| 版权合规 | 自动化下载受版权保护内容可能违反当地法律 | 确保索引器仅包含合法来源，用户需自行承担合规责任 |