openclaw-master-skills/skills/clawarr-suite

🎬 ClawARR Suite

Unified deep-integration control for self-hosted media automation stacks.

ClawARR Suite is an OpenClaw agent skill that gives your AI assistant full operational control over your entire *arr media stack — from library analytics to download management to Plex collection automation.

24 scripts · 8,500+ lines · 180+ subcommands · 8 reference docs

---

✨ What Can It Do?

Category	Capabilities
📊 Library Analytics	Stats, quality profiles, missing content, disk usage, genre/year distributions
👀 Viewing Analytics	Current streams, watch history, most watched, peak hours, user stats
🎬 Content Management	Add/remove movies & series, calendars, wanted lists, history
📝 Request Handling	Overseerr approval workflows, stats, bulk actions
💬 Subtitles	Bazarr wanted/search/history/languages
🔍 Indexer Management	Prowlarr indexer control, testing, cross-app sync
⬇️ Downloads	SABnzbd active/speed/queue/pause/resume
🎯 Quality Profiles	Recyclarr TRaSH Guides sync, diff preview
🧹 Library Cleanup	Maintainerr rules, collections, exclusions
🔔 Notifications	Notifiarr status, triggers, service health
🖼️ Collections & Overlays	Kometa/PMM automation for Plex
📦 Archive Extraction	Unpackerr monitoring and error tracking
📡 Media Tracking	Trakt.tv, Letterboxd, Simkl — sync, export, discovery
📈 Dashboards	Self-contained HTML dashboard generation
🔧 Setup & Diagnostics	Auto-discovery, guided setup, troubleshooting

---

📦 Install

From ClawHub (recommended)

clawhub install clawarr-suite

⚠️ Note: This skill is currently flagged for review by ClawHub's automated security scanner. The flag is a false positive — the scanner detected standard patterns (bash eval for env vars, WebRTC for LAN discovery, Docker commands, API key handling) that are inherent to media server management. We've submitted a review request and are waiting for the flag to be lifted.

View on ClawHub · Review request →

From GitHub

git clone https://github.com/omiron33/clawarr-suite.git ~/.openclaw/skills/clawarr-suite

Manual

Copy the clawarr-suite folder into your OpenClaw skills directory:

~/.openclaw/skills/clawarr-suite/
├── SKILL.md          # Agent documentation (OpenClaw reads this)
├── scripts/          # 24 bash scripts
└── references/       # 8 reference docs

2. Run setup

Tell your agent:

"Set up ClawARR for my media server at 192.168.1.100"

Or run manually:

scripts/setup.sh 192.168.1.100

This auto-discovers services, extracts API keys, verifies connections, and outputs your config.

3. Start using it

Just talk to your agent naturally:

• "Show me what's downloading right now"
• "What movies were added this week?"
• "Generate a dashboard of my media library"
• "Sync my Plex watch history to Trakt"
• "What are the most watched shows this month?"
• "Run Kometa to update my Plex collections"
• "Show cleanup rules and what's flagged for deletion"

---

🛠️ Supported Services

Core Stack

Service	Port	Script
Sonarr	8989	library.sh, manage.sh, search.sh
Radarr	7878	library.sh, manage.sh, search.sh
Lidarr	8686	library.sh
Readarr	8787	library.sh
Prowlarr	9696	prowlarr.sh
Bazarr	6767	subtitles.sh
Overseerr	5055	requests.sh
Plex	32400	analytics.sh
Tautulli	8181	analytics.sh
SABnzbd	38080	downloads.sh

Companion Services

Service	Port	Script	Purpose
Recyclarr	—	recyclarr.sh	TRaSH Guides quality profile sync
Unpackerr	—	unpackerr.sh	Auto-extract archives from downloads
Notifiarr	5454	notifiarr.sh	Unified notification routing
Maintainerr	6246	maintainerr.sh	Automated library cleanup
Kometa	—	kometa.sh	Plex collections & overlays
FlareSolverr	8191	—	Cloudflare bypass for indexers

Media Trackers

Service	Script	Features
Trakt.tv	trakt.sh	Auth, history, ratings, watchlists, scrobbling, discovery, sync
Letterboxd	letterboxd.sh	CSV export/import, profile stats
Simkl	simkl.sh	Auth, sync, watchlist, stats
Traktarr	trakt.sh	Auto-add from Trakt lists → Radarr/Sonarr
Retraktarr	trakt.sh	Sync library → Trakt lists

---

⚙️ Configuration

Set environment variables or use setup.sh to generate them:

# Required — your server's IP or hostname
export CLAWARR_HOST=192.168.1.100

# Core services (setup.sh auto-discovers these)
export SONARR_KEY=your_api_key
export RADARR_KEY=your_api_key
export PLEX_TOKEN=your_plex_token
export TAUTULLI_KEY=your_api_key
export SABNZBD_KEY=your_api_key

# Optional services
export PROWLARR_KEY=your_api_key
export BAZARR_KEY=your_api_key
export OVERSEERR_KEY=your_api_key
export NOTIFIARR_KEY=your_api_key

# Docker-based companions (SSH access to your server)
export RECYCLARR_SSH=mynas
export KOMETA_SSH=mynas
export UNPACKERR_SSH=mynas
export DOCKER_CONFIG_BASE=/opt/docker   # Default: /volume1/docker (Synology)

# Media trackers (register your own apps)
# Trakt: https://trakt.tv/oauth/applications/new
export TRAKT_CLIENT_ID=your_client_id
export TRAKT_CLIENT_SECRET=your_client_secret

# Simkl: https://simkl.com/settings/developer
export SIMKL_CLIENT_ID=your_client_id
export SIMKL_CLIENT_SECRET=your_client_secret

---

📖 Documentation

Document	Description
SKILL.md	Full agent documentation — every command, workflow, and example. This is what OpenClaw reads.
references/api-endpoints.md	Complete API reference for all services
references/setup-guide.md	Platform-specific installation (Docker, Synology, Unraid, Linux)
references/common-issues.md	Troubleshooting guide with solutions
references/companion-services.md	Prowlarr, Recyclarr, FlareSolverr, Unpackerr, Notifiarr, Maintainerr, Kometa
references/tracker-apis.md	Media tracker API documentation
references/traktarr-retraktarr.md	Traktarr & Retraktarr automation guide
references/prompts.md	50+ example natural-language prompts
references/dashboard-templates.md	HTML/CSS templates for dashboards

For AI agents: Read SKILL.md — it contains complete command references, environment variable documentation, workflows, and example prompts optimized for agent consumption.

---

📋 Requirements

• bash 3.2+ (macOS default is fine)
• curl, jq, bc, sed — standard on macOS and Linux
• SSH access for Docker-based companion services
• No Node.js, Python, or other runtimes required

---

🏗️ Supported Platforms

• Docker — any host
• Synology NAS — DSM 7+
• Unraid — Community Applications
• Linux — bare metal or VM
• macOS — client-side scripts (server runs elsewhere)

---

🗺️ Roadmap

• Torrent client support (qBittorrent, Transmission, Deluge)
• Jellyfin / Emby analytics
• Backup & restore workflows
• Native OpenClaw plugin (TypeScript, in progress)

---

📄 License

MIT — see LICENSE for details.

---

Built for OpenClaw · Community · More Skills