القائمة
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/18816132863/xiaoyi-claw-omega-final --skill xiaoyi-ttsيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | xiaoyi-tts |
| description | 使用小艺TTS语音合成API将文本转换为语音，支持多语言、自定义发音人/语速/音量/音高，生成MP3音频文件 |
通过小艺TTS语音合成 API 将文本智能转换为语音，支持中文、英文、法语、俄语等多语言，可自定义发音人、语速、音量、音高，最终生成标准MP3音频文件。
xiaoyi-image-understanding/
├── SKILL.md # 使用说明（本文档）
├── scripts # 程序文件夹
│ ├── tts.py # 主程序（文本转语音合成）
│ └── ttsList.py # 发音人列表查询脚本（获取语言 + 发音人）
├── _meta.json # Skill 元数据
└── package.json # 项目配置
## 使用方法
### 步骤1：查询发音人列表（必做）
先获取支持的语言和对应发音人，用于后续语音合成参数配置
# 进入 skill 目录
cd /home/sandbox/.openclaw/workspace/skills/xiaoyi-tts
# 查询所有支持的语言和发音人列表
python ./scripts/ttsList.py
使用查询发音人列表得到的language和person参数，person参数对应发音人列表接口返回结果中的name参数，然后执行语音合成
# 基础使用（默认参数：language默认zh-Hans，person默认zh-Hans-st-1，语速5.0、音量5.0、音高5.0）
python ./scripts/tts.py --text "人工智能是当今世界上最热门的话题之一。"
# 基础使用（默认参数：语速5.0、音量5.0、音高5.0）
python ./scripts/tts.py --language "zh-Hans" --person "zh-Hans-st-3" --text "人工智能是当今世界上最热门的话题之一。"
# 自定义参数（语速、音量、音高，取值范围建议1.0-10.0）
python ./scripts/tts.py --language "zh-Hans" --person "zh-Hans-st-3" --text "文本内容" --speed "6.0" --volume "7.0" --pitch "4.0"
# 英文语音合成
python ./scripts/tts.py --language "en-US" --person "en-US-st-1" --text "Artificial intelligence is one of the hottest topics in the world."
# 开启调试模式
python ./scripts/tts.py --language "zh-Hans" --person "zh-Hans-st-3" --text "文本内容" --debug
也可以在 Python 代码中串联调用：
from scripts.ttsList import get_voice_list
from scripts.tts import text_to_speech
# 1. 获取发音人列表
voice_list = get_voice_list()
print("支持的发音人：", voice_list)
# 2. 语音合成（支持自定义参数）
result = text_to_speech(
language="zh-Hans", # 从voice_list取language字段
person="zh-Hans-xy-3", # 从voice_list取name字段
text="人工智能是当今世界上最热门的话题之一。",
speed="5.0",
volume="5.0",
pitch="5.0"
)
# 输出：{"audioPath": "/home/sandbox/tts_output/20250520_123456.mp3"}
print(result)
| 项目 | 值 |
|---|---|
| 语音合成地址 | https://hag-drcn.op.dbankcloud.com/celia-claw/v1/api/skill/tts |
| 发音人查询地址 | https://hag-drcn.op.dbankcloud.com/celia-claw/v1/api/skill/tts/list |
| 鉴权方式 | 从 .xiaoyienv 读取 API Key 和 UID，'.xiaoyienv文件默认存在，无需用户自行创建输入' |
| 响应格式 | 发音人查询：JSON；语音合成：二进制 MP3 流 |
在 /home/sandbox/.openclaw/.xiaoyienv 文件中配置以下参数：
PERSONAL-API-KEY=你的API密钥
PERSONAL-UID=你的用户ID
注意：
PERSONAL-API-KEY 和 PERSONAL-UID 即可无额外参数，直接调用即可获取全量列表
{
"languages": [
{
"speakers": [
{
"codec": "3",
"name": "zh-Hans-xy-1",
"sampleRate": "16000",
"desc": "小艺女声"
},
{
"codec": "3",
"name": "zh-Hans-xy-2",
"sampleRate": "16000",
"desc": "小艺少女"
}
],
"language": "zh-Hans"
}
],
"retCode": "0"
其中"name": "zh-Hans-xy-1"是后续语音合成的person字段。
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| language | string | ✅ | - | 语言编码（从 ttsList.py 查询） |
| person | string | ✅ | - | 发音人编码（从 ttsList.py 查询） |
| text | string | ✅ | - | 待合成文本，≤500 字符 |
| speed | string | ❌ | 5.0 | 语速，建议 1.0-10.0 |
| volume | string | ❌ | 5.0 | 音量，建议 1.0-10.0 |
| pitch | string | ❌ | 5.0 | 音高，建议 1.0-10.0 |
python ./scripts/tts.py --language "zh-Hans" --person "zh-Hans-st-3" --text "人工智能是当今世界上最热门的话题之一。"
✅ 所有帧解析完成
📊 统计：总帧数 2，音频帧 2，音频总大小 5616 字节
✅ 纯音频已保存到：xxx\zh-Hans-20260416326.mp3
无
| 错误码 | 错误信息 | 解决方案 |
|---|---|---|
| 401 | Permission denied | 检查 Token 是否过期 |
| 400 | Parameter is not valid | 检查 language/person 参数是否匹配 |
| 500 | Internal Server Error | 后端服务器错误 |
| timeout | Request timeout | 增加超时时间或检查网络 |
| connection error | Failed to connect | 检查网络连接 |
当需要文本转语音时：
记住：语音合成前必须先查询发音人列表，文本长度严格控制在 500 字以内，参数匹配才能成功合成。✅