Agentvibes Voice Skill Free

AgentVibes TTS 语音合成基础客户端（免费版）。集成 Piper TTS 单一 Provider, 支持声音切换、列出、预览、采样、语速控制等基础能力。免费离线、无需账号（Piper 声音文件需下载）。适用于 AI Agent 基础语音播报、简单内容配音场景。

天轰穿@thcjp

Install

openclaw skills install @thcjp/agentvibes-voice-skill-free

AgentVibes TTS LITE

AgentVibes 基础版,基于 Piper TTS 提供文本转语音能力。免费、离线、无需账号（Piper 声音文件需从 HuggingFace 下载）。

范围外（本技能不做）: macOS Say / Windows SAPI / Soprano 多 Provider 切换、个性风格、语音效果、背景音乐、语言学习模式、翻译播放（需升级付费版）。

依赖说明

运行环境

Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
操作系统: Windows / macOS / Linux

依赖项

依赖项	类型	是否必需	获取方式
LLM API	API	必需	由Agent内置LLM提供

API Key 配置

需要配置对应API Key，详见上文环境配置章节

可用性分类

分类: MD+EXEC（）

API Key配置方式:

bash

export API_KEY="your_api_key_here"

配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统。

核心能力

Provider

免费版仅支持 Piper TTS:

Provider	平台	成本	声音数量
Piper TTS	全平台	免费、离线	914+,30+ 语言

升级提示: macOS Say / Windows SAPI / Soprano 等多 Provider 切换仅在 agentvibes-voi

处理: 按照skill规范执行Provider操作。输出: 返回Provider的执行结果,包含操作状态和输出数据。

输入: 用户提供Provider所需的指令和必要参数。

声音命令

输入: 用户提供声音命令所需的指令和必要参数。处理: 按照skill规范执行声音命令操作,遵循单一意图原则。输出: 返回声音命令的执行结果,包含操作状态和输出数据。

执行声音命令操作，处理输入数据并返回结果
验证执行结果，确认输出符合预期格式
参考声音命令相关配置参数进行设置

切换声音

bash

/agent-vibes:switch en_US-amy-medium
/agent-vibes:switch en_GB-alan-medium
/agent-vibes:switch fr_FR-siwis-medium

输入: 用户提供切换声音所需的指令和必要参数。处理: 按照skill规范执行切换声音操作,遵循单一意图原则。输出: 返回切换声音的执行结果,包含操作状态和输出数据。

列出声音

bash

/agent-vibes:list                    # 列出全部声音
/

**输入**: 用户提供声音命令所需的参数和指令。
**处理**: 按照skill规范执行声音命令操作。
**输出**: 返回声音命令的执行结果,包含操作状态和输出数据。

### 语速控制（0.5x - 3.0x）

