qbittorrent

What This Skill Does

The qBittorrent skill for OpenClaw provides a powerful command-line interface wrapper for the qBittorrent WebUI API. It enables users to interact with their torrent client directly through natural language or automated scripts. By bridging OpenClaw with your qBittorrent instance, this skill allows for complete lifecycle management of torrents, including adding new downloads via magnet links or torrent files, monitoring real-time transfer speeds, organizing content via categories and tags, and controlling download/upload status. Whether you are running a media server or just managing personal downloads, this skill turns your local or remote torrent client into a programmable, AI-driven asset.

Installation

To install this skill, run the following command in your terminal: clawhub install openclaw/skills/skills/jmagar/qbittorrent

After installation, ensure you have configured your credentials correctly at ~/.clawdbot/credentials/qbittorrent/config.json. Populate this file with your WebUI URL (e.g., http://localhost:8080), username, and password to grant OpenClaw the necessary permissions to communicate with your qBittorrent instance.

Use Cases

This skill is ideal for users who want to automate their file management workflow. Common use cases include:

• Automating the addition of torrents from trusted sources without manual intervention.
• Remotely pausing or resuming downloads to manage bandwidth usage during peak hours.
• Bulk re-categorizing files to organize media libraries automatically.
• Generating daily summaries of download health, speed, and completed items.
• Keeping your torrent client clean by deleting finished tasks while optionally purging the actual files to save disk space.

Example Prompts

1. "OpenClaw, please list all active downloads and tell me the estimated time to completion for the current movie files."
2. "Add this magnet link to qBittorrent and set its category to 'movies' so it is organized correctly."
3. "Pause all current downloads and show me the global speed statistics for my qBittorrent client."

Tips & Limitations

• Security: Always ensure your qBittorrent WebUI is protected by a strong password, especially if the URL is accessible from your local network or the internet.
• Performance: While the skill handles large numbers of torrents well, avoid calling the list command too frequently in tight loops to prevent unnecessary load on the WebUI API.
• Compatibility: Ensure your qBittorrent version is 4.1 or higher. Older versions may not support all API endpoints required for advanced features like tag management or detailed transfer speed controls.
• Data Safety: When using the delete command with the --files flag, be aware that this action is irreversible. Always double-check the torrent hash before instructing the agent to delete associated local files.