核心用法
Radarr+ 是一款面向自动化媒体工作流的 ChatOps 工具，允许用户直接在聊天会话中完成电影请求的全流程管理。其核心操作围绕 Radarr 的 HTTP API 展开，支持电影搜索（按标题或 TMDB ID）、画质档案枚举、根文件夹配置，以及带监控与自动搜索的电影添加。典型工作流包括：用户输入电影名称 → 模糊匹配候选结果 → 用户确认 → 选择画质与存储路径 → 加入 Radarr 监控队列 → 持续轮询下载进度 → 最终导入通知。
显著优点
- 对话即界面：将复杂的 Radarr 操作封装为自然语言交互，降低非技术用户门槛
- 进度闭环：通过文件队列机制（
enqueue_track.py+poll_and_queue.py）实现跨会话状态持久化，确保用户能在同一聊天窗口接收下载→导入的完整生命周期通知 - 可扩展增强：预留 TMDB/OMDB/Plex 集成点，支持海报卡片、IMDb 评分、预告片链接及 Plex 直达链接等富媒体体验
- 配置降级友好：当环境变量缺失时，通过
resolve_defaults.py动态获取可选值并交互式提示，避免硬阻断
潜在缺点与局限性
- 轮询延迟：当前进度追踪依赖外部定时任务调用
poll_and_queue.py，实时性取决于 cron 频率设置，非事件驱动推送 - 单实例限制：仅支持单一 Radarr 实例配置，无法同时管理多节点或跨区服务器
- 安全凭证管理：API Key 与访问令牌以明文形式存储于
~/.openclaw/.env，依赖文件系统权限保护，无内置加密或密钥轮换机制 - 错误恢复薄弱：API 超时或 Radarr 不可达时，脚本退出码与重试策略未在文档中明确，可能产生 orphaned tracking 状态
适合人群
- 已部署 Radarr + Plex 媒体栈的 NAS/Homelab 用户
- 希望通过 Telegram/Discord 等聊天工具为家庭成员提供「自助点片」服务的管理员
- 追求「请求-审批-下载-通知」自动化链路的进阶影音爱好者
常规风险
- 网络暴露风险：Radarr 默认无认证，若 API 端口面向公网开放且未配合反向代理/IP 白名单，API Key 泄露可导致媒体库被篡改或滥用下载配额
- 存储路径注入：
--root参数直接传递至 Radarr，若用户输入未过滤，理论上存在路径遍历风险（取决于 Radarr 后端校验） - 隐私泄露：TMDB/OMDB 查询及 Plex 链接生成会外向暴露用户媒体库内容偏好，敏感用户需评估元数据服务合规性