Aria2 Download

该 Skill 是一组命令行脚本，通过 Aria2 的 JSON-RPC 接口添加下载任务，并提供查询状态、单次进度、循环监控、等待完成和列出活跃任务等子命令；下载完成后输出文件名、路径、大小、进度等信息。配置依赖环境变量指定 RPC 地址、密钥和下载目录，文档还给出 Aria2 服务端的安装与部署方式。

ingress007

热度 85.12

最近更新 2026-05-18 12:14:41

分类：自动化依赖：代码执行 / 第三方 API / 读写文件应用场景：自动化脚本 / API 集成 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add aria2-download

Metadata

name: aria2-download
description: 通过 Aria2 RPC 添加下载任务，支持实时进度监控。
homepage: https://github.com
metadata: {"openclaw":{"emoji":"⬇️"}}

Aria2 Download

通过 Aria2 RPC 添加下载任务，支持实时进度监控。

功能

✅ 添加下载任务
✅ 实时进度监控
✅ 下载完成后输出详细信息
✅ 支持 HTTP/FTP/M3U8 等协议
✅ 多线程高速下载

配置

环境变量

变量	默认值	说明
`ARIA2_RPC_URL`	http://localhost:6800/jsonrpc	RPC 地址
`ARIA2_SECRET`	-	RPC 密钥
`ARIA2_DIR`	-	下载目录

配置示例

export ARIA2_RPC_URL="http://10.0.0.1:6800/jsonrpc"
export ARIA2_SECRET="88888888"
export ARIA2_DIR="/mnt/sda1/download"

使用方法

添加下载

aria2-download add "https://example.com/video.mp4"

查询状态

aria2-download status <gid>

单次进度

aria2-download progress <gid>

实时监控

aria2-download watch <gid> [间隔秒数]

等待完成

aria2-download wait <gid>

列出活跃任务

aria2-download list

输出示例

下载完成

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ 下载完成！
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📁 文件: video.mp4
📂 路径: /mnt/sda1/download
💾 大小: 100.50 MB (1文件)
📊 状态: 已完成
📈 进度: 100%
📥 下载量: 100.50 MB
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

实时监控

████████████████████ 100.0% | 10.0MB/s | video.mp4

Aria2 安装

Docker (推荐)

docker run -d --name aria2 \
  -p 6800:6800 \
  -v /path/to/downloads:/downloads \
  -e ARIA2_SECRET=88888888 \
  p3terx/aria2-pro

Linux

# Ubuntu/Debian
apt install aria2

# 启动 RPC
aria2c --enable-rpc --rpc-listen-all=true --rpc-secret=88888888 --dir=/path/to/downloads

macOS

brew install aria2

配合 x-media-parser 使用

# 一键解析+下载
x-aria-download "https://x.com/user/status/123"

或手动：

# 1. 解析帖子
URL=$(x-media-parser "https://x.com/user/status/123" | jq -r '.media.directUrl')

# 2. 添加下载
aria2-download add "$URL"