A robust automation interface for managing TV show libraries and search triggers within Sonarr via Openclaw.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install sonarr-fixed
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-fixed 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 (Fixed)?
Sonarr (Fixed) is a refined skill designed for the Openclaw ecosystem that enables AI agents to interact directly with Sonarr instances. This specific version is a fork created to resolve metadata declaration issues, ensuring that required credentials and configuration paths are properly recognized by the agent. By utilizing this within your collection of Openclaw Skills, you can automate the entire lifecycle of TV show management—from initial discovery and TVDB verification to library addition and automated episode searching.
This tool acts as a bridge between high-level user intent and the technical Sonarr API, providing a standardized way to handle media requests. It is particularly useful for users who want to manage their home media servers using natural language or automated scripts while maintaining strict control over quality profiles and storage locations.
Sonarr (Fixed) Use Cases
- Searching for new TV series and receiving detailed results with direct TVDB links.
- Adding new shows to a media library with specific quality profiles and immediate search triggers.
- Auditing an existing library to check for the presence of specific titles using TVDB IDs.
- Removing series from the library with the option to securely delete associated media files from disk.
How Sonarr (Fixed) Works
- The user provides a search query for a TV show to the AI agent.
- The skill executes a search against the Sonarr API and returns a formatted list of matches, each containing a TVDB link for verification.
- Upon user selection, the skill validates the series ID and checks the current configuration for the preferred quality profile.
- A POST request is sent to the Sonarr instance to add the series to the database and map it to a root folder.
- By default, the skill triggers an immediate search for monitored episodes once the series is successfully added.
Sonarr (Fixed) Setup
To integrate this into your environment, first ensure you have curl and jq installed. You must configure your credentials by creating a JSON file at ~/.openclaw/credentials/sonarr/config.json:
{
"url": "http://localhost:8989",
"apiKey": "your-api-key",
"defaultQualityProfile": 1
}
You can determine your defaultQualityProfile ID by running the config command:
bash scripts/sonarr.sh config
Alternatively, the skill supports environment variables for quick setup:
export SONARR_URL="http://your-server-ip:8989"
export SONARR_API_KEY="your-api-key-here"
Sonarr (Fixed) Data Schema & Taxonomy
The skill manages data primarily through JSON communication with the Sonarr API. It organizes information according to the following structure:
| Component | Format | Description |
|---|---|---|
| Configuration | JSON | Stores instance URL, API Key, and default quality settings. |
| Search Results | Indexed List | Displays Title, Year, and TVDB SLUG for user selection. |
| Series Metadata | TVDB ID | Uses unique integer IDs to track series across search and add actions. |
| Commands | Bash Scripts | Executes operations through a modular script-based interface. |
Sonarr (Fixed) Advanced Features
- Direct TVDB integration ensures users always see clickable links for metadata verification before adding content.
- Flexible search-on-add logic allows for immediate episode retrieval or silent library additions.
- Advanced removal options that explicitly prompt for file deletion to prevent accidental data loss.
- Support for multiple quality profiles, allowing users to choose between 1080p, 4K, or custom bitrate tiers per show.
SKILL.md
Loading
Related Openclaw Skills
Minimax Usage Monitor
A specialized monitoring utility to track Minimax Coding Plan prompt usage and stay within API limits.
ETF Investment Assistant
A professional AI-powered tool for querying ETF quotes, screening targets, and calculating investment returns through simple CLI commands.
Crypto & Gold Price Monitor
A comprehensive real-time tracking tool for cryptocurrency and precious metals prices with multi-currency support and automated alerts.
Bluetooth Device Monitor
A command-line utility for managing and monitoring Bluetooth devices and battery levels on macOS.
Dependency Audit
A cross-language automated auditor for security vulnerabilities, outdated packages, and unused dependencies.
Environment Variable Manager (env-setup)
A specialized automation skill for scanning codebases to manage environment variables, generate template files, and ensure secret security.
Featured*
