视频下载工具

使用方式

示例命令

帮我下载这个视频：https://www.youtube.com/watch?v=xxxxx

下载这个抖音视频：https://www.douyin.com/video/7318234567890123456

下载这个小红书笔记的视频：https://www.xiaohongshu.com/discovery/item/xxxxx

触发方式

当用户请求：

"下载视频"
"帮我下载这个视频"
提供 YouTube 链接
提供 TikTok 链接
提供抖音链接
提供小红书链接
提供任何视频平台的 URL

配置要求

首次使用

需要在 ~/.openclaw/config.json 中配置 API Key：

{
    "download_tool_api_key": "您的 API Key"
}

获取 API Key

访问https://www.datamass.cn
注册用户，登录，创建 API Key
复制生成的 API Key 到配置文件中

功能特点

支持 YouTube、TikTok、抖音、小红书等多个平台
异步下载，无需等待
自动状态轮询
下载进度实时追踪
返回24小时可用的下载链接
不想配置 API Key 的用户，微信搜索"油管下载去水印工具"小程序使用

🔒 安全声明

外部服务说明

本技能依赖外部 API 服务（https://www.datamass.cn/ai-back）实现视频下载功能，原因如下：

视频平台有反爬虫机制，需要专业服务器处理
支持 YouTube、TikTok、抖音、小红书等多平台需要持续维护
托管服务提供稳定的服务器带宽和存储

数据处理

配置文件: 仅读取 ~/.openclaw/config.json 中的 download_tool_api_key 字段
API Key: 仅用于服务认证，不会被存储或传输到其他地方
视频内容: 下载的视频文件存储在阿里云 OSS，24小时后自动过期

用户自主权

✅ 用户自行选择是否注册和使用服务
✅ 费用透明，使用前可查看余额
✅ 可自行部署后端服务（项目开源）
✅ 可修改 download_tool_base_url 指向自建服务

代码透明

所有脚本代码完全开源
无隐藏网络请求
无数据收集行为
无恶意代码

⚠️ 重要说明

费用说明

下载服务按文件大小计费
最低余额门槛: 5 积分
≤ 50MB: 2 积分
50MB ~ 100MB: 2 积分 + 超出部分每 10MB 加 1 积分
> 100MB: 7 积分 + 超出部分每 100MB 加 1 积分
需要充值积分后使用，1元对应10个积分.

故障排查

问题1: 配置文件未找到

错误: ❌ 缺少 API Key

解决: 确保 ~/.openclaw/config.json 文件存在且配置正确

问题2: API Key 无效

错误: 无效的 API Key

解决: 检查 API Key 是否正确，是否已启用

问题3: 余额不足

错误: 余额不足，请充值

解决: 访问服务官网充值积分

问题4: 网络连接失败

错误: Connection refused

解决:

检查网络连接
如果使用代理，配置代理设置
或改用本地部署的服务

反馈与支持

问题反馈: 请在 ClawHub 技能页面留言
功能建议: 欢迎提出改进建议
使用交流: 欢迎分享使用心得

脚本说明

| 脚本 | 用途 | 使用场景 | |------|------|----------| | scripts/download_video_simple.py | 主脚本 | 用户对话时自动执行，框架替换 {{VIDEO_URL}} | | scripts/download_video.py | 命令行工具 | 高级用户手动调用、调试测试 |

命令行使用（可选）

高级用户也可以直接运行脚本：

python scripts/download_video.py "https://www.youtube.com/watch?v=xxxxx"

支持参数：

--timeout=秒数 设置超时时间（默认 1800 秒 / 30分钟）
--poll=秒数 设置轮询间隔（默认 5 秒）

python scripts/download_video.py "https://www.youtube.com/watch?v=xxxxx" --timeout=600 --poll=10