name: aria2-rpc description: Remote control for aria2 download service via JSON-RPC 2.0. Supports adding downloads (HTTP/FTP/Torrent/Magnet), querying task status, pausing/resuming, and removing tasks. Works with local or remote aria2 instances. allowed-tools: Bash(aria2:*) homepage: https://aria2.github.io metadata: openclaw: requires: bins: [curl, python3] pip: [requests]

aria2-rpc Skill

通过 JSON-RPC 2.0 协议远程控制 aria2 下载服务。

功能

• 添加 HTTP/FTP/Magnet/Torrent 下载
• 查询任务状态、暂停/继续/删除任务
• 获取全局统计和配置
• 支持远程 aria2 实例和 RPC 认证

安装

# 安装依赖
pip3 install requests

# 配置 aria2（启用 RPC）
aria2c --enable-rpc --rpc-listen-all=true --rpc-secret=mytoken -D

快速开始

# 添加下载
python3 /root/.openclaw/workspace/skills/aria2-rpc/scripts/aria2_rpc.py add-uri "http://example.com/file.zip" --rpc-secret mytoken

# 查看进度
python3 scripts/aria2_rpc.py tell-active --rpc-secret mytoken

环境变量

export ARIA2_RPC_URL="http://localhost:6800/jsonrpc"
export ARIA2_RPC_SECRET="your-secret-token"

脚本路径

• 主脚本: /root/.openclaw/workspace/skills/aria2-rpc/scripts/aria2_rpc.py

详细文档

• 快速开始
• 配置指南
• 使用示例
• API 参考
• 配置示例