```bash
/agent-vibes:set-speed 1.0             # 正常
/agent-vibes:set-speed 1.5             # 加速 50%
/agent-vibes:set-speed 0.8             # 减速

输入: 用户提供语速控制（0.5x - 3.0x）所需的参数和指令。处理: 按照skill规范执行语速控制（0.5x - 3.0x）操作。输出: 返回语速控制（0.5x - 3.0x）的执行结果,包含操作状态和输出数据。

默认声音（Piper TTS - 免费离线）

语言	推荐声音
English (US)	en_US-lessac-medium · en_US-amy-medium · en_US-ryan-high
English (UK)	en_GB-alan-medium
French	fr_FR-siwis-medium
German	de_DE-thorsten-m

输入: 用户提供默认声音（Piper TTS - 免费离线）所需的参数和指令。处理: 按照skill规范执行默认声音（Piper TTS - 免费离线）操作。输出: 返回默认声音（Piper TTS - 免费离线）的执行结果,包含操作状态和输出数据。

能力覆盖范围

本skill还覆盖以下能力场景: 语音合成、支持声音切换、语音合成基础客户、语速控制等基础能、无需账号、声音文件需下载、适用于、基础语音播报、简单内容配音场景。这些能力在上述核心功能中均有对应处理逻辑。

Provider

免费版仅支持 Piper TTS:

Provider	平台	成本	声音数量
Piper TTS	全平台	免费、离线	914+,30+ 语言

升级提示: macOS Say / Windows SAPI / Soprano 等多 Provider 切换仅在 agentvibes-voice-skill 付费版中提供。

声音命令

切换声音

bash

/agent-vibes:switch en_US-amy-medium
/agent-vibes:switch en_GB-alan-medium
/agent-vibes:switch fr_FR-siwis-medium

列出声音

bash

/agent-vibes:list                    # 列出全部声音
/agent-vibes:list first 5            # 前 5 个
/agent-vibes:list last 3             # 后 3 个

预览声音

bash

/agent-vibes:preview                 # 预览前 3 个
/agent-vibes:preview 5               # 预览前 5 个

单声音采样

bash

/agent-vibes:sample en_US-ryan-high

当前声音

bash

/agent-vibes:get                     # 显示当前声音

语速控制（0.5x - 3.0x）

bash

/agent-vibes:set-speed 1.0             # 正常
/agent-vibes:set-speed 1.5             # 加速 50%
/agent-vibes:set-speed 0.8             # 减速

默认声音（Piper TTS - 免费离线）

语言	推荐声音
English (US)	en_US-lessac-medium · en_US-amy-medium · en_US-ryan-high
English (UK)	en_GB-alan-medium
French	fr_FR-siwis-medium
German	de_DE-thorsten-medium
Spanish	es_ES-davefx-medium
Japanese	ja_JP-ayanami-medium
Chinese	zh_CN-huayan-x_low
Korean	ko_KR-kss-medium

另有 900+ 声音覆盖 30+ 语言,均从 HuggingFace 下载,无需账号。

适用场景

场景	典型输入	输出内容
声音切换与预览	"切换到英语女声并预览"	切换声音 + 播放采样
语速调整	"把语速调到 1.5 倍"	应用新语速
多语言声音选择	"切换到日语声音"	切换到对应语言声音

不适用于: 个性风格、语音效果、背景音乐、语言学习模式、多 Provider 切换（需升级付费版）

使用流程

Step 1: 检查 Piper 可用性

bash

/agent-vibes:provider list

Step 2: 首次使用拉取声音

首次切换某声音时自动从 HuggingFace 下载,无需账号。

Step 3: 选择并预览声音

bash

/agent-vibes:list first 10
/agent-vibes:preview 5
/agent-vibes:sample en_US-amy-medium

Step 4: 切换并调整语速

bash

/agent-vibes:switch en_US-amy-medium
/agent-vibes:set-speed 1.0

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,参考错误处理章节获取恢复步骤。

命令参数说明

-ayanami-medium: 命令参数,用于指定操作选项
-thorsten-medium: 命令参数,用于指定操作选项
-huayan-x_low: 命令参数,用于指定操作选项
-kss-medium: 命令参数,用于指定操作选项
-thorsten-m: 命令参数,用于指定操作选项

命令参数说明

-thorsten-medium: 命令参数,用于指定操作选项
-ayanami-medium: 命令参数,用于指定操作选项
-thorsten-m: 命令参数,用于指定操作选项
-davefx-medium: 命令参数,用于指定操作选项
-huayan-x_low: 命令参数,用于指定操作选项

命令参数说明

-lessac-medium: 命令参数,用于指定操作选项
-kss-medium: 命令参数,用于指定操作选项
-thorsten-m: 命令参数,用于指定操作选项
-huayan-x_low: 命令参数,用于指定操作选项
-thorsten-medium: 命令参数,用于指定操作选项

命令参数说明

-kss-medium: 命令参数,用于指定操作选项
-lessac-medium: 命令参数,用于指定操作选项
-thorsten-m: 命令参数,用于指定操作选项
-davefx-medium: 命令参数,用于指定操作选项
-ayanami-medium: 命令参数,用于指定操作选项

命令参数说明

-davefx-medium: 命令参数,用于指定操作选项
-lessac-medium: 命令参数,用于指定操作选项
-kss-medium: 命令参数,用于指定操作选项
-thorsten-medium: 命令参数,用于指定操作选项
-ayanami-medium: 命令参数,用于指定操作选项

命令参数说明

-thorsten-m: 命令参数,用于指定操作选项
-lessac-medium: 命令参数,用于指定操作选项
-thorsten-medium: 命令参数,用于指定操作选项
-davefx-medium: 命令参数,用于指定操作选项
-huayan-x_low: 命令参数,用于指定操作选项

命令参数说明

-kss-medium: 命令参数,用于指定操作选项
-lessac-medium: 命令参数,用于指定操作选项
-ayanami-medium: 命令参数,用于指定操作选项
-davefx-medium: 命令参数,用于指定操作选项
-huayan-x_low: 命令参数,用于指定操作选项

命令参数说明

-thorsten-m: 命令参数,用于指定操作选项
-davefx-medium: 命令参数,用于指定操作选项
-huayan-x_low: 命令参数,用于指定操作选项
-lessac-medium: 命令参数,用于指定操作选项
-thorsten-medium: 命令参数,用于指定操作选项

案例展示

案例1: 切换英语女声

场景: 用户需要将 AI Agent 的播报声音切换为英语女声

bash

# 列出前 10 个声音
/agent-vibes:list first 10

# 预览前 5 个
/agent-vibes:preview 5

# 采样特定声音
/agent-vibes:sample en_US-amy-medium

# 切换到该声音
/agent-vibes:switch en_US-amy-medium

输出: 切换后的声音采样

说明: 建议先 preview 或 sample 验证声音效果再正式切换。

案例2: 调整语速

场景: 用户希望加快播报语速到 1.5 倍

bash

# 查看当前配置
/agent-vibes:get

# 设置为 1.5 倍速
/agent-vibes:set-speed 1.5

输出: 应用新语速后的播报

说明: 语速范围 0.5x-3.0x,超出范围会被拒绝。

错误处理

错误场景	错误信息	原因分析	处理方式
piper_voice_not_downloaded	`voice file not found: en_US-amy-medium`	Piper 声音文件未下载	自动触发下载,或引导用户手动从 HuggingFace 拉取
invalid_speed	`speed must be between 0.5 and 3.0`	set-speed 参数超出范围	不执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,提示用户使用 0.5-3.0 之间的值
voice_not_found	`voice 'xyz' not found`	声音名称不存在	不执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,引导用户 `list` 查看可用声音
provider_unavailable	`piper not installed`	Piper TTS 引擎未安装	自动触发安装,或引导用户手动安装
network_error	`failed to download voice file`	网络不可达或 HuggingFace 访问失败	执行ping命令测试网络连通性,检查防火墙和代理设置后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,或引导用户使用代理

常见问题

Q1: AgentVibes 真的免费且离线吗?

A: Piper TTS 完全免费且离线运行,声音文件从 HuggingFace 下载（无需账号）后本地缓存。仅首次下载声音文件需要网络。

Q2: 如何添加新的 Piper 声音?

A: Piper 声音文件托管在 HuggingFace 的 rhasspy/piper-voices 仓库。首次切换到某声音时会自动下载。如需手动添加,将 .onnx 与 .onnx.json 文件放入 Piper 声音目录即可。

Q3: 免费版和付费版有什么区别?

A: 免费版（LITE）仅支持 Piper TTS 单 Provider,提供声音切换、列出、预览、采样、语速控制基础能力。付费版（agentvibes-voice-skill）额外提供:

macOS Say / Windows SAPI / Soprano 多 Provider 切换
个性风格（sarcastic/dramatic 等）
语音效果（reverb/echo/pitch/eq）
背景音乐
语言学习双语播报与翻译播放
Verbosity 控制与 Mute/Replay
3 个完整案例（vs 免费版 2 个基础案例）
8 种错误处理（vs 免费版 5 种）

Q4: 支持哪些语言?

A: Piper TTS 支持 30+ 语言、914+ 声音,包括英语、法语、德语、西班牙语、日语、中文、韩语等主流语言。通过 list 命令查看全部可用声音。

已知限制

单 Provider: 仅支持 Piper TTS,不支持 macOS Say / Windows SAPI / Soprano（需升级付费版）
基础能力: 不支持个性风格、语音效果、背景音乐、语言学习模式（需升级付费版）
Piper 需下载声音文件: 首次使用某声音需从 HuggingFace 下载
语速范围 0.5-3.0: 超出范围会被拒绝
无 Replay: 不支持回放历史音频（需升级付费版）

想要多 Provider 切换、个性风格、背景音乐、语言学习模式? 升级到 agentvibes-voice-skill 付费版解锁全部高级能力。