A sophisticated AI agent skill for managing aria2 downloads through a secure JSON-RPC 2.0 interface.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install aria2-json-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-json-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-json-rpc?
The aria2-json-rpc skill is a powerful extension designed for AI agents within the Openclaw Skills ecosystem, enabling seamless interaction with the aria2 download manager. It abstracts the complexity of JSON-RPC 2.0 calls into simple, executable Python scripts, allowing users to control their download workflows using natural language. Whether you are managing high-speed HTTP/HTTPS transfers, handling complex BitTorrent magnet links, or orchestrating batch FTP downloads, this skill provides the necessary glue between your AI agent and the underlying download engine.
By integrating this Openclaw Skills package, developers can empower their agents to monitor real-time progress, adjust global configuration settings, and manage download queues without manual intervention. The skill is built with a focus on reliability and security, supporting secret tokens and encrypted connections to ensure your download infrastructure remains protected while accessible via automated agents.
aria2-json-rpc Use Cases
- Automating the retrieval of large datasets or media files using magnet links or direct URLs.
- Monitoring and reporting the status of long-running downloads via an AI agent interface.
- Performing batch operations such as pausing all active tasks or clearing completed download history.
- Remotely managing a seedbox or home server download queue through natural language commands.
How aria2-json-rpc Works
- The AI agent first verifies the server connection by running a configuration test script to ensure the aria2 JSON-RPC interface is reachable.
- When a user provides a download request, the agent utilizes Openclaw Skills logic to map the intent to a specific Python-based RPC client command.
- The skill handles the construction of the JSON-RPC request, including authentication headers and parameter formatting, and sends it to the aria2 server.
- Upon receiving the server response, the script parses the results (such as GIDs or status codes) and returns them to the agent for human-readable output.
aria2-json-rpc Setup
To get started with this Openclaw Skills component, ensure you have Python 3.6+ and the websockets package installed:
pip install websockets
Initialize your user configuration to ensure settings persist across updates:
python3 scripts/config_loader.py init --user
Configure your aria2 server details in ~/.config/aria2-skill/config.json. You must specify the host, port, and RPC secret if applicable. Finally, verify your setup with the test command:
python3 scripts/config_loader.py test
aria2-json-rpc Data Schema & Taxonomy
The skill organizes its operation around a centralized configuration file and tracks tasks using aria2 Global Identifiers (GIDs). Data is structured as follows:
| Field | Type | Description |
|---|---|---|
| host | String | The IP address or hostname of the aria2 server. |
| port | Integer | The port number for the RPC interface (default 6800). |
| secret | String | The authentication token for the RPC server. |
| path | String | The URL path for the JSON-RPC endpoint. |
| secure | Boolean | Enables or disables HTTPS/SSL encryption. |
All download tasks return a GID which is used for subsequent management actions like pausing, resuming, or querying status.
aria2-json-rpc Advanced Features
- Multi-tier configuration priority that supports environment variables, project-level settings, and global user configs.
- Support for advanced protocols including Magnet links, Torrents, and Metalinks with custom option overrides.
- Real-time monitoring capabilities to track download speed, remaining time, and peer connectivity.
- Automated maintenance tools to purge download results and manage global server statistics through Openclaw Skills automation.
SKILL.md
Loading
Related Openclaw Skills
Gmail Auto-Reply for Client
An AI-powered skill that drafts and manages personalized Gmail responses based on specific client profiles and templates.
Model Fallback Skill
A robust multi-model fallback system that ensures AI agent reliability by automatically switching to backup models during primary API failures.
DailyBit AI Tech Digest
A high-signal AI agent skill that curates and summarizes the top 92 global tech blogs into personalized, multi-language daily briefings.
Foresigxt Memory (fsxmemory)
Foresigxt Memory is a structured storage and context resilience system designed to give AI agents persistent, searchable, and organized memory.
Hyperliquid Market Analyzer
A specialized market analysis utility for the Hyperliquid DEX that provides real-time price tracking, trend detection, and automated risk scoring.
Stealth Browser
An advanced anti-detection web browsing skill that leverages puppeteer-extra and residential proxies to bypass sophisticated bot protections.
Featured*
