Bot Voice Config Clean — 机器人 Voice Config 清理

机器人音色配置技能 (机器人 Voice Config) 描述

为机器人配置和绑定火山引擎 TTS 音色，支持音色查询、绑定、设置默认音色等全流程操作。

触发词 配置音色 设置音色 绑定音色 切换音色 默认音色 @voice-config 功能特性

• 音色查询

列出所有可用音色 按风格筛选（甜美、温柔、御姐等） 按性别筛选（男声、女声）

• 音色绑定

绑定音色 ID 到机器人 验证音色可用性 测试音色效果

• 默认音色设置

设置默认回复音色 保存配置到配置文件 自动应用到语音回复

• 音色测试

生成测试音频 发送到飞书试听 确认后再应用 前置配置 环境变量 # 火山引擎 TTS 配置 导出 VOLC_API_KEY="你的火山引擎 API Key" 导出 VOLC_RESOURCE_ID="volc.服务_type.10029"

# 飞书应用配置 导出 FEISHU_应用_ID="你的飞书 应用 ID" 导出 FEISHU_应用_SECRET="你的飞书 应用 Secret"

# 默认接收者 导出 FEISHU_DEFAULT_USER_ID="你的飞书用户 ID"

配置文件

创建 ~/.OpenClaw/workspace/config/机器人-voice-config.json:

{ "default_speaker": "ICL_zh_female_xiangliangya_v1_tob", "default_speaker_name": "邪魅御姐", "机器人_speakers": { "桃桃": "ICL_zh_female_xiangliangya_v1_tob", "虾仔": "saturn_zh_female_tiaopigongzhu_tob" }, "avAIlable_speakers": [ { "id": "ICL_zh_female_xiangliangya_v1_tob", "name": "邪魅御姐", "style": "成熟魅惑", "gender": "female" }, { "id": "saturn_zh_female_tiaopigongzhu_tob", "name": "调皮公主", "style": "可爱俏皮", "gender": "female" }, { "id": "zh_female_tianmeitaozi_uranus_bigtts", "name": "甜美桃子", "style": "甜美温柔", "gender": "female" }, { "id": "zh_male_beijingxiaoye_emo_v2_mars_bigtts", "name": "北京小爷", "style": "emo 北京腔", "gender": "male" }, { "id": "zh_male_ruyayichen_uranus_bigtts", "name": "儒雅逸辰", "style": "儒雅绅士", "gender": "male" } ], "feishu": { "应用_id": "你的飞书 应用 ID", "应用_secret": "你的飞书 应用 Secret", "default_user_id": "你的飞书用户 ID" }, "volcengine": { "API_key": "你的火山引擎 API Key", "resource_id": "volc.服务_type.10029" } }

使用示例

• 查询可用音色

配置音色 列表

回复：

🎵 可用音色列表

【女声】

• 邪魅御姐 - ICL_zh_female_xiangliangya_v1_tob (成熟魅惑)
• 调皮公主 - saturn_zh_female_tiaopigongzhu_tob (可爱俏皮)
• 甜美桃子 - zh_female_tianmeitaozi_uranus_bigtts (甜美温柔)

【男声】

• 北京小爷 - zh_male_beijingxiaoye_emo_v2_mars_bigtts (emo 北京腔)
• 儒雅逸辰 - zh_male_ruyayichen_uranus_bigtts (儒雅绅士)

当前默认：邪魅御姐

使用 "设置音色 <音色 ID>" 来切换音色

• 设置默认音色

设置音色 ICL_zh_female_xiangliangya_v1_tob

回复：

✅ 音色设置成功！

【配置信息】

• 音色名称：邪魅御姐
• 音色 ID：ICL_zh_female_xiangliangya_v1_tob
• 风格：成熟魅惑
• 性别：女声

【测试】 发送 "测试音色" 来试听效果

配置已保存到配置文件，重启后生效

• 测试音色

测试音色

回复：

🎤 正在生成测试音频...

【音色信息】

• 音色：邪魅御姐
• 文本："你好呀，我是邪魅御姐语音助手。很高兴为你服务，希望你喜欢我的声音！"

✅ 测试音频已发送，请查收！

满意请回复 "确认使用"，不满意可以切换其他音色

• 绑定音色到机器人

绑定音色 ICL_zh_female_xiangliangya_v1_tob 桃桃

回复：

✅ 音色绑定成功！

【绑定信息】

• 机器人：桃桃 🍑 ✨
• 音色：邪魅御姐
• 音色 ID：ICL_zh_female_xiangliangya_v1_tob

【状态】

• ✅ 已设置为默认回复音色
• ✅ 配置已保存

使用 "查看绑定" 查看所有机器人的音色配置

• 查看绑定

查看绑定

回复：

🎵 机器人音色绑定列表

机器人	音色名称	音色 ID	状态
桃桃 🍑	邪魅御姐	ICL_zh_female_xiangliangya_v1_tob	✅ 默认
虾仔 🦐	调皮公主	saturn_zh_female_tiaopigongzhu_tob	✅ 默认

使用 "设置音色 <音色 ID> <机器人名称>" 来修改绑定

命令语法 基础命令 命令 说明 示例 配置音色 列表 查看所有可用音色 配置音色 列表 配置音色 女声 查看女声音色 配置音色 女声 配置音色 男声 查看男声音色 配置音色 男声 设置音色 设置默认音色 设置音色 ICL_zh_female_xiangliangya_v1_tob 测试音色 测试当前音色 测试音色 绑定音色 <机器人> 绑定音色到机器人 绑定音色 xxx 桃桃 查看绑定 查看所有绑定 查看绑定 重置音色 恢复默认配置 重置音色 音色 ID 参考 热门音色 音色名称 音色 ID 风格 邪魅御姐 ICL_zh_female_xiangliangya_v1_tob 成熟魅惑 调皮公主 saturn_zh_female_tiaopigongzhu_tob 可爱俏皮 甜美桃子 zh_female_tianmeitaozi_uranus_bigtts 甜美温柔 北京小爷 zh_male_beijingxiaoye_emo_v2_mars_bigtts emo 北京腔 儒雅逸辰 zh_male_ruyayichen_uranus_bigtts 儒雅绅士 完整列表

技能内置了完整的音色列表文档：docs/yinse-liebiao.md

包含火山引擎全部 280+ 种音色及对应的 Voice Type，可直接复制使用。

错误处理 错误 原因 解决方案 音色 ID 不存在 输入的音色 ID 无效 使用 配置音色 列表 查看有效 ID 音色不可用 该音色需要额外资源包 开通对应资源包或更换音色 TTS 生成失败 火山引擎 API 错误 检查 API Key 和网络连接 飞书发送失败 飞书应用权限不足 检查 应用 配置和好友关系 配置文件错误 JSON 格式错误 检查配置文件格式 配置文件位置 主配置: ~/.OpenClaw/workspace/config/机器人-voice-config.json 技能文档: ~/.OpenClaw/workspace/技能s/机器人-voice-config/技能.md 自动化脚本

完整脚本：scripts/voice-config.sh

#!/bin/bash # 机器人音色配置脚本

# 用法： # ./voice-config.sh 设置 <音色 ID> # 设置音色 # ./voice-config.sh test # 测试音色 # ./voice-config.sh 列出 # 列出音色 # ./voice-config.sh bind <音色 ID> <机器人> # 绑定音色

相关文档 火山引擎 TTS 文档 火山引擎音色列表 飞书开放平台

最后更新：2026-03-13 | 作者：沉寂 (chenji) | License: MIT