aria2-json-rpc

What This Skill Does

The aria2-json-rpc skill empowers your AI agent to act as a sophisticated download manager by interfacing directly with an aria2 RPC server. It provides a robust, standardized bridge to manage HTTP, HTTPS, FTP, Magnet, and Torrent downloads entirely through natural language. Instead of manually navigating web interfaces or command-line clients, you can orchestrate complex file management workflows, track progress, pause or resume tasks, and remove completed downloads using simple, intent-driven instructions.

Installation

To integrate this capability into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/azzgo/aria2-json-rpc Once installed, ensure your environment is prepared by verifying configurations with python3 scripts/config_loader.py test. If this fails, run python3 scripts/config_loader.py init --user to generate a configuration file, then update it with your specific aria2 RPC server credentials.

Use Cases

• Bulk Content Acquisition: Automatically initiate and monitor a long list of file downloads from various sources without manual intervention.
• Automated Media Pipelines: Integrate aria2 into larger workflows where media assets, datasets, or software packages are dynamically fetched from remote URLs.
• Background Management: Efficiently handle high-volume file transfers in the background, allowing the AI to query status or troubleshoot stalled downloads as they happen.
• Torrent Seeding & Management: Manage peer-to-peer file sharing protocols with precise control over individual torrent tasks, priority, and resource usage.

Example Prompts

1. "Download the latest build from https://example.com/software.tar.gz and notify me once it hits 50%."
2. "List all my active downloads and pause the one with GID 2089b05ecca3d829."
3. "Show me the current download speed and remaining time for all ongoing torrent tasks."

Tips & Limitations

• Strict Python Usage: Always utilize python3 when invoking scripts to ensure compatibility with modern environments and avoid symlink issues.
• Avoid Manual JSON: Never manually construct JSON-RPC payloads; always rely on the provided Python scripts to ensure correct schema adherence.
• Configuration First: Always include a pre-flight check (config_loader.py test) in your internal agent logic to prevent runtime exceptions.
• Security: aria2 RPC can expose file system access. Ensure your RPC server is password-protected and not exposed to the public internet.