名称： voice-ai-tts
描述： >
基于 Voice.ai API 的高质量语音合成，提供 9 种音色、11 种语言支持，并具备流式输出功能。
版本： 1.1.4
标签： [tts, voice, speech, voice-ai, audio, streaming, multilingual]
元数据：
openclaw:
requires:
bins: ["node"]
env:
VOICE_AI_API_KEY: "required"
primary_env: "VOICE_AI_API_KEY"
note: "请通过环境变量设置 VOICE_AI_API_KEY。"

Voice.ai 语音合成

✨ 功能特性

• 9 种音色角色 - 精心挑选，适用于不同场景
• 11 种语言 - 支持多语言合成的多语言模型
• 流式模式 - 实时生成并输出音频
• 音色设计 - 可通过 temperature 和 top_p 参数自定义
• OpenClaw 集成 - 可与 OpenClaw 内置的 TTS 功能协同工作

⚙️ 配置

将您的 API 密钥设置为环境变量：

export VOICE_AI_API_KEY="您的-api-key"

获取 API 密钥： Voice.ai 控制面板

📦 安装

无需安装步骤。此技能包已捆绑 Node.js CLI 和 SDK（无外部 npm 依赖）。

🧩 关键文件

• scripts/tts.js - CLI 入口点
• voice-ai-tts-sdk.js - CLI 使用的 Node.js SDK
• voices.json - CLI 使用的音色定义文件
• voice-ai-tts.yaml - API 规范
• package.json - 供工具使用的技能包元数据

安全说明

完整的安全与隐私概述请参阅 SECURITY.md。

此技能包：
- 仅向 https://dev.voice.ai 发起出站 HTTPS 请求
- 读取本地文件：voices.json
- 将音频输出写入 --output 指定的路径（默认为 output.mp3）
- 不执行 shell 命令，也不修改系统配置文件

🌐 API 端点

SDK 和规范使用 https://dev.voice.ai，这是 Voice.ai 官方的生产 API 域名。

🤖 OpenClaw 集成

如果您的环境已设置 VOICE_AI_API_KEY，OpenClaw 可以直接调用 CLI 脚本。请根据您的 OpenClaw 安装配置使用 /tts 命令。

📝 触发器

以下聊天命令可与 OpenClaw 配合使用：

示例：

/tts 你好，欢迎使用 Voice.ai！
/tts --voice oliver 大家早上好。
/tts --voice lilith --stream 这是一个很长的故事，将在生成时流式播放...

🎙️ 可用音色

🌍 支持的语言

对于非英语语言，请使用多语言模型：

const audio = await client.generateSpeech({
  text: 'Bonjour le monde!',
  voice_id: 'ellie-voice-id',
  model: 'voiceai-tts-multilingual-v1-latest',
  language: 'fr'
});

🎨 音色设计

使用以下参数自定义语音输出：

示例：

const audio = await client.generateSpeech({
  text: '这听起来会非常有表现力！',
  voice_id: 'ellie-voice-id',
  temperature: 1.8,
  top_p: 0.9
});

📡 流式模式

以实时流式方式生成音频（推荐用于长文本）：

# 在生成时流式输出音频
node scripts/tts.js --text "这是一个很长的故事..." --voice ellie --stream

# 流式输出到自定义文件
node scripts/tts.js --text "第一章..." --voice oliver --stream --output chapter1.mp3

SDK 流式处理：

const stream = await client.streamSpeech({
  text: '这里是长文本...',
  voice_id: 'ellie-voice-id'
});

// 管道传输到文件
stream.pipe(fs.createWriteStream('output.mp3'));

// 或处理数据块
stream.on('data', chunk => {
  // 处理音频数据块
});

🔊 音频格式

所有格式选项请参见 voice-ai-tts-sdk.js。

💻 CLI 使用

# 设置 API 密钥
export VOICE_AI_API_KEY="您的密钥"

# 生成语音
node scripts/tts.js --text "你好，世界！" --voice ellie

# 选择不同音色
node scripts/tts.js --text "早上好！" --voice oliver --output morning.mp3

# 对长文本使用流式模式
node scripts/tts.js --text "从前..." --voice lilith --stream

# 显示帮助
node scripts/tts.js --help

📁 文件结构

voice-ai-tts/
├── SKILL.md              # 本文档
├── README.md             # 快速开始
├── CHANGELOG.md          # 版本历史
├── LICENSE.md            # MIT 许可证
├── SECURITY.md           # 安全与隐私说明
├── voices.json           # 音色定义
├── voice-ai-tts.yaml     # OpenAPI 规范
├── voice-ai-tts-sdk.js   # JavaScript/Node.js SDK
├── package.json          # OpenClaw 元数据
├── scripts/
│   └── tts.js            # CLI 工具

💰 成本与用量

Voice.ai 采用基于积分的计费系统。检查您的用量：

// SDK 通过 API 响应跟踪用量
const voices = await client.listVoices();
// 检查响应头中的速率限制信息

降低成本小贴士：
- 对长文本使用流式模式（效率更高）
- 尽可能缓存生成的音频
- 根据您的使用场景选择合适的音频质量

🔗 相关链接

• 获取 API 密钥 - 注册并获取密钥
• API 文档 - 完整 API 参考
• 音色库 - 浏览所有音色
• API 参考 - 端点详情
• 定价 - 方案与积分

📋 更新日志

v1.1.4 (2026-02-16)

• 在元数据中将 VOICE_AI_API_KEY 声明为主要环境变量

v1.1.3 (2026-02-16)

• 从发布的技能包中移除音色样本上传功能，以降低隐私风险
• 仅允许通过环境变量设置 VOICE_AI_API_KEY

v1.1.2 (2026-02-16)

• 添加 SECURITY.md 和 LICENSE.md 以增强来源透明性
• 限制 SDK 传输协议仅为 HTTPS

v1.1.1 (2026-02-16)

• 为 ClawHub 导入优化了打包元数据（bin/files 元数据）

v1.1.0 (2026-02-16)

• 在元数据中声明了必需的凭证
• 记录了生产 API 端点域名
• 为符合知识产权安全规范重命名了音色角色
• 添加了 voices.json 用于存储音色数据

v1.0.0 (2025-01-31)

• 初始版本
• 9 种精选音色角色
• 11 种语言支持
• 流式模式
• 音色设计参数
• 包含错误处理的完整 SDK
• CLI 工具

🛠️ SDK 快速参考

const VoiceAI = require('./voice-ai-tts-sdk');
const client = new VoiceAI(process.env.VOICE_AI_API_KEY);

// 列出音色
const voices = await client.listVoices({ limit: 10 });

// 获取音色详情
const voice = await client.getVoice('voice-id');

// 生成语音
const audio = await client.generateSpeech({
  text: '你好，世界！',
  voice_id: 'voice-id',
  audio_format: 'mp3'
});

// 生成语音到文件
await client.generateSpeechToFile(
  { text: '你好！', voice_id: 'voice-id' },
  'output.mp3'
);

// 流式生成语音
const stream = await client.streamSpeech({
  text: '长文本...',
  voice_id: 'voice-id'
});

// 删除音色
await client.deleteVoice('voice-id');

❓ 故障排除

由 Nick Gill 倾情制作 ❤️