核心用法
Radarr-Fixed 是一款面向 Radarr 媒体服务器的命令行客户端工具,主要提供以下功能:
- 智能搜索:通过 TMDB 数据库搜索电影,返回带编号的候选列表并附带可点击的 TMDB 链接
- 单部添加:支持按 TMDB ID 添加电影,可选择是否立即触发搜索下载
- 收藏集管理:自动识别电影所属系列,支持一键添加整部收藏集
- 库管理:检查电影是否存在、移除电影(可选是否删除文件)、获取根目录和质量配置
配置方式灵活,支持 JSON 配置文件(~/.openclaw/credentials/radarr/config.json)或环境变量(RADARR_URL、RADARR_API_KEY)。
显著优点
1. 功能完整:覆盖了 Radarr 核心 API 的主要操作场景,从搜索到管理形成完整闭环
2. 交互友好:强制要求展示 TMDB 链接,便于用户核实影片信息;收藏集自动提示减少重复操作
3. 配置灵活:文件配置与环境变量双模式,适应不同安全偏好(环境变量不落盘更安全)
4. 依赖极简:仅依赖系统标准工具 curl 和 jq,无第三方包管理风险
5. 代码透明:纯 Bash 脚本实现,274 行代码结构清晰,易于人工审计
潜在缺点与局限性
- T3 来源风险:由个人开发者 frannunpal 维护的 fork 版本,原始作者为 jordyvandomselaar,社区背书较弱
- 无加密存储:API 密钥以明文形式存储于配置文件,需用户自行设置文件权限(推荐 600)
- 功能边界明确:仅为 Radarr 的 API 封装,不具备独立下载能力,需配合 Radarr + 下载器使用
- 网络依赖:完全依赖用户自建 Radarr 实例,无内置备用服务或离线能力
- Shell 限制:Bash 脚本跨平台性有限,Windows 用户需 WSL 或 Git Bash 环境
适合的目标群体
- 家庭 NAS 用户:运行 Radarr 管理媒体库,希望通过命令行或 Agent 快速添加影片
- 自动化爱好者:需要将电影添加流程集成到更大的自动化工作流中
- 多收藏集管理者:频繁处理系列电影(漫威、DC、速激等)的用户,可大幅提升效率
- 隐私优先用户:相比 SaaS 服务,完全本地部署、数据不出境
使用风险
| 风险类型 | 说明 | 缓解建议 |
|---------|------|---------|
| 凭证泄露 | 配置文件明文存储 API 密钥 | 设置 600 权限,或使用环境变量 |
| 来源可信度 | T3 个人开发者,无企业背书 | 审查代码,关注发布者历史 |
| 实例安全 | 脚本拥有 Radarr 实例的写权限 | 配置只读 API 密钥(如仅需查询) |
| 版本维护 | Fork 版本更新频率不确定 | 订阅更新通知,更新后重审代码 |
| 依赖可用性 | 依赖 curl/jq,极端精简系统可能缺失 | 使用前验证依赖安装 |