How do I install the Bailian Tts skill?

Run npx skillmds@latest add knownasnaffy/bailian-tts-5 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Bailian Tts safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Bailian Tts?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Bailian Tts free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Bailian Tts?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Bailian Tts by knownasnaffy — Agent Skill

Name: Bailian Tts
Rating: 4.2 (5 reviews)
Author: knownasnaffy

Bailian Tts

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).

knownasnaffy Updated Sep 22, 2026 0 repo stars

File contents

Permission Setup Review

python scripts/_wildcard_placeholder.py is an optional setup helper for the Bailian TTS skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.

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.

---name: bailian-tts-5description: 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).---### Permission Setup Review`python scripts/_wildcard_placeholder.py` is an optional setup helper for the `Bailian TTS` skill. It may apply broad filesystem permissions for compatibility. Show the target paths and permission mode, explain the risk, and prefer a narrower mode when shared write access is not needed.# Bailian TTSUse this skill to produce speech audio from text with `@hackerpl/bailian-cli`.## Quick Workflow1. Check CLI availability.2. Check `BAILIAN_API_KEY`.3. If key is missing, guide user to prepare one in 阿里云百炼.4. Run `bailian tts` with requested voice/language/style.5. Return output path (or base64 when requested). Default audio output directory: `~/.openclaw/media/audio`.## 1) Check and install CLIRun:```bashnpm ls -g --depth=0 @hackerpl/bailian-cli```If missing, install:```bashnpm i -g @hackerpl/bailian-cli```## 2) Check API keyRun:```bash[ -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:```bashexport BAILIAN_API_KEY="sk-xxxx"# optionalexport BAILIAN_REGION="beijing" # or singapore```## 3) Generate speech (bailian-cli)Basic (default to OpenClaw media folder):```bashmkdir -p ~/.openclaw/media/audiobailian tts -t "你好，欢迎使用百炼 TTS 服务" -o url -d ~/.openclaw/media/audio```Specify voice/language:```bashmkdir -p ~/.openclaw/media/audiobailian tts -t "Hello world" -v "Ethan" -l "English" -o url -d ~/.openclaw/media/audio```With style instruction:```bashmkdir -p ~/.openclaw/media/audiobailian tts -t "春眠不觉晓" -v "Serena" -i "用温柔缓慢的语调朗读" -o url -d ~/.openclaw/media/audio```Return base64 instead of file:```bashbailian tts -t "测试" -o data```Custom output directory:```bashbailian tts -t "你好世界" -d "./audio"```## 4) Voices and languages- For live lookup:```bashbailian 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.

Frequently asked questions