/install douyin-orchestrator
Douyin Transcribe - 工作流编排
** 完整的抖音视频转录工作流,按顺序调用三个独立模块:
- douyin-fetcher - 获取视频
- douyin-transcriber - 转录音频
- douyin-analyzer - 分析内容
架构
用户发送抖音链接
↓
[Step 0] 判断输入类型
↓
[Step 1] fetcher: 解析链接 → 下载视频
↓
[Step 2] transcriber: 提取音频 → 转录文字
↓
[Step 3] analyzer: 清理文本 → 分析要点
↓
[Step 4] 保存成果 → 更新索引
完整工作流
Step 0: 判断输入类型
| 输入类型 | 处理方式 |
|---|---|
视频链接(/video/) |
完整工作流 |
图文链接(/note/) |
浏览器 snapshot 提取文字 |
| 本地视频文件 | 从 Step 2 开始 |
| 文本内容 | 从 Step 3 开始 |
Step 1: 下载视频
调用模块:douyin-fetcher
详见 ~/.openclaw/skills/douyin-fetcher/SKILL.md
⚠️ 注意:Step 1 的 browser act 调用必须用 request={"kind": "evaluate", "fn": "..."} 嵌套格式。
输出:视频流 + 音频流(DASH)或完整视频文件
Step 2: 转录音频
调用模块:douyin-transcriber
详见 ~/.openclaw/skills/douyin-transcriber/SKILL.md
⚠️ 注意:如果 Step 1 下载了 DASH 分离流,直接用 audio.mp4 转 WAV 转录,不需要先合并
输出:转录文本
Step 3: 分析内容
调用模块:douyin-analyzer
详见 ~/.openclaw/skills/douyin-analyzer/SKILL.md
做法:转录后由 agent 直接分析(语义分段、修正错误、提取要点)
Step 4: 保存成果
转录稿(/path/to/knowledge ranscripts\)
| 文件 | 说明 |
|---|---|
{主题}-完整转录.md |
包含标题、作者、链接、转录时间、完整内容 |
视频文件(/path/to/videos\)
| 文件 | 说明 |
|---|---|
{主题}.mp4 |
原始视频(可选保存) |
更新索引
保存文件后,更新:
/path/to/knowledge ranscripts\data_structure.md/path/to/knowledge\data_structure.md(主索引)/path/to/videos\data_structure.md(如保存视频)
部分工作流
| 用户请求 | 执行步骤 |
|---|---|
| "帮我转录这个抖音视频" | Step 1 → 2 → 3 → 4 |
| "只下载这个视频,不转录" | Step 1 → 保存到 /path/to/videos\ |
| "我已经有视频文件了,帮我转录" | Step 2 → 3 → 4 |
| "帮我分析这段文本" | Step 3 → 4 |
异常处理汇总
| 阶段 | 问题 | 处理 |
|---|---|---|
| Step 1 | 短链解析失败 | 检查链接完整性,去掉分享文案干扰字符 |
| Step 1 | JS 返回空数组 | 等待 15-20 秒后重试,或扩大搜索范围 |
| Step 1 | 下载 403 | URL 过期,重新获取 |
| Step 1 | 浏览器不可用 | 提示用户手动下载 |
| Step 2 | ffmpeg 未安装 | winget install Gyan.FFmpeg |
| Step 2 | Whisper 服务未运行 | docker start whisper-asr |
| Step 2 | 转录超时 | 长视频需要更多时间,10分钟视频约需 15-20 分钟 |
| Step 2 | 转录乱码 | 语言识别问题,可后续手动修正 |
| Step 4 | 索引更新失败 | 手动更新 data_structure.md |
图文笔记处理
图文链接(/note/)无需下载,直接提取:
1. browser(action='open', profile='openclaw', url='图文链接')
2. browser(action='snapshot')
3. 从 snapshot 提取文字内容
4. 保存到 /path/to/knowledge ranscripts\
前置条件
| 工具 | 用途 | 检查命令 |
|---|---|---|
| curl | 下载文件 | curl --version |
| ffmpeg | 视频合并/格式转换 | ffmpeg -version |
| Docker Whisper | 转录服务(内含 ffmpeg 7.1) | docker ps --filter "name=whisper-asr" |
| 浏览器 | 抓取视频 | openclaw profile 可用 |
说明:宿主机 ffmpeg 8.1 用于视频合并等任务,Whisper ASR 容器内 ffmpeg 7.1 用于转录处理,两者并存。
已知限制
- 视频 URL 有时效性 — 获取后立即下载
- 长视频转录耗时 — 10分钟视频约需 15-20 分钟
- 需要浏览器 — openclaw profile 必须可用
- 图文笔记 — 部分需要登录才能查看完整内容
- 部分视频无分离流 — 直接是完整 MP4,无需合并
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install douyin-orchestrator - 安装完成后,直接呼叫该 Skill 的名称或使用
/douyin-orchestrator触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Douyin Orchestrator 是什么?
抖音视频转录工作流编排。从抖音链接下载视频、转录语音、分析内容,输出结构化成果。编排调用 douyin-fetcher、douyin-transcriber、douyin-analyzer 三个独立模块。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 133 次。
如何安装 Douyin Orchestrator?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install douyin-orchestrator」即可一键安装,无需额外配置。
Douyin Orchestrator 是免费的吗?
是的,Douyin Orchestrator 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Douyin Orchestrator 支持哪些平台?
Douyin Orchestrator 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Douyin Orchestrator?
由 Don Li(@don068589)开发并维护,当前版本 v1.0.0。