核心功能
Radarr+ 是一套面向 Radarr 媒体管理器的完整自动化技能,允许用户通过自然语言聊天请求电影,自动完成从搜索、匹配到入库的全流程。核心能力包括:基于 TMDB ID 或标题的智能电影搜索、质量配置文件(Quality Profile)和根目录(Root Folder)管理、电影添加与自动搜索触发,以及基于轮询的下载进度追踪与聊天通知。
显著优点
1. 聊天原生体验:用户只需发送电影名称即可获得海报卡片、评分、预告片链接和确认回执,大幅降低使用门槛。
2. 配置灵活:支持通过环境变量预设默认值(如 RADARR_DEFAULT_PROFILE),也可在运行时动态解析可用选项,兼顾自动化与交互性。
3. 可扩展架构:预留 TMDB/OMDB/Plex 等可选模块,允许逐步增强功能(海报获取、IMDb 评分、播放链接),不强制一次性配置。
4. 状态持久化:通过文件队列实现跨会话的进度追踪,支持群组和私聊两种场景的消息回推。
潜在局限
- 网络依赖:Radarr 实例必须可从 OpenClaw 主机访问,且需正确配置 API 密钥和 URL(HTTP/HTTPS 区分)。
- 轮询延迟:进度通知采用轮询机制(
poll_and_queue.py),非实时 WebSocket 推送,更新频率取决于 cron 调度。 - 配置门槛:初次使用需设置多个环境变量(URL、API Key、可选的 TMDB/OMDB/Plex 密钥),对非技术用户不够友好。
- 单实例限制:当前设计围绕单一 Radarr 实例,未明确支持多实例或 Radarr 4K 分离架构的自动路由。
适合人群
- 已部署 Radarr + Plex 的 NAS/服务器用户,希望通过 Telegram/聊天工具远程管理电影库。
- 希望为家庭媒体中心提供"一键请求"入口的技术爱好者。
- 需要将电影请求流程与现有 OpenClaw 自动化工作流集成的开发者。
常规风险
- API 密钥泄露:
RADARR_API_KEY和PLEX_TOKEN属于敏感凭证,需严格限制~/.openclaw/.env的访问权限,避免提交至版本控制。 - 误添加风险:基于标题的模糊匹配可能选错电影(同名不同年),建议优先使用 TMDB ID 或要求用户确认。
- 存储路径错误:错误的
root配置可能导致电影下载至非预期目录,甚至触发 Radarr 的硬链接/移动规则异常。 - 轮询资源消耗:高频轮询大量电影状态可能对 Radarr API 造成额外负载,需合理设置调度间隔。