bailian-tts

该 Skill 通过 npm 包 @hackerpl/bailian-cli 调用阿里云百炼 TTS 服务，把文本合成为语音音频。流程包括检查/安装 CLI、检查 BAILIAN_API_KEY、指定音色、语言与风格指令执行合成，并返回音频文件路径或 base64 数据；默认输出目录为宿主专属路径。

hackerpl

热度 74.48

最近更新 2026-05-17 13:32:13

分类：创作依赖：代码执行 / 读写文件 / 第三方 API应用场景：故事创作

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add bailian-tts

Metadata

name: bailian-tts
description: Generate speech audio with 阿里云百炼 TTS via the `bailian-cli` npm package. Use when users ask to convert text to voice, choose voices/languages, batch-generate narration, or troubleshoot 百炼 TTS setup (npm install, API key, region, output format/path).

Bailian TTS

Use this skill to produce speech audio from text with @hackerpl/bailian-cli.

Quick Workflow

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:

npm ls -g --depth=0 @hackerpl/bailian-cli

If missing, install:

npm i -g @hackerpl/bailian-cli

2) Check API key

Run:

[ -n "$BAILIAN_API_KEY" ] && echo SET || echo MISSING

If missing, ask user to create and configure key from the 阿里云百炼官方入口（控制台/平台）：

https://bailian.console.aliyun.com/

Then set it:

export BAILIAN_API_KEY="sk-xxxx"
# optional
export BAILIAN_REGION="beijing"   # or singapore

3) Generate speech (bailian-cli)

Basic (default to OpenClaw media folder):

mkdir -p ~/.openclaw/media/audio
bailian tts -t "你好，欢迎使用百炼 TTS 服务" -o url -d ~/.openclaw/media/audio

Specify voice/language:

mkdir -p ~/.openclaw/media/audio
bailian tts -t "Hello world" -v "Ethan" -l "English" -o url -d ~/.openclaw/media/audio

With style instruction:

mkdir -p ~/.openclaw/media/audio
bailian tts -t "春眠不觉晓" -v "Serena" -i "用温柔缓慢的语调朗读" -o url -d ~/.openclaw/media/audio

Return base64 instead of file:

bailian tts -t "测试" -o data

Custom output directory:

bailian tts -t "你好世界" -d "./audio"

4) Voices and languages

For live lookup:

bailian tts --list-voices

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.