Radarr+

从聊天中请求电影并将其添加至Radarr（并在同一聊天中反馈进度更新）。

效果示例

以下是单条消息中用户请求电影时将收到的海报卡片+说明文字示例（包含海报附件、预告片链接和评分）：

示例消息说明文字：

《禁闭岛》（2010）

⭐ IMDb评分：8.2/10

🎬 预告片：https://www.youtube.com/watch?v=qdPw9x9h5CY

已添加至Radarr ✅（超高清格式，/movies目录）。我将在此处发布进度更新及“已导入 ✅”通知。

设置步骤（一次性配置）

1. 在~/.openclaw/.env文件中设置密钥（切勿提交此文件）：

• RADARR_URL=http://<主机地址>:7878
• RADARR_API_KEY=...

可选配置（建议设置以减少后续询问）：

• RADARR_DEFAULT_PROFILE=HD-1080p
• RADARR_DEFAULT_ROOT=/data/media/movies

可选（用于我们接下来将添加的“丰富”体验）：

• TMDB_API_KEY=...（海报 + 预告片）
• OMDB_API_KEY=...（IMDb 评分）
• PLEX_URL=http://<plex-host>:32400
• PLEX_TOKEN=...

2. 验证环境变量 + 连接性：

./skills/radarr/scripts/check_env.py
./skills/radarr/scripts/radarr.sh ping

如果失败，请检查：

• OpenClaw 主机可以访问到 Radarr
• API 密钥正确
• URL 正确（http 与 https）

常见任务

列出可用的质量配置文件

./skills/radarr/scripts/radarr.sh profiles

列出已配置的根文件夹

./skills/radarr/scripts/radarr.sh roots

查找/搜索电影

./skills/radarr/scripts/radarr.sh lookup --compact "inception"
./skills/radarr/scripts/radarr.sh lookup --compact "tmdb:603"

添加电影（首选：TMDB id）

./skills/radarr/scripts/radarr.sh add --tmdb 603 --profile "HD-1080p" --root "/data/media/movies" --monitor --search

添加电影（按标题；可选指定年份）

./skills/radarr/scripts/radarr.sh add --term "Dune" --year 2021 --profile "HD-1080p" --root "/data/media/movies" --monitor --search

聊天工作流程（推荐）

当用户说“请求/添加<电影>”（私信或群组）：

1) 查找

运行：

• ./skills/radarr/scripts/radarr.sh lookup --compact "<电影>"

如果有多个可能的匹配项，请让用户选择（年份或TMDB ID）。

2) 通过提示解决缺失的配置

从环境变量中解析默认值（并在缺失时获取提示选项）：

./skills/radarr/scripts/resolve_defaults.py

如果默认值缺失，提示用户从返回的选项中选择一个：

• options.profiles[]
• options.roots[]

（如果默认值存在，则静默使用它们。）

3) 可选的高级“电影卡片”（附加功能）

如果TMDB_API_KEY已设置，构建一个电影卡片：

./skills/radarr/scripts/movie_card.py --tmdb <id>

• 如果输出包含posterUrl，你可以下载并附加它：

./skills/radarr/scripts/fetch_asset.py --url "<posterUrl>" --out "./outbound/radarr/<tmdbId>.jpg"

如果OMDB_API_KEY如果设置了IMDb且已知IMDb ID，卡片将包含IMDb评分。

4) 添加到Radarr

尽可能使用TMDB：

./skills/radarr/scripts/radarr.sh add --tmdb <id> --profile "<profile>" --root "<root>" --monitor --search

5) 在同一聊天中跟踪进度并通知（仅限Radarr，轮询方式）

此功能提供了基于文件的追踪队列：

1. 将追踪任务加入队列，针对同一聊天即请求来源的聊天（私信或群组）：

./skills/radarr/scripts/enqueue_track.py --channel telegram --target "<chatId>" --movie-id <id> --title "<title>" --year <year>

2. 应运行一个定期调度器：

./skills/radarr/scripts/poll_and_queue.py

这将在./state/radarr/outbox/目录下创建发件箱项目，以便您的OpenClaw cron运行器发送。

6) Plex链接（可选附加功能）

如果配置了Plex，尝试生成Plex网页URL：

./skills/radarr/scripts/plex_link.py --title "<title>" --year <year>

参考资料

• 入门指南：references/onboarding.md
• 设置：references/setup.md
• API说明：references/radarr-api-notes.md