# Send Aria2 Json Rpc to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "aria2-json-rpc", "name": "Aria2 Json Rpc", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/azzgo/aria2-json-rpc", "canonicalUrl": "https://clawhub.ai/azzgo/aria2-json-rpc", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/aria2-json-rpc", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=aria2-json-rpc", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "CONFIG.md", "IMPLEMENTATION_SUMMARY.md", "SKILL.md", "config.example.json", "references/aria2-methods.md", "references/execution-guide.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "aria2-json-rpc", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T04:58:44.809Z", "expiresAt": "2026-05-07T04:58:44.809Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=aria2-json-rpc", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=aria2-json-rpc", "contentDisposition": "attachment; filename=\"aria2-json-rpc-0.1.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "aria2-json-rpc" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/aria2-json-rpc" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/aria2-json-rpc", "downloadUrl": "https://openagent3.xyz/downloads/aria2-json-rpc", "agentUrl": "https://openagent3.xyz/skills/aria2-json-rpc/agent", "manifestUrl": "https://openagent3.xyz/skills/aria2-json-rpc/agent.json", "briefUrl": "https://openagent3.xyz/skills/aria2-json-rpc/agent.md" } } ``` ## Documentation ### What This Skill Does This skill enables you to control aria2 download manager through natural language commands: Download files (HTTP/HTTPS/FTP/Magnet/Torrent/Metalink) Monitor download progress and status Control downloads (pause, resume, remove) Manage batch operations (pause all, resume all) View statistics and configure options ### How to Use (For AI Agents) ⚠️ CRITICAL: DO NOT manually construct JSON-RPC requests. ✅ ALWAYS use the Python scripts in the scripts/ directory. ⚠️ IMPORTANT: Use python3 command, NOT python (especially on macOS where python symlink doesn't exist) ### Workflow (MUST FOLLOW) Step 1: Check Configuration Status Before executing any aria2 commands, ALWAYS check if configuration is ready: python3 scripts/config_loader.py test If successful: Proceed to execute user's command If failed: Guide user to initialize configuration (see Step 2) Step 2: Initialize Configuration (if needed) If connection test fails, guide user to set up configuration: # Recommended: User config (survives skill updates) python3 scripts/config_loader.py init --user # Alternative: Local config (project-specific) python3 scripts/config_loader.py init --local Then instruct user to edit the generated config file with their aria2 server details. Step 3: Execute User Commands Once configuration is ready, execute the requested aria2 operations. ### Example Workflow User: "download http://example.com/file.zip" You execute: # 1. Check configuration python3 scripts/config_loader.py test If test passes: # 2. Execute download command python3 scripts/rpc_client.py aria2.addUri '["http://example.com/file.zip"]' You respond: "✓ Download started! GID: 2089b05ecca3d829" If test fails: Configuration not ready. Please initialize: 1. Run: python3 scripts/config_loader.py init --user 2. Edit ~/.config/aria2-skill/config.json with your aria2 server details 3. Run: python3 scripts/config_loader.py test (to verify) ### Documentation Structure For detailed execution instructions, see: references/execution-guide.md - Complete guide for AI agents with: Command mapping table (user intent → script call) Parameter formatting rules Step-by-step examples Common mistakes to avoid Response formatting guidelines For aria2 method reference, see: references/aria2-methods.md - Detailed aria2 RPC method documentation ### Common Commands Quick Reference User IntentCommand ExampleDownload a filepython3 scripts/rpc_client.py aria2.addUri '["http://example.com/file.zip"]'Check statuspython3 scripts/rpc_client.py aria2.tellStatus List active downloadspython3 scripts/rpc_client.py aria2.tellActiveList stopped downloadspython3 scripts/rpc_client.py aria2.tellStopped 0 100Pause downloadpython3 scripts/rpc_client.py aria2.pause Resume downloadpython3 scripts/rpc_client.py aria2.unpause Show statisticspython3 scripts/rpc_client.py aria2.getGlobalStatShow versionpython3 scripts/rpc_client.py aria2.getVersionPurge resultspython3 scripts/rpc_client.py aria2.purgeDownloadResult For detailed usage and more commands, see execution-guide.md. ### Available Scripts scripts/rpc_client.py - Main interface for RPC calls scripts/examples/list-downloads.py - Formatted download list scripts/examples/pause-all.py - Pause all downloads scripts/examples/add-torrent.py - Add torrent downloads scripts/examples/monitor-downloads.py - Real-time monitoring scripts/examples/set-options.py - Modify options ### Configuration Scripts automatically load configuration from multiple sources with the following priority (highest to lowest): ### Configuration Priority Environment Variables (highest priority - temporary override) ARIA2_RPC_HOST, ARIA2_RPC_PORT, ARIA2_RPC_PATH, etc. Best for: CI/CD pipelines, temporary overrides, testing Note: For reference only. Agents should use config files instead. Skill Directory Config (project-specific configuration) Location: skills/aria2-json-rpc/config.json Best for: Project-specific settings, local testing, development ⚠️ Warning: Lost when running npx skills add to update the skill User Config Directory (global fallback, update-safe) 🆕 Location: ~/.config/aria2-skill/config.json Best for: Personal default settings across all projects ✅ Safe: Survives skill updates via npx skills add Defaults (localhost:6800) Zero-configuration fallback for local development ### Configuration Options host: Hostname or IP address (default: localhost) port: Port number (default: 6800) path: URL path (default: null). Set to /jsonrpc for standard aria2, or custom path for reverse proxy secret: RPC secret token (default: null) secure: Use HTTPS instead of HTTP (default: false) timeout: Request timeout in milliseconds (default: 30000) ### Quick Setup (For AI Agents) IMPORTANT: Always use Python scripts to manage configuration. Do NOT use shell commands directly. Step 1: Check current configuration status python3 scripts/config_loader.py show Step 2: Initialize configuration if needed User config (recommended - survives updates): python3 scripts/config_loader.py init --user Local config (project-specific): python3 scripts/config_loader.py init --local Step 3: Guide user to edit the config file After initialization, the tool will display the config file path. Instruct user to edit it with their aria2 server details (host, port, secret, etc.). Step 4: Verify configuration python3 scripts/config_loader.py test Example config file content: { "host": "localhost", "port": 6800, "secret": "your-secret-token", "secure": false, "timeout": 30000 } ### Configuration Management (For AI Agents) Available Python scripts for configuration management: # Check current configuration and source python3 scripts/config_loader.py show # Initialize user config (recommended - update-safe) python3 scripts/config_loader.py init --user # Initialize local config (project-specific) python3 scripts/config_loader.py init --local # Test connection to aria2 server python3 scripts/config_loader.py test Agent Workflow for Configuration Setup: Check if config exists: Run python3 scripts/config_loader.py show If config missing or invalid: Guide user to run python3 scripts/config_loader.py init --user User edits config: Tell user the file path and required fields (host, port, secret) Verify setup: Run python3 scripts/config_loader.py test Proceed with operations: Once test passes, execute user's aria2 commands ### Advanced Configuration Reverse Proxy Setup: For reverse proxy setups like https://example.com:443/jsonrpc, the config file should contain: { "host": "example.com", "port": 443, "path": "/jsonrpc", "secret": "your-secret-token", "secure": true } Environment Variables (for reference only): Configuration can also be overridden via environment variables: ARIA2_RPC_HOST: Hostname ARIA2_RPC_PORT: Port number ARIA2_RPC_PATH: URL path ARIA2_RPC_SECRET: Secret token ARIA2_RPC_SECURE: "true" or "false" Note: Use Python scripts for configuration management. Environment variables are documented here for reference only. ### Key Principles (For AI Agents) Never construct JSON-RPC requests manually Always call Python scripts via Bash tool using python3 (not python) Always check configuration before executing commands: Run python3 scripts/config_loader.py test first If test fails, guide user through initialization Never run raw shell commands (mkdir, cat, export, etc.) directly Use Python scripts: config_loader.py init, config_loader.py show, etc. Parse script output and format for users Refer to execution-guide.md when unsure ### Download Management Add downloads (HTTP/FTP/Magnet/Torrent/Metalink) Pause/resume (individual or all) Remove downloads Add with custom options ### Monitoring Check download status List active/waiting/stopped downloads Get global statistics Real-time monitoring ### Configuration Get/change download options Get/change global options Query aria2 version List available methods ### Maintenance Purge download results Remove specific results ### Need Help? Execution details: references/execution-guide.md Method reference: references/aria2-methods.md Troubleshooting: references/troubleshooting.md aria2 official docs: https://aria2.github.io/ ## Trust - Source: tencent - Verification: Indexed source record - Publisher: azzgo - Version: 0.1.0 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-04-30T04:58:44.809Z - Expires at: 2026-05-07T04:58:44.809Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/aria2-json-rpc) - [Send to Agent page](https://openagent3.xyz/skills/aria2-json-rpc/agent) - [JSON manifest](https://openagent3.xyz/skills/aria2-json-rpc/agent.json) - [Markdown brief](https://openagent3.xyz/skills/aria2-json-rpc/agent.md) - [Download page](https://openagent3.xyz/downloads/aria2-json-rpc)