moviepilot

What This Skill Does

The MoviePilot skill is a powerful automation agent designed to streamline your media management workflow. It serves as an interface between the OpenClaw AI and the MoviePilot media server. By integrating with the MoviePilot API, this skill enables users to search for movies and TV shows, manage automated subscriptions, track download progress, and browse trending content from platforms like TMDB, Douban, and Bangumi. It removes the need to manually navigate web interfaces, allowing for a conversational experience where you simply ask the agent to find or subscribe to your favorite content.

Installation

To begin using the MoviePilot skill, ensure you have the OpenClaw environment properly configured. Install the skill by running the following command in your terminal: clawhub install openclaw/skills/skills/codfrm/moviepilot

Before executing any commands, you must define the following environment variables in your system configuration:

• MOVIEPILOT_URL: The base URL of your active MoviePilot server.
• MOVIEPILOT_API_KEY or MOVIEPILOT_TOKEN: Authentication credentials required to authorize API requests.

Use Cases

This skill is ideal for media enthusiasts who want to automate their entertainment library. Key use cases include:

• Automating the subscription process for ongoing TV series to ensure episodes are downloaded as soon as they become available.
• Discovering new content via integrated recommendation feeds.
• Managing current download queues to check for status or errors.
• Quickly searching for specific titles to confirm metadata (year, ID, and type) before adding them to your library.

Example Prompts

1. "帮我订阅最新一季的《权力的游戏》，确保是高清资源。"
2. "查看一下我当前订阅了哪些电视剧，并列出它们的下载状态。"
3. "我想看看最近热门的电影推荐，有哪些值得下载的？"

Tips & Limitations

• Search First: Always perform a search before attempting to subscribe. This ensures the agent captures the correct tmdb_id or douban_id, which prevents subscription errors.
• Language: Note that the type parameter in the API requires the specific Chinese strings: "电影" for movies and "电视剧" for TV shows.
• Multiple Matches: If a search returns multiple entries with similar names, the agent will prompt you to confirm the correct year or ID. Be specific with release years to speed up the process.
• Credentials: Ensure your network has access to the MOVIEPILOT_URL if you are hosting the service behind a reverse proxy or a local firewall.