（11618期）Radarr+ – 聊天即控制台，一键入库追进度

聊天即控制台，一键入库追进度 通过 Radarr API 实现电影自动化搜索、添加与下载追踪，支持 TMDB 海报、IMDb 评分、Plex 链接集成，打造完整的媒体库聊天请求工作流。 使用说明 核心用法 Radarr+ 是一款面向自托管媒体服务器用户的电影自动化管理工具，通过 Radarr HTTP API 实现从聊天界面直接请求电影并追踪下载进度。 主要功能模块： | 功能 | 说明 ||------|------|| 电影搜索/查找 | 支持标题模糊搜索或 TMDB ID 精确查询，返回候选列表供用户选择 || 智能添加 | 自动绑定画质配置（Quality Profile）和存储根目录，支持监控+自动搜索开关 || 富媒体卡片 | 集成 TMDB 海报、YouTube 预告片链接、OMDb IMDb 评分，生成类 App Store 风格的请求确认卡片 || 进度追踪 | 基于文件队列的轮询机制，自动向原聊天会话推送下载状态（已添加 → 已抓取 → 已导入） || Plex 联动 | 可选生成 Plex Web 播放直链，实现"请求-下载-观看"闭环 | 典型交互流程： 用户输入「添加 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 负载 | 调整 pollandqueue.py 执行间隔，清理已完成追踪项 || 版权合规 | 自动化下载受版权保护内容可能违反当地法律 | 确保索引器仅包含合法来源，用户需自行承担合规责任 | 原始说明 Add and manage movies in a Radarr instance via its HTTP API (search/lookup movies, list quality profiles and root folders, add a movie by title/year or TMDB id, and trigger a search). Use when the user asks to add/request/download a movie via Radarr/Plex, or when automating Radarr-based media workflows.