sabnzbd – OpenClaw Skill

---

name: sabnzbd version: 1.0.0 description: Manage Usenet downloads with SABnzbd. Use when the user asks to "check SABnzbd", "list NZB queue", "add NZB", "pause downloads", "resume downloads", "SABnzbd status", "Usenet queue", "NZB history", or mentions SABnzbd/sab download management.

SABnzbd API

Manage Usenet downloads via SABnzbd's REST API.

Setup

Config: ~/.clawdbot/credentials/sabnzbd/config.json

{
  "url": "http://localhost:8080",
  "apiKey": "your-api-key-from-config-general"
}

Get your API key from SABnzbd Config → General → Security.

Quick Reference

Queue Status

# Full queue
./scripts/sab-api.sh queue

# With filters
./scripts/sab-api.sh queue --limit 10 --category tv

# Specific job
./scripts/sab-api.sh queue --nzo-id SABnzbd_nzo_xxxxx

Add NZB

# By URL (indexer link)
./scripts/sab-api.sh add "https://indexer.com/get.php?guid=..."

# With options
./scripts/sab-api.sh add "URL" --name "My Download" --category movies --priority high

# By local file
./scripts/sab-api.sh add-file /path/to/file.nzb --category tv

Priority: force, high, normal, low, paused, duplicate

Control Queue

./scripts/sab-api.sh pause              # Pause all
./scripts/sab-api.sh resume             # Resume all
./scripts/sab-api.sh pause-job <nzo_id>
./scripts/sab-api.sh resume-job <nzo_id>
./scripts/sab-api.sh delete <nzo_id>    # Keep files
./scripts/sab-api.sh delete <nzo_id> --files  # Delete files too
./scripts/sab-api.sh purge              # Clear queue

Speed Control

./scripts/sab-api.sh speedlimit 50      # 50% of max
./scripts/sab-api.sh speedlimit 5M      # 5 MB/s
./scripts/sab-api.sh speedlimit 0       # Unlimited

History

./scripts/sab-api.sh history
./scripts/sab-api.sh history --limit 20 --failed
./scripts/sab-api.sh retry <nzo_id>     # Retry failed
./scripts/sab-api.sh retry-all          # Retry all failed
./scripts/sab-api.sh delete-history <nzo_id>

Categories & Scripts

./scripts/sab-api.sh categories
./scripts/sab-api.sh scripts
./scripts/sab-api.sh change-category <nzo_id> movies
./scripts/sab-api.sh change-script <nzo_id> notify.py

Status & Info

./scripts/sab-api.sh status             # Full status
./scripts/sab-api.sh version
./scripts/sab-api.sh warnings
./scripts/sab-api.sh server-stats       # Download stats

Response Format

Queue slot includes:

• nzo_id, filename, status
• mb, mbleft, percentage
• timeleft, priority, cat
• script, labels

Status values: Downloading, Queued, Paused, Propagating, Fetching

History status: Completed, Failed, Queued, Verifying, Repairing, Extracting

SABnzbd Skill

Manage Usenet downloads via SABnzbd from Clawdbot.

What It Does

• Queue management — view, pause, resume, delete downloads
• Add NZBs — by URL or local file
• Speed control — limit download speeds
• History — view completed/failed downloads, retry failed
• Categories & scripts — organize and automate

Setup

1. Get Your API Key

1. Open SABnzbd web UI
2. Go to Config → General → Security
3. Copy your API Key

2. Create Credentials File

mkdir -p ~/.clawdbot/credentials/sabnzbd
cat > ~/.clawdbot/credentials/sabnzbd/config.json << 'EOF'
{
  "url": "http://localhost:8080",
  "apiKey": "your-api-key-here"
}
EOF

Replace:

• http://localhost:8080 with your SABnzbd URL
• your-api-key-here with your actual API key

3. Test It

./skills/sabnzbd/scripts/sab-api.sh status

Usage Examples

Queue management

# View queue
sab-api.sh queue

# Pause/resume all
sab-api.sh pause
sab-api.sh resume

# Pause specific job
sab-api.sh pause-job SABnzbd_nzo_xxxxx

Add downloads

# Add by URL
sab-api.sh add "https://indexer.com/get.php?guid=..."

# Add with options
sab-api.sh add "URL" --name "My Download" --category movies --priority high

# Add local NZB file
sab-api.sh add-file /path/to/file.nzb --category tv

Speed control

sab-api.sh speedlimit 50    # 50% of max
sab-api.sh speedlimit 5M    # 5 MB/s
sab-api.sh speedlimit 0     # Unlimited

History

sab-api.sh history
sab-api.sh history --limit 20 --failed
sab-api.sh retry <nzo_id>       # Retry failed
sab-api.sh retry-all            # Retry all failed

Environment Variables (Alternative)

Instead of a config file, you can set:

export SAB_URL="http://localhost:8080"
export SAB_API_KEY="your-api-key"

Troubleshooting

"Missing URL or API key"
→ Check your config file exists at ~/.clawdbot/credentials/sabnzbd/config.json

Connection refused
→ Verify your SABnzbd URL is correct and accessible

401 Unauthorized
→ Your API key is invalid — check SABnzbd Config → General

License

MIT