SKILL.md for wechat-channel-live-replay

Description

这是一个专业的微信视频号直播回放下载工具。它通过调用 TikHub API 搜索视频号用户，获取其直播历史记录，并按指定日期筛选和下载回放视频。

该技能支持自动将下载的直播视频转写为文字稿，并保存到 live-replay-analyzer 技能的输入目录中，作为直播复盘的前置数据准备工具。

⚠️ Prerequisites (前置条件)

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

1. 配置 TikHub Token: 请在 ~/.openclaw/config.json 中添加 tikhub_api_token。

   {
     "tikhub_api_token": "YOUR_TIKHUB_API_TOKEN"
   }
   

2. 安装 ffmpeg: 本技能需要使用 ffmpeg 从视频中提取音频。

   • 请从 ffmpeg 官网 下载。
   • 安装后，必须将 ffmpeg 的可执行文件路径添加到系统的 PATH 环境变量中。

How to Use

Parameters

• --keywords (必填): 视频号名称（搜索关键词）。
• --date (可选): 指定日期，格式 YYYY-MM-DD。不指定则下载最新一次直播回放。
• --output-dir (可选): 输出目录，默认为 workspace/data。
• --no-transcribe (可选): 跳过语音转文字步骤，只下载视频。

Example Invocation

下载最新回放并转写:

# AI 应动态查找 python 路径
python path/to/export.py --keywords "视频号名称"

下载指定日期的回放:

# AI 应动态查找 python 路径
python path/to/export.py --keywords "视频号名称" --date "2026-03-19"

只下载视频，不转写:

# AI 应动态查找 python 路径
python path/to/export.py --keywords "视频号名称" --no-transcribe

Output

• 视频文件: {昵称}_{日期}_{时间戳}.mp4，保存在输出目录中。
• 文字稿: script.txt，保存在 skills/live-replay-analyzer/input/{视频号名称}/{日期}/ 目录中。
• 汇总报告: wechat_replay_{关键词}_{时间戳}.json，包含任务执行的所有详细信息。

Integration

本技能与 live-replay-analyzer 技能紧密集成：

1. 本技能下载的直播视频会被转写为 script.txt。
2. script.txt 会自动保存到 live-replay-analyzer 的输入目录中。
3. 用户可以直接调用 live-replay-analyzer 技能，使用本技能生成的文字稿来生成复盘报告。