Radarr+

🎬 聊天即点,电影入库自动追

home-automation榜 #4

通过 Radarr API 自动化搜索、添加和管理电影下载任务,支持质量配置、进度追踪与 Plex 联动,适合打造个人媒体中心的用户。

收藏
6.8k
安装
2.7k
版本
0.1.6
CLS 安全性认证2026-06-23
点击查看完整报告 >

使用说明

核心功能

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_KEYPLEX_TOKEN 属于敏感凭证,需严格限制 ~/.openclaw/.env 的访问权限,避免提交至版本控制。
  • 误添加风险:基于标题的模糊匹配可能选错电影(同名不同年),建议优先使用 TMDB ID 或要求用户确认。
  • 存储路径错误:错误的 root 配置可能导致电影下载至非预期目录,甚至触发 Radarr 的硬链接/移动规则异常。
  • 轮询资源消耗:高频轮询大量电影状态可能对 Radarr API 造成额外负载,需合理设置调度间隔。

安全解读

Radarr+ 综合评估

核心用法

Radarr+ 是一个用于自动化电影媒体管理的 Skill,通过 Radarr 的 HTTP API 实现完整的电影请求工作流。用户可通过聊天界面发起电影请求,Skill 自动完成搜索匹配、质量配置选择、添加到 Radarr 下载队列,并在同一聊天会话中推送下载进度更新。

主要功能模块包括:

  • 电影搜索/查找:支持按标题模糊搜索或 TMDB ID 精确查找
  • 智能配置解析:自动读取环境变量默认值,缺失时交互式提示用户选择
  • 富媒体卡片:集成 TMDB 获取海报、预告片链接,OMDb 获取 IMDb 评分
  • 一键添加:支持指定质量配置(如 Ultra-HD、HD-1080p)、根目录、监控状态和自动搜索
  • 进度追踪:文件队列机制实现轮询检测,下载完成后自动通知原聊天会话
  • Plex 联动:可选生成 Plex Web 链接,实现播放入口直达

显著优点

  • 零依赖轻量实现:纯 Python 标准库(77.2%),无第三方包引入供应链风险
  • 安全配置最佳实践:所有敏感凭证(Radarr API Key、TMDB/OMDb/Plex Token)均通过 ~/.openclaw/.env 环境变量注入,无硬编码密钥
  • HTTPS 全链路加密:所有外部 API 调用(TMDB、OMDb、Radarr、Plex)强制使用 TLS
  • 文件沙箱隔离:状态文件读写严格限定于 state/radarr/ 工作子目录,无目录遍历漏洞
  • 模块化设计:17 个文件清晰分离配置解析、API 封装、卡片生成、队列追踪等职责

潜在缺点与局限性

  • T3 来源风险:由个人开发者(vishalchaudhary)维护,长期更新和社区支持存不确定性,需关注版本迭代
  • 轮询机制开销:进度追踪依赖文件队列 + 定时轮询(poll_and_queue.py),高频率请求场景可能产生 I/O 开销
  • 功能耦合度:富媒体体验依赖 TMDB/OMDb API Key 可选配置,缺失时降级为纯文本反馈
  • 网络可达性要求:需确保 OpenClaw 主机与 Radarr/Plex 实例网络连通,公网暴露 Radarr API 需额外安全加固

适合人群

  • 已部署 Radarr + Plex 媒体服务器的家庭影音爱好者
  • 希望通过聊天机器人(如 Telegram)简化电影请求流程的用户
  • 重视隐私、偏好本地媒体管理的自托管方案采用者
  • 具备基础 Linux/CLI 操作能力,能配置环境变量和文件权限的技术用户

常规风险

  • 凭证泄露.env 文件若权限配置不当(未设 600)可能导致 API Key 泄露
  • 网络暴露面:Radarr API 默认无认证或弱配置时,配合此 Skill 的自动化能力可能被滥用
  • 资源消耗:大规模电影库配合高频轮询可能对存储 I/O 和 Radarr 实例产生压力
  • 功能依赖:Radarr 服务本身的稳定性直接影响 Skill 可用性,API 变更可能导致兼容性问题

Radarr+ 内容

references文件夹
scripts文件夹
手动下载zip · 22.1 kB
onboarding.mdtext/markdown
请选择文件