Douyin Video Transcriber

该技能通过命令行脚本接收一个或多个抖音分享链接，经 TikHub 接口下载视频，使用 ffmpeg 提取音频，再由本地 OpenAI Whisper 模型转写为文本，最终生成 Markdown 报告文件；使用前需自行安装 ffmpeg 并配置 TikHub Token。

热度 55.02

最近更新 2026-05-11 17:36:26

分类：效率依赖：代码执行 / 读写文件 / 第三方 API应用场景：社交媒体 / 文件转换 / 数据处理 / 自动化脚本

安装技能

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

执行命令安装此 skill： npx secure-skills-cli add douyin-video-transcriber

Metadata

name: video-transcriber
description: (已验证) 强大的抖音视频批量转写器，集成了下载、音频提取和本地 Whisper 模型转写功能。
metadata: {"version":"1.0.0","source":"https://github.com/your-repo/video-transcriber","author":"an","tags":["douyin","video","transcription","whisper","ffmpeg","social-media"],"license":"MIT","requirements":["python","pip:requests","pip:openai-whisper","exec:ffmpeg"]}

这是一个功能强大且经过实战检验的抖音视频批量转写技能。它将视频下载、音频提取和本地 AI 模型 (OpenAI Whisper) 转写三个核心步骤整合进一个自动化的工作流中，能够高效地将一个或多个抖音视频的语音内容，提取为纯文本。

该技能已被完全重构，实现了良好的可移植性和安全性，是进行视频内容分析、文案提取等任务的基础工具。

在使用本技能前，您必须在您的系统上完成以下配置：

安装 ffmpeg: 本技能需要使用 ffmpeg 工具来从视频中提取音频。
- 请从 ffmpeg 官网下载适合您操作系统的版本。
- 安装后，必须将 ffmpeg 的可执行文件路径添加到您系统的 PATH 环境变量中，以确保本技能可以从任何位置调用它。
配置 TikHub Token: 视频下载功能需要一个有效的 TikHub API Token。请在您的 ~/.openclaw/config.json 文件中添加 tikhub_api_token。
```
{
  "tikhub_api_token": "YOUR_TIKHUB_API_TOKEN"
}
```

该技能的核心脚本 (scripts/run.py) 是一个功能完善的命令行工具。

--url (必填, 可重复): 要转写的抖音视频的分享链接。您可以多次使用此参数以进行批量处理。
--output-file: 指定输出报告的 Markdown 文件路径。如果省略，将自动在 workspace/data/video-transcriber/ 目录下生成一个带时间戳的报告文件。

转写单个视频:

# AI应动态查找 python 路径
python path/to/run.py --url "https://v.douyin.com/iY8K3Nqk/" --output-file "report.md"

批量转写多个视频:

# AI应动态查找 python 路径
python path/to/run.py --url "URL_1" --url "URL_2" --url "URL_3"

在批量处理时，建议省略 --output-file 参数，让技能自动生成报告文件。