Bailian TTS
Use this skill to produce speech audio from text with @hackerpl/bailian-cli.
Quick Workflow
- 1. Check CLI availability.
- Check
BAILIAN_API_KEY. - If key is missing, guide user to prepare one in 阿里云百炼.
- Run
bailian tts with requested voice/language/style. - Return output path (or base64 when requested). Default audio output directory:
~/.openclaw/media/audio.
1) Check and install CLI
Run:
CODEBLOCK0
If missing, install:
CODEBLOCK1
2) Check API key
Run:
CODEBLOCK2
If missing, ask user to create and configure key from the 阿里云百炼官方入口（控制台/平台）：
- - https://bailian.console.aliyun.com/
Then set it:
CODEBLOCK3
3) Generate speech (bailian-cli)
Basic (default to OpenClaw media folder):
CODEBLOCK4
Specify voice/language:
CODEBLOCK5
With style instruction:
CODEBLOCK6
Return base64 instead of file:
CODEBLOCK7
Custom output directory:
CODEBLOCK8
4) Voices and languages
CODEBLOCK9
- - Full built-in table: read
references/voices-and-languages.md.
5) Operational notes
- - Keep text length within CLI limit (600 chars per request).
- Default output directory:
~/.openclaw/media/audio (create with mkdir -p ~/.openclaw/media/audio). - Prefer
-o url for file delivery, -o data for programmatic pipelines. - Respect user privacy: do not upload sensitive text externally without explicit confirmation.
- If generation fails, check in order: API key → region → network → voice/language spelling.
- When producing many clips, keep a consistent voice and instruction style for tonal continuity.
百炼 TTS
使用此技能通过 @hackerpl/bailian-cli 将文本转换为语音音频。
快速工作流程
- 1. 检查 CLI 是否可用。
- 检查 BAILIANAPIKEY。
- 如果密钥缺失，引导用户在阿里云百炼中准备一个。
- 使用指定的语音/语言/风格运行 bailian tts。
- 返回输出路径（或按要求返回 base64）。默认音频输出目录：~/.openclaw/media/audio。
1) 检查并安装 CLI
运行：
bash
npm ls -g --depth=0 @hackerpl/bailian-cli
如果缺失，安装：
bash
npm i -g @hackerpl/bailian-cli
2) 检查 API 密钥
运行：
bash
[ -n $BAILIANAPIKEY ] && echo SET || echo MISSING
如果缺失，请用户从阿里云百炼官方入口（控制台/平台）创建并配置密钥：
- - https://bailian.console.aliyun.com/
然后设置：
bash
export BAILIANAPIKEY=sk-xxxx
可选
export BAILIAN_REGION=beijing # 或 singapore
3) 生成语音（bailian-cli）
基础用法（默认输出到 OpenClaw 媒体文件夹）：
bash
mkdir -p ~/.openclaw/media/audio
bailian tts -t 你好，欢迎使用百炼 TTS 服务 -o url -d ~/.openclaw/media/audio
指定语音/语言：
bash
mkdir -p ~/.openclaw/media/audio
bailian tts -t Hello world -v Ethan -l English -o url -d ~/.openclaw/media/audio
带风格指令：
bash
mkdir -p ~/.openclaw/media/audio
bailian tts -t 春眠不觉晓 -v Serena -i 用温柔缓慢的语调朗读 -o url -d ~/.openclaw/media/audio
返回 base64 而非文件：
bash
bailian tts -t 测试 -o data
自定义输出目录：
bash
bailian tts -t 你好世界 -d ./audio
4) 语音和语言
bash
bailian tts --list-voices
- - 完整内置表格：阅读 references/voices-and-languages.md。
5) 操作说明
- - 保持文本长度在 CLI 限制内（每次请求 600 字符）。
- 默认输出目录：~/.openclaw/media/audio（使用 mkdir -p ~/.openclaw/media/audio 创建）。
- 文件交付优先使用 -o url，程序化管道使用 -o data。
- 尊重用户隐私：未经明确确认，不得将敏感文本上传到外部。
- 如果生成失败，按顺序检查：API 密钥 → 区域 → 网络 → 语音/语言拼写。
- 生成多个片段时，保持一致的语音和风格指令以确保语调连贯性。
