ListenHub

通过封装 ListenHub API 的 Shell 脚本，生成播客、讲解视频、TTS 音频和 AI 图像。

初始化设置

首次使用前，请设置 LISTENHUB_API_KEY。有两种方式：

选项 A — OpenClaw 环境配置（推荐）： 在 ~/.openclaw/openclaw.json 文件的 env 字段下添加：

{ "env": { "LISTENHUB_API_KEY": "lh_sk_..." } }

选项 B — Shell 导出环境变量：

export LISTENHUB_API_KEY="lh_sk_..."

获取您的 API Key：https://listenhub.ai/settings/api-keys

如需生成图像，还需设置 LISTENHUB_OUTPUT_DIR（默认为 ~/Downloads）。

脚本位置

所有脚本均位于相对于本 SKILL.md 文件的 scripts/ 目录下。请用以下命令解析路径：

SCRIPTS="$(cd "$(dirname "")" && pwd)/scripts"

依赖项：curl、jq（如未安装请先安装）。

运行模式

辅助脚本：get-speakers.sh（列出可用音色）、check-status.sh（轮询任务进度）。

硬性约束

• 仅可通过提供的脚本执行操作；禁止直接调用 API。
• 切勿硬编码 speakerId —— 必须调用 get-speakers.sh 动态获取。
• 该 API 为专有接口；所有端点与参数均由脚本内部封装，对外不可见。

模式自动识别

根据用户输入自动判断模式：

• 播客：包含“podcast”、“chat about”、“discuss”、“debate”等关键词 → 调用 create-podcast.sh
• 讲解视频：包含“explain”、“introduce”、“video”、“tutorial”等关键词 → 调用 create-explainer.sh
• TTS：包含“read aloud”、“convert to speech”、“tts”等关键词 → 调用 create-tts.sh
• 图像生成：包含“generate image”、“draw”、“create picture”等关键词 → 调用 generate-image.sh

若语义模糊，请向用户确认。

快速参考

获取可用音色

$SCRIPTS/get-speakers.sh --language zh   # 或 en

返回 JSON 格式结果，其中含 data.items[].speakerId。若用户未指定音色，则按语言选取第一个匹配项。

播客（单阶段，缺省模式）

$SCRIPTS/create-podcast.sh --query "topic" --language zh|en --mode quick|deep|debate --speakers  [--source-url URL] [--source-text TEXT]

• quick 为缺省模式。debate 模式需指定 2 个说话人。
• 支持多个 --source-url / --source-text 参数。

播客（双阶段：文本 → 审阅 → 音频）

仅当用户希望在生成音频前审阅或编辑脚本时使用。

第一阶段：$SCRIPTS/create-podcast-text.sh（参数同单阶段） 审阅环节：用 check-status.sh --wait 轮询状态，保存草稿后暂停并等待用户确认。 第二阶段：$SCRIPTS/create-podcast-audio.sh --episode [--scripts modified.json]

讲解视频

$SCRIPTS/create-explainer.sh --content "text" --language zh|en --mode info|story --speakers 
$SCRIPTS/generate-video.sh --episode 

TTS（FlowSpeech）

$SCRIPTS/create-tts.sh --type text|url --content "text or URL" --language zh|en --mode smart|direct --speakers 

• 缺省模式为 direct（不修改原始内容）；smart 模式会自动修正语法与标点。
• 文本长度上限为 10,000 字符；超长内容请使用 URL 方式传入。

多角色语音

$SCRIPTS/create-speech.sh --scripts scripts.json

JSON 格式示例：{"scripts": [{"content": "...", "speakerId": "..."}]}

图像生成

$SCRIPTS/generate-image.sh --prompt "description" [--size 1K|2K|4K] [--ratio 16:9|1:1|9:16|...] [--reference-images "url1,url2"]

• 缺省尺寸为 2K，宽高比为 16:9；最多支持 14 张参考图。
• 输出文件保存至 $LISTENHUB_OUTPUT_DIR（默认为 ~/Downloads）。

查询任务状态

$SCRIPTS/check-status.sh --episode  --type podcast|flow-speech|explainer [--wait] [--timeout 300]

退出码含义：0 = 已完成，1 = 失败，2 = 超时（可安全重试）。

使用 --wait 启用自动轮询；对耗时较长的任务，请后台运行生成命令。

交互流程

1. 从用户输入中识别运行模式
2. 若未指定音色，则调用 get-speakers.sh 并选取首个匹配项
3. 执行对应脚本（耗时任务请后台运行）
4. 反馈提交成功，并预估处理时间（播客约 2–3 分钟，讲解视频约 3–5 分钟，TTS 约 1–2 分钟）
5. 用户询问“完成了吗？”时 → 执行 check-status.sh --wait
6. 展示结果链接；仅在用户明确要求时提供下载选项

语言适配

响应语言须与用户输入语言一致：中文输入 → 中文回复；英文输入 → 英文回复。

相关链接

• 播客库：https://listenhub.ai/app/podcast
• 讲解视频库：https://listenhub.ai/app/explainer
• TTS 库：https://listenhub.ai/app/text-to-speech
• API 密钥管理页：https://listenhub.ai/settings/api-keys