sonarr

What This Skill Does

The Sonarr skill for OpenClaw provides a powerful interface for automating the management of your TV show library. By acting as a bridge between the OpenClaw agent and your local Sonarr installation, it allows you to search for new content, retrieve metadata, and add series directly to your library without needing to access the Sonarr web interface. It handles the identification process via TVDB, manages quality profiles automatically based on your saved configuration, and provides granular control over library management, including show removal and file cleanup.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/jordyvandomselaar/sonarr. After installation, you must configure your credentials to allow OpenClaw to communicate with your Sonarr API. Create the file ~/.clawdbot/credentials/sonarr/config.json with the following structure: {"url": "http://localhost:8989", "apiKey": "your-api-key", "defaultQualityProfile": 1}. You can discover your available quality profiles and root folders by running bash scripts/sonarr.sh config.

Use Cases

This skill is ideal for power users who want to streamline their media collection. Common use cases include: quickly adding a new show that a friend recommended, checking if a specific series is already being tracked in your library, or cleaning up storage by removing shows and their associated media files. It is particularly useful for users managing large libraries who prefer using natural language or command-line shortcuts over a graphical dashboard.

Example Prompts

1. "OpenClaw, search for the show 'The Bear' and let me know if it's available to add."
2. "I want to add the show with TVDB ID 420803 using my default quality profile and trigger an immediate search."
3. "I'm running out of space. Can you remove the show with TVDB ID 355026 and delete all the associated video files?"

Tips & Limitations

Always ensure your Sonarr API key is secure and not shared. When searching, OpenClaw returns a list of results with clickable TVDB links—use these to verify you are adding the correct show, especially for common titles. Note that the removal command is destructive if the --delete-files flag is used; the skill is designed to force a confirmation prompt to prevent accidental data loss. If you encounter issues, verify that your Sonarr URL is reachable from the machine where OpenClaw is running and that your API key is correctly formatted in the configuration file.