Radarr+

核心功能

Radarr 技能将 OpenClaw 连接到 Radarr 实例，允许用户通过聊天界面直接请求和管理电影下载。核心能力包括：电影搜索与精确匹配（支持 TMDB ID 查询）、质量配置文件管理、根文件夹配置、一键添加电影并触发自动搜索，以及可选的 Plex 联动。

显著优点

1. 精准识别机制：优先使用 TMDB ID 而非模糊标题匹配，大幅降低误添加错误版本的风险
2. 灵活配置架构：支持环境变量预设默认值，减少重复交互；同时提供动态提示选项，兼顾自动化与可控性
3. 富媒体体验扩展：可选集成 TMDB（海报、预告片）、OMDb（IMDb 评分）和 Plex，构建完整的电影信息卡片
4. 异步追踪通知：内置基于文件的追踪队列系统，可轮询下载进度并向原聊天会话推送状态更新
5. 工作流完整性：覆盖从用户请求→电影识别→配置确认→添加到库→进度追踪→Plex 播放链接的完整闭环

潜在局限

1. 依赖外部服务稳定性：TMDB/OMDb/Plex 任一服务中断都会影响对应功能
2. 轮询效率限制：进度追踪采用文件轮询机制，实时性取决于 cron 调度频率
3. 初始配置门槛：需正确配置 Radarr URL、API Key 及可选服务的密钥，网络连通性验证步骤对非技术用户有挑战
4. 无内置冲突检测：技能本身不检查库中是否已存在同名电影，依赖 Radarr 后端去重
5. 权限边界：通过 API Key 操作，权限等同于 Key 持有者，无额外分层授权机制

适合人群

• 已部署 Radarr 的影音自动化用户
• 希望通过聊天机器人（如 Telegram）简化电影请求流程的家庭媒体管理员
• 需要为团队成员/家人提供"一键求片"入口的技术爱好者
• 追求 Plex-Radarr 联动体验的进阶用户

常规风险提示

• API Key 存储于本地 .env 文件，需确保文件权限设置正确（建议 600）
• Radarr 实例需暴露于网络，建议配合反向代理和 HTTPS，避免明文传输 API Key
• 自动搜索可能触发大量索引器查询，需注意 ISP 流量限制或索引器 API 限额
• 质量配置和根文件夹选择错误可能导致存储路径混乱或下载不符合预期的版本

核心用法

Radarr Skill 是专为家庭影音自动化设计的工具，通过 HTTP API 与 Radarr 实例交互，实现电影搜索、添加、质量配置管理等核心功能。用户需在 ~/.openclaw/.env 中配置 RADARR_URL 和 RADARR_API_KEY 完成初始化，支持可选的 TMDB/OMDb API 增强元数据展示。

主要功能模块：

• 搜索与查询：通过 lookup 命令按标题或 TMDB ID 搜索电影，返回匹配结果供用户选择
• 添加电影：支持通过 TMDB ID（推荐）或标题+年份添加，可指定质量配置（如 HD-1080p）和根目录
• 配置管理：列出可用的质量配置和根文件夹，支持环境变量预设默认值
• 增强体验：集成 TMDB 获取海报、OMDb 获取 IMDb 评分、Plex 生成媒体库链接
• 进度追踪：文件队列系统跟踪下载进度，支持向原聊天渠道推送状态更新

推荐聊天工作流：用户说 "request/add <movie>" → 执行 lookup 搜索 → 解析默认配置（必要时交互提示）→ 生成电影卡片（如有 API 密钥）→ 添加到 Radarr → 入队追踪 → 可选生成 Plex 链接。

显著优点

1. 功能完整度高：覆盖 Radarr 核心 API 操作，从搜索到添加再到进度追踪形成闭环
2. 扩展性强：可选集成 TMDB、OMDb、Plex 三大外部服务，显著丰富用户体验
3. 配置灵活：支持环境变量预设默认值，减少重复交互；同时保留交互式提示作为兜底
4. 安全意识良好：所有敏感配置（API 密钥、Token）均从环境变量读取，无硬编码
5. 代码质量优秀：纯 Python 标准库实现，零第三方依赖，1,156 行代码结构清晰、注释充分

潜在缺点与局限性

1. 来源可信度受限：个人开发者项目（vishalchaudhary），无 GitHub 公开仓库验证，属于 T3 级别
2. 网络依赖较多：需连接 Radarr 本地实例、TMDB、OMDb 等多个端点，任一方不可用将影响功能
3. subprocess 调用模式：部分脚本通过 subprocess 调用本地 shell 脚本，存在轻微性能开销和潜在安全风险（需配合文件系统权限控制）
4. 图片下载无白名单：从 TMDB 下载海报时未验证 URL 域名，若 API 响应被篡改可能下载非预期内容
5. 文档权限提示不足：未明确指导用户设置 .env 文件权限（建议 chmod 600）

适合人群

• 家庭影音爱好者：已部署 Radarr + Plex stack，希望通过聊天机器人简化电影请求流程
• 自动化运维人员：需要集成 Radarr 到更大工作流（如结合 Sonarr、Lidarr 统一管理）
• 技术型用户：具备 Linux/容器基础，能正确配置环境变量和文件权限

常规风险

| 风险项 | 等级 | 说明 |

|--------|------|------|

| 敏感信息泄露 | 低 | 依赖用户正确保护 `.env` 文件，建议设置 600 权限 |

| 非预期内容下载 | 低 | TMDB 图片下载无域名白名单，需信任 TMDB API 安全性 |

| 本地代码执行 | 低 | subprocess 调用自身脚本，需保障 Skill 目录完整性 |

| 网络服务可用性 | 中 | 多外部 API 依赖，任一方故障将影响增强功能 |

整体评估：A 级安全，功能与声明一致，适合在受控环境中部署用于个人媒体管理场景。