aria2远程下载控制

技能简介

该技能通过JSON-RPC 2.0协议与aria2下载管理器交互，支持用自然语言指令完成文件下载、状态查询和任务控制。

业务背景

让非技术人员也能用自然语言管理下载任务，降低aria2专业工具的使用门槛。运维和运营人员无需记忆RPC接口参数，通过对话即可完成批量资源获取与监控。适合需要从服务器远程分发文件、或在本地集中管理多来源下载素材的业务场景。

落地案例：内容运营人员需要批量获取视频素材，向技能发送'添加下载 https://example.com/video.zip 保存到Downloads'，获得任务GID后随时询问'查看下载进度'获取实时速度；发现带宽占用过高时，指令'暂停全部任务'释放网络，会议结束后执行'恢复全部'继续传输。若RPC端口配置错误，技能会明确提示连接失败并引导检查aria2服务状态。

能做什么

• 添加HTTP/HTTPS/FTP/磁力链/种子/Metalink下载任务
• 查看下载进度和实时状态
• 暂停、恢复、删除单个或全部下载任务
• 获取全局统计信息和版本信息
• 批量操作：暂停全部、恢复全部、清理已完成结果

使用说明

前置要求：Python 3.6+，WebSocket功能需安装pip install websockets

第一步：检查配置

python3 scripts/config_loader.py test

测试通过则继续，失败则执行初始化。

第二步：初始化配置（如需要）

# 用户级配置（推荐，更新后保留）
python3 scripts/config_loader.py init --user
# 或项目级配置
python3 scripts/config_loader.py init --local

编辑生成的配置文件，填入aria2服务器地址、端口、密钥等信息。

第三步：执行命令

所有操作必须通过scripts/目录下的Python脚本，禁止手动构造JSON-RPC请求。必须使用python3而非python（macOS无python软链接）。

示例：添加下载任务

python3 scripts/rpc_client.py aria2.addUri '["http://example.com/file.zip"]'

查看详细指令映射和参数规则请参考references/execution-guide.md。

输入与输出

见下方输入与输出表格。

风险提示

• 配置错误会导致RPC连接失败，请确认aria2已启用RPC模式并监听正确端口
• 使用--user初始化的配置存储在用户目录，不会被技能更新覆盖；--local配置在技能目录内，更新时可能丢失
• 环境变量优先级最高但仅作参考，建议优先使用配置文件
• 未验证的下载链接可能存在安全风险

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/azzgo/aria2-json-rpc/SKILL.md
来源类型：开源技能仓库