VoxFlow
← Documentation home

OpenClaw × VoxFlow

VoxFlow 在两个 OpenClaw 官方 skill 注册表都已上架,slug 都是 voxflow:海外 / 全球用户走 ClawHub,中国 / 腾讯内部 OpenClaw(如 chico-claw-win)走 SkillHub.cn。两边都已通过 moderation 安全扫描。

两条路并行,按你的 OpenClaw 部署位置挑:
SkillHub.cn(腾讯运营,京 ICP 11018762,skillhub.cn/skills/voxflow)— 中国境内 / 腾讯内部 OpenClaw bot 默认连接的注册表,每版经过科恩 + 云鼎双重安全扫描,是 knot_skills 工具实际查询的地址。
ClawHub(openclaw 开源项目,clawhub.ai/skill/voxflow)— 海外 / 全球 / 个人自建 OpenClaw 用这条,clawhub install voxflow
两边内容一致(同 SKILL.md bundle,含 hub / podcast / transcribe / slice / video 5 个子能力)。原 @voxflow/openclaw-tts npm 插件已不再维护,残留步骤折叠在本页底部

方式 A:在 OpenClaw 里直接对 bot 说(推荐)

在任意 OpenClaw 会话里说人话,bot 会用内置工具(knot_skills 走 SkillHub.cn / clawhub 走公开 ClawHub)去对应注册表拉。同一段 prompt 在两边都能跑:

💬 复制给 OpenClaw bot
请从 OpenClaw 官方注册表帮我装 voxflow skill:

  slug: voxflow
  - 中国 / 腾讯内部 OpenClaw → 用 knot_skills 工具,SkillHub.cn 上有
  - 海外 / 全球 / 个人 OpenClaw → 用 clawhub 工具,clawhub.ai 上有

装完后:
1. 跑 `voxflow login` 拿到配对码,把 Pairing code 和 verify URL
   原样发给我,我在浏览器完成授权(device-flow,零粘贴)。
2. 跑 `voxflow status` 确认我的邮箱和配额。
3. 试一句 `voxflow say "你好 VoxFlow" -o hello.mp3`,告诉我文件大小。

VoxFlow skill 包含 5 个子能力(hub / podcast / transcribe / slice / video),
你按需读对应 .md 文档调对应 CLI 命令即可,不用全部一次性加载。

两边的 skill manifest 都声明了 install: kind=node, package=voxflow@1.11.4(pin 到当前 CLI 版本),由注册表在审核过的 install spec 下自动 npm install -g,无需手动装 CLI。

方式 B:在终端跑 CLI

B1 · 走 SkillHub.cn(中国 / 腾讯内部 OpenClaw)

# 一次性装 SkillHub CLI + 默认 skill(带腾讯 COS 加速)
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

# 进 OpenClaw workspace 装 voxflow
cd ~/.openclaw/workspace
skillhub install voxflow

# 装好 CLI、扫码登录
npm install -g voxflow
voxflow login
voxflow status

SkillHub.cn 主页:skillhub.cn · VoxFlow 详情页(含科恩 + 云鼎安全扫描报告)

B2 · 走公开 ClawHub(海外 / 个人 OpenClaw)

# 一次性装 ClawHub CLI
npm install -g clawhub
clawhub login        # 浏览器 OAuth,loopback 自动写 token

# 进 OpenClaw workspace 装 voxflow
cd ~/.openclaw/workspace
clawhub install voxflow

# 装好 CLI、扫码登录
npm install -g voxflow
voxflow login
voxflow status

官方 ClawHub 文档:docs.openclaw.ai/tools/skills · openclaw/clawhub on GitHub · VoxFlow skill 主页

VoxFlow skill 里的 5 个子能力

主 SKILL.md 是入口 + 路由表,agent 按用户意图读对应子文档:

hub.md · 入口

TTS 朗读、音色检索、AI 故事采样、安装 / 登录 / 配额查询。不确定走哪条时先读 hub。

podcast.md · 多人播客

从主题 / URL / 脚本生成多说话人对话,分声道 TTS 合成,导出 MP3 / WAV。

transcribe.md · 转写 / 翻译 / 配音

ASR(30+ 分钟带词级时间戳走 Azure Batch)、字幕翻译、SRT 配音、端到端视频翻译。

slice.md · 长文转竖版卡片视频

文章 / 笔记 / 报告 → 1080×1920 知识卡视频,6 套主题(纸面 / 杂志 / 大字海报 / Notion / 粗野 / 玻璃夜)。

video.md · 短视频生成

小红书 / TikTok / Reels 风格的知识卡、讲解视频、演示幻灯片、AI 图像。

安装后的效果

装完 voxflow skill 后,在 OpenClaw 任意会话里说人话即可:

“给 OpenClaw bot 加个开场白音频”

bot 读 hub.md → 跑 voxflow say "..." -o welcome.mp3

“把这周的群聊总结做成 10 分钟播客”

bot 读 podcast.md → 跑 voxflow podcast "..." --duration 10

“把这段语音消息转成日语字幕”

bot 读 transcribe.md → 跑 voxflow asr ... && voxflow translate ... --to ja

配额 & 定价

所有调用走 VoxFlow CLI,消耗你账号的月度配额(Free 套餐 10,000 / 月,约 100 次 TTS)。

详细成本表见 CLI 文档,套餐对比见 /app#pricing

Legacy:OpenClaw TTS 插件(暂停维护)

下面是早期的 @voxflow/openclaw-tts 插件安装方式,仅供已部署用户参考。新项目请使用上方 Skills 方案。

展开 Legacy 安装步骤

三步配置(需要 OpenClaw v2026.3.22+):

openclaw update
openclaw plugins install @voxflow/openclaw-tts
openclaw gateway restart

编辑 openclaw.json

{
  "messages": {
    "tts": {
      "auto": "always",
      "provider": "voxflow"
    }
  },
  "plugins": {
    "enabled": true,
    "entries": {
      "openclaw-tts": {
        "config": {
          "voice": "v-female-R2s4N9qJ",
          "speed": 1.0
        }
      }
    }
  }
}

重启后在任意聊天渠道发一条消息,若未登录 Bot 会回复授权链接 https://voxflow.studio/openclaw-auth?code=VF-XXXX,点击完成 Google / 邮箱 OTP 登录即可。

已知限制:仅在 WeChat iLink 和 Telegram 上验证过;某些 OpenClaw 版本设置 plugins.allow 后渠道无法启动;Token 有效期约 1 小时。这些问题在 Skills 方案下不复存在。

Agent Skills →  ·  CLI →  ·  MCP Server →  ·  所有文档 →