---

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"