A specialized interface for controlling aria2 download services remotely using the JSON-RPC 2.0 protocol.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install aria2-rpc
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 aria2-rpc 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 aria2-rpc?
The aria2-rpc skill provides a robust interface for AI agents to interact with the aria2 download utility via the JSON-RPC 2.0 protocol. By integrating this into your Openclaw Skills library, you enable agents to handle complex downloading tasks across multiple protocols including HTTP, FTP, BitTorrent, and Magnet links. This skill is designed for developers who need to bridge the gap between AI-driven logic and low-level file acquisition on either local or remote instances.
This implementation focuses on providing a clean, scriptable layer for managing the lifecycle of download tasks. Whether it is adding new URIs, pausing active transfers, or querying global statistics, this skill offers the necessary tools to build sophisticated automation pipelines within the Openclaw Skills framework.
aria2-rpc Use Cases
- Automating the retrieval of large datasets from HTTP or FTP sources via AI commands.
- Managing BitTorrent and Magnet link downloads on headless remote servers.
- Building automated media acquisition workflows that monitor and react to download progress.
- Integrating download management into self-hosted devops pipelines using Openclaw Skills.
How aria2-rpc Works
- The AI agent invokes the provided Python script to establish a connection with the aria2 daemon via the JSON-RPC endpoint.
- The skill authenticates using a pre-configured RPC secret to ensure secure communication with the service.
- Commands such as add-uri or tell-status are translated into JSON-RPC 2.0 requests and transmitted to the aria2 instance.
- The aria2 service processes the request and returns a JSON response containing task metadata or execution status.
- The agent parses the results to inform the user of progress or to trigger subsequent automated tasks within the Openclaw Skills ecosystem.
aria2-rpc Setup
To utilize this skill, ensure that python3 and requests are installed, and that aria2 is running with RPC enabled:
# Install required Python dependencies
pip3 install requests
# Start the aria2 daemon with RPC enabled
aria2c --enable-rpc --rpc-listen-all=true --rpc-secret=my-secret-token -D
# Set environment variables for the skill to connect
export ARIA2_RPC_URL="http://localhost:6800/jsonrpc"
export ARIA2_RPC_SECRET="my-secret-token"
aria2-rpc Data Schema & Taxonomy
The skill manages task metadata and interacts with the aria2 state. Data is typically organized as follows:
| Property | Description |
|---|---|
| gid | The unique global ID for the download task. |
| status | Current task state (active, waiting, paused, error, complete). |
| downloadSpeed | Current download rate in bytes per second. |
| totalLength | Total size of the files being downloaded in bytes. |
| connections | Number of active connections for the specific task. |
All configurations are handled through the aria2_rpc.py main script located in the skill's scripts directory.
aria2-rpc Advanced Features
- Support for remote aria2 instances across different networks using secure RPC authentication.
- Multi-protocol handling for seamless switching between standard web downloads and peer-to-peer transfers.
- Detailed global statistics retrieval to monitor overall server bandwidth and resource usage.
- Extensible CLI interface that can be integrated into larger Openclaw Skills automation playbooks.
SKILL.md
Loading
Related Openclaw Skills
apktool
A professional command-line utility for reverse engineering Android APK files, enabling developers to decode, modify, and rebuild applications.
VHS Recorder
A specialized automation skill for generating professional terminal recordings and CLI demos using scripted tape files.
Skill Condenser
A specialized tool that uses Chain-of-Density iterations to compress verbose SKILL.md files into terse, structured, and highly efficient documentation.
PARA PKM Manager
A powerful organizational skill for managing personal knowledge using the PARA method to optimize for AI agent navigation and human actionability.
arxiv-cli-tools
A streamlined command-line interface for rapid discovery and bulk downloading of scientific papers from arXiv.
marp-cli
A versatile command-line utility that transforms Markdown documents into professional presentation decks across multiple formats.
METADATA
Featured*
