视频下载工具#

使用方式#

示例命令#

text

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

text

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

text

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

触发方式#

当用户请求：

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

---

配置要求#

首次使用#

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

json

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

获取 API Key#

1. 访问 https://www.datamass.cn
2. 注册用户，登录，创建 API Key
3. 复制生成的 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命令行工具高级用户手动调用、调试测试

命令行使用（可选）#

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

bash

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

支持参数：

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

bash

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