X空间录音转录

技能简介

spaces-listener 用于录制、转录和总结 X/Twitter Spaces 的实时或回放内容。通过 yt-dlp 自动下载音频，使用 Whisper 进行语音转文字，并生成 AI 摘要。

能做什么

• 后台录制单个或多个 Spaces 会话
• 将音频文件转录为文本
• 自动生成内容摘要
• 管理活跃录制任务（查看状态、停止录制）

使用说明

安装依赖

brew install yt-dlp ffmpeg openai-whisper

如需摘要功能，需设置环境变量 OPENAI_API_KEY；纯转录无需此配置。

基础命令

# 开始录制（后台运行）
spaces listen <url>

# 同时录制多个 Spaces
spaces listen "https://x.com/i/spaces/1ABC..."
spaces listen "https://x.com/i/spaces/2DEF..."

# 查看所有活跃录制
spaces list

# 查看指定录制状态
spaces status 1

# 停止录制
spaces stop 1
spaces stop all

# 清理残留文件
spaces clean

# 转录音频
spaces transcribe ~/Desktop/space.m4a --model medium

# 总结已有转录文本
spaces summarize ~/Desktop/space_transcript.txt

# 跳过摘要生成
spaces transcribe ~/Desktop/space.m4a --no-summarize

工作流程

1. 执行 spaces listen <url> 启动后台录制，立即返回
2. 通过定时任务（建议5-10分钟间隔）检查 spaces list
3. 当显示”No active recordings”时，录制完成
4. 执行转录和摘要，通知用户结果
5. 移除定时任务

重要限制：切勿为下载设置超时，Spaces 可能持续数小时，yt-dlp 会在会话结束时自动停止。

输入与输出

见下方输入与输出表格。

风险提示

• 长时间录制占用系统资源，需保持终端或后台进程存活
• Whisper 模型越大准确率越高但速度越慢，根据需求选择
• 未设置 OPENAI_API_KEY 时无法生成摘要，仅输出转录文本
• 同一 Space 禁止并发下载，避免数据冲突
• 临时文件存储于 /tmp/spaces-listener-staging/，异常中断可能导致残留

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/jamesalmeida/spaces-listener/SKILL.md
来源类型：GitHub 仓库