A powerful integration for managing and automating TV series discovery, library organization, and download monitoring through the Sonarr REST API.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install minerva-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 minerva-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 provides a robust interface for interacting with the premier TV show management tool within the *arr media suite. This integration allows users of Openclaw Skills to programmatically monitor series, find episode releases via indexers, and automate the organization of media on disk. By leveraging the Sonarr REST API, this skill bridges the gap between your AI agent and your self-hosted media server, enabling hands-free library management and content discovery.
Designed for developers and media enthusiasts, this tool handles everything from metadata lookups using TVDB IDs to managing quality profiles and root folder paths. Whether you are building a custom media dashboard or an automated content request system, this skill provides the essential building blocks for deep integration with the Sonarr ecosystem.
Sonarr Use Cases
- Automating the discovery and addition of new TV series based on metadata lookups.
- Identifying and triggering downloads for missing or wanted episodes in a media library.
- Monitoring the active download queue to provide status updates on content availability.
- Programmatically triggering library-wide searches for missing media to ensure library completeness.
How Sonarr Works
- The agent establishes a connection to the Sonarr instance via the local network URL and a securely stored API key.
- When searching for content, the skill queries the series lookup endpoint to retrieve matching titles and their corresponding TVDB IDs.
- The agent fetches configuration metadata, such as quality profiles and root folder locations, to prepare for adding a series.
- A POST request is sent to the series endpoint with the specific configuration parameters to begin monitoring the show.
- For maintenance tasks, the agent sends commands to the API to trigger searches or polls the queue and wanted endpoints for real-time reporting.
Sonarr Setup
To use this integration with Openclaw Skills, you must first secure your API credentials and define your connection parameters. Follow these steps for configuration:
- Store your API key in the credentials folder:
echo "YOUR_SONARR_API_KEY" > ~/clawd/credentials/sonarr_api_key
- Define your connection variables in your environment or agent configuration:
SONARR_URL="http://localhost:8989"
SONARR_KEY=$(cat ~/clawd/credentials/sonarr_api_key)
Sonarr Data Schema & Taxonomy
The Sonarr skill manages structured JSON data returned from the API. Below are the primary data structures utilized:
| Object | Key Fields | Purpose |
|---|---|---|
| Series | title, tvdbId, year, qualityProfileId, rootFolderPath | Defining series metadata and storage settings |
| Episode | title, seasonNumber, episodeNumber, seriesId | Individual episode tracking within the library |
| Command | name (e.g., MissingEpisodeSearch, RescanSeries) | Triggering background server tasks |
| Queue | title, status, timeleft, size | Monitoring active downloads and transfers |
Sonarr Advanced Features
- Direct TVDB integration for high-accuracy metadata matching during the lookup process.
- Support for custom quality profile selection, allowing granular control over media resolution and file size.
- Automated search triggers for missing episodes to streamline content acquisition through Openclaw Skills.
- Real-time queue parsing to provide human-readable status updates on background download tasks.
SKILL.md
Loading
Related Openclaw Skills
Auto Skill Trigger
An automated pre-filtering mechanism that intelligently matches AI agent skills to specific user tasks based on keyword relevance and pattern scoring.
Compact Summary
A structured memory compression system that optimizes context windows by summarizing conversation history into a machine-readable format.
Audit Log Hook
A robust logging mechanism that records every tool interaction for security and performance analysis.
Error Recovery
A comprehensive framework and pattern set for implementing resilient failure handling and state recovery in AI agent workflows.
MindLog Skill for OpenClaw
MindLog acts as a dedicated memory store for OpenClaw, facilitating daily journaling prompts and automated weekly cognitive analysis via Telegram.
Windows Disk Cleaner Assistant
A secure and comprehensive Windows disk maintenance assistant that analyzes space usage and generates interactive reports for user-confirmed cleanup.
Featured*
