An automation skill for searching and managing TV show libraries within Sonarr via AI agent commands.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install sonarr
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install sonarr using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Sonarr?
The Sonarr skill for Openclaw Skills provides a robust interface for interacting with Sonarr's media management API. It allows users to programmatically search for television series, add them to their library with specific quality profiles, and manage existing content through an AI-driven workflow. By leveraging Openclaw Skills, developers can integrate their media stack into broader automation routines, making it easier than ever to keep a library synchronized and updated.
This skill is designed for home lab enthusiasts and developers who want to move beyond manual web UI interactions. It streamlines the discovery and acquisition process by providing direct TVDB metadata integration, ensuring that the AI agent always presents accurate and clickable series information for user confirmation.
Sonarr Use Cases
- Rapidly search for and add new TV series to a media library using CLI or natural language prompts.
- Check for the existence of specific shows within the library to prevent duplicate entries.
- Automate the removal of television series with optional filesystem cleanup.
- Retrieve system-specific configuration data like quality profiles and root folder paths for setup.
How Sonarr Works
- The user initiates a search request for a TV show title through the AI agent.
- The skill queries the Sonarr API and returns a numbered list of matches accompanied by TVDB links.
- The user selects the desired series based on the provided metadata.
- The skill verifies if the show is already in the library and adds it if necessary using a pre-configured quality profile.
- Upon adding the show, the skill can automatically trigger a search for available episodes to begin the download process immediately.
Sonarr Setup
To use this skill within Openclaw Skills, ensure you have curl and jq installed on your host machine. You must create a configuration file located at ~/.clawdbot/credentials/sonarr/config.json with your specific connection details:
{
"url": "http://localhost:8989",
"apiKey": "your-api-key",
"defaultQualityProfile": 1
}
To find your available quality profile IDs and root folder paths, execute the following command:
bash scripts/sonarr.sh config
Sonarr Data Schema & Taxonomy
The skill interacts with Sonarr's internal database and TVDB metadata. Data is organized as follows:
| Attribute | Description |
|---|---|
| tvdbId | The primary unique identifier for matching and adding series. |
| defaultQualityProfile | The integer ID representing the resolution and file size preferences. |
| URL | The endpoint of your Sonarr instance (local or remote). |
| apiKey | The authentication token found in Sonarr's General Settings. |
| Slug | Used to generate direct clickable links to thetvdb.com series pages. |
Sonarr Advanced Features
- Direct TVDB link integration for every search result to ensure data integrity.
- Immediate search-on-add support which triggers the download client as soon as a series is indexed.
- Safe removal protocols that explicitly ask for user confirmation before deleting files from the disk.
- Quality profile override capabilities allowing for custom settings per series addition.
- Lightweight bash-based implementation optimized for the Openclaw Skills environment.
SKILL.md
Loading
Related Openclaw Skills
Ralph Loop
A framework to generate autonomous bash scripts that run AI coding agents in continuous planning and building loops.
Exa Plus Neural Search
A high-performance neural search engine integration that allows AI agents to perform deep, category-specific web research and full-text content extraction.
Ikuzo Travel & Map Management
A comprehensive map and travel planning skill for managing locations, spots, and daily itineraries.
YouTube Thumbnail Grabber
A versatile tool for downloading YouTube video thumbnails in multiple resolutions and formats using yt-dlp.
GitLab Manager
A specialized automation tool to programmatically manage GitLab repositories, merge requests, and issues through a direct API interface.
Google Photos
A professional automation skill for managing Google Photos libraries, enabling programmatic uploads, album creation, and library indexing.
METADATA
Featured*
