Agent skill

Xiaoai Tts

by coderzc in coderzc/open-xiaoai-bridge

Control Xiaoai speaker via OpenXiaoAI Voice API for high-quality TTS playback.

MITAuto-check passedMedia & Creative

Install Xiaoai Tts

skills CLI
$ npx skills add coderzc/open-xiaoai-bridge --skill xiaoai-tts -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install coderzc/open-xiaoai-bridge xiaoai-tts --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/coderzc/open-xiaoai-bridge.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/xiaoai-tts .claude/skills/xiaoai-tts && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
xiaoai-tts
GitHub stars
392
Token cost
~749 tokens
SKILL.md length
138 words
Files
9 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Control Xiaoai speaker via OpenXiaoAI Voice API for high-quality TTS playback.

  • Works in 3 steps: 用户想使用自定义复刻音色时,引导用户前往火山引擎完成声音训练并获取音色 ID → 用户拿到音色 ID 后,引导用户将音色昵称和 ID 填入下方表格 → 后续用户提到音色昵称时,直接从表格中查找对应 ID 使用
  • The user wants to play voice notifications
  • SKILL.md covers 前置配置, 使用方法, 常用音色推荐 and 情感参数(仅多情感音色), plus 1 more section
  • Runs Python scripts from its folder

What it does

Xiaoai Tts is an agent skill from coderzc/open-xiaoai-bridge. Control Xiaoai speaker via OpenXiaoAI Voice API for high-quality TTS playback. Use when the user wants to play voice notifications, announcements, or TTS through the Xiaoai speaker using the OpenXiaoAI HTTP API. Supports Doubao (ByteDance) TTS with emotions, voice types, and speed control. Triggers on queries like "小爱播报", "语音播报", "让小爱说", "读出来", "播报", "xiaoai-tts","tts", "TTS", "小爱音箱语音播报".

Its SKILL.md is about 750 tokens, which your agent loads only when the skill is triggered. The skill folder holds 10 other files, including scripts (for example `scripts/api_client.py`, `scripts/control.py` and `scripts/list_doubao_voices.py`).

It sits in Media & Creative, covering Text to speech and voice and REST APIs. The repository describes itself as: 小爱音箱与外部 AI 服务(OpenClaw、小智 AI 等)的桥接器. The licence is MIT.

When your agent uses it

  • The user wants to play voice notifications
  • TTS through the Xiaoai speaker using the OpenXiaoAI HTTP API
  • Queries like 小爱播报
  • 播报, xiaoai-tts,tts

Example prompts

  • “xiaoai-tts”
  • “小爱音箱语音播报”
  • “/xiaoai-tts”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. 用户想使用自定义复刻音色时,引导用户前往火山引擎完成声音训练并获取音色 ID
  2. 用户拿到音色 ID 后,引导用户将音色昵称和 ID 填入下方表格
  3. 后续用户提到音色昵称时,直接从表格中查找对应 ID 使用

What it can do on your machine

Read from SKILL.md and the folder at commit b2d8384. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 7 files in scripts/ (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • console.volcengine.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Xiaoai Tts loads about 749 tokens when it runs. Until then it costs about 101 tokens; SKILL.md has 138 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~101
When it runs · the whole SKILL.md, loaded when a task matches
~749

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from coderzc/open-xiaoai-bridge at commit b2d8384, republished under its MIT licence (© coderzc). 138 words, ~749 tokens.

Download SKILL.mdSave it as .claude/skills/xiaoai-tts/SKILL.md (or your agent's skills folder). This skill also uses 8 other files; get the full folder from GitHub.
name
xiaoai-tts
description
Control Xiaoai speaker via OpenXiaoAI Voice API for high-quality TTS playback. Use when the user wants to play voice notifications, announcements, or TTS through the Xiaoai speaker using the OpenXiaoAI HTTP API. Supports Doubao (ByteDance) TTS with emotions, voice types, and speed control. Triggers on queries like "小爱播报", "语音播报", "让小爱说", "读出来", "播报", "xiaoai-tts","tts", "TTS", "小爱音箱语音播报".

XiaoAI TTS

通过 XiaoAI HTTP API 控制小爱音箱播放语音,支持火山引擎豆包 TTS 多情感、多音色、语速调整等高级功能。

前置配置

在 env 中添加:

bash
OPENXIAOAI_BASE_URL="http://192.168.x.x:9092"  # OpenXiaoAI 服务地址

使用方法

bash
# 语音播报(优先 Doubao TTS,失败自动回退小爱自带 TTS)
xiaoai-tts tts "你好,我是小爱语音助手"

# 指定音色
xiaoai-tts tts "你好" -s zh_female_vv_uranus_bigtts

# 调整语速(0.8-2.0)
xiaoai-tts tts "你好" --speed 1.2

# 指定情感(仅多情感音色支持)
xiaoai-tts tts "你怎么能这样!" -s zh_male_lengkugege_emo_v2_mars_bigtts -m angry

# 2.0 音色 + 上下文指令
xiaoai-tts tts "这是一个很长的句子" -s zh_female_vv_uranus_bigtts -c "你可以说慢一点吗?"

# 强制使用小爱自带 TTS
xiaoai-tts text "你好"

# 唤醒小爱
xiaoai-tts wakeup
xiaoai-tts wakeup --silent   # 静默唤醒

# 状态 / 健康检查
xiaoai-tts status
xiaoai-tts health

# 播放音频
xiaoai-tts file /path/to/audio.mp3
xiaoai-tts url "http://example.com/audio.mp3"

# 查看可用音色
xiaoai-tts voices            # 所有音色
xiaoai-tts voices -v 2.0     # 仅 2.0 音色
xiaoai-tts voices -v 1.0     # 仅 1.0 音色

常用音色推荐

用户自定义声音复刻(S_ 前缀)

如果用户想使用自定义复刻音色,引导用户前往 火山引擎声音复刻控制台 上传声音训练专属音色,训练完成后在 音色库 的「我的音色」中复制音色 ID(格式为 S_xxxxxxxx),填入 -s 参数即可使用。

bash
xiaoai-tts tts "你好,我是你的专属语音助手" -s S_xxxxxxxx

注意:声音复刻音色 ID 通常以 S_ 开头,传入时无需通过 xiaoai-tts voices 列表验证,直接使用即可。

工作流:

  1. 用户想使用自定义复刻音色时,引导用户前往火山引擎完成声音训练并获取音色 ID
  2. 用户拿到音色 ID 后,引导用户将音色昵称和 ID 填入下方表格
  3. 后续用户提到音色昵称时,直接从表格中查找对应 ID 使用
用户已保存的自定义音色
音色名称speaker_id特点
(暂无,引导用户添加)--
2.0 音色(推荐)
音色名称speaker_id特点
Vivi 2.0zh_female_vv_uranus_bigtts通用场景,情感变化
小何 2.0zh_female_xiaohe_uranus_bigtts通用场景
云舟 2.0zh_male_m191_uranus_bigtts通用场景
小天 2.0zh_male_taocheng_uranus_bigtts通用场景
1.0 音色(多情感)
音色名称speaker_id特点
冷酷哥哥zh_male_lengkugege_emo_v2_mars_bigtts支持 emotion 参数
高冷御姐zh_female_gaolengyujie_emo_v2_mars_bigtts支持 emotion 参数
灿灿zh_female_cancan_mars_bigtts通用场景
爽快思思zh_female_shuangkuaisisi_moon_bigtts通用场景

情感参数(仅多情感音色)

中文情感英文参数说明
开心happy愉快语气
悲伤sad悲伤语气
生气angry愤怒语气
惊讶surprised惊讶语气
撒娇lovey-dovey撒娇语气
温柔tender温柔语气
讲故事storytelling讲故事语气
新闻播报news新闻播报语气
广告营销advertising广告营销语气
磁性magnetic磁性声音

完整情感列表参考:xiaoai-tts voices

API 端点

  • Base URL: http://{host}:9092
  • Content-Type: application/json

© coderzc, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 8 other files (scripts) in skills/xiaoai-tts of coderzc/open-xiaoai-bridge.

  • SKILL.md
  • scripts/api_client.py
  • scripts/control.py
  • scripts/list_doubao_voices.py
  • scripts/play_file.py
  • scripts/play_text.py
  • scripts/play_url.py
  • scripts/tts_doubao.py
  • tools/xiaoai-tts

Open the folder on GitHubat commit b2d8384

Compare with similar skills

Xiaoai Tts next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Xiaoai Tts compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Xiaoai Tts this skillcoderzc/open-xiaoai-bridge392—~749Automated safety check: PassMIT
Setup API Keyelevenlabs/skills482—~954Automated safety check: NotesMIT
Fish Audio APIwaker240/FullVideoProductionSkill199—~1.1kAutomated safety check: NotesApache-2.0
Agentselevenlabs/skills482—~6.5kAutomated safety check: PassMIT
MoneyPrinterTurbo Video Generatorharry0703/MoneyPrinterTurbo129k—~2.1kAutomated safety check: WarnMIT
HyperFrames Media Useheygen-com/hyperframes59k—~2.4kAutomated safety check: PassApache-2.0

Similar skills

  • Setup API Key

    elevenlabs/skills

    Guides users through setting up an ElevenLabs API key for REST API and SDK workflows.

    482 GitHub stars~954 tokensUpdated today
    Media & CreativeAuto-check: notes
  • Fish Audio API

    waker240/FullVideoProductionSkill

    Generate narration with the public Fish Audio REST API using environment credentials and a user-selected voice.

    199 GitHub stars~1.1k tokensUpdated 13 days ago
    Media & CreativeAuto-check: notes
  • Agents

    elevenlabs/skills

    Build voice AI agents with ElevenLabs. An agent skill from elevenlabs/skills.

    482 GitHub stars~6.5k tokensUpdated today
    AI & LLM EngineeringAuto-check passed
  • MoneyPrinterTurbo Video Generator

    harry0703/MoneyPrinterTurbo

    Installs and runs MoneyPrinterTurbo to turn a topic or script into a finished short video with voice-over, subtitles, stock footage and music.

    129k GitHub stars~2.1k tokensUpdated today
    Media & CreativeAuto-check: warnings
  • HyperFrames Media Use

    heygen-com/hyperframes

    Finds, generates and edits media for HyperFrames video projects: music, sound effects, images, icons, logos, voiceovers, captions and color grades.

    59k GitHub stars~2.4k tokensUpdated today
    Media & CreativeAuto-check passed
  • Openspec Onboard

    SAP/e-mobility-charging-stations-simulator

    Official

    Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.

    227 GitHub starsUsed in 25 repos~3.5k tokens
    Media & CreativeAuto-check passed

Questions about Xiaoai Tts

What does Xiaoai Tts do?

Control Xiaoai speaker via OpenXiaoAI Voice API for high-quality TTS playback. Xiaoai Tts is an agent skill from coderzc/open-xiaoai-bridge. Control Xiaoai speaker via OpenXiaoAI Voice API for high-quality TTS playback.

When should I use Xiaoai Tts?

Xiaoai Tts fits situations like: the user wants to play voice notifications; TTS through the Xiaoai speaker using the OpenXiaoAI HTTP API; queries like 小爱播报; 播报, xiaoai-tts,tts.

How do I install Xiaoai Tts in Claude Code?

Run `npx skills add coderzc/open-xiaoai-bridge --skill xiaoai-tts -a claude-code`. Or copy the skill folder (skills/xiaoai-tts in coderzc/open-xiaoai-bridge) into .claude/skills/xiaoai-tts in your project. Claude Code loads it when a task matches its description.

How do I install Xiaoai Tts in Codex?

Run `npx skills add coderzc/open-xiaoai-bridge --skill xiaoai-tts -a codex`. Or copy the skill folder (skills/xiaoai-tts in coderzc/open-xiaoai-bridge) into .agents/skills/xiaoai-tts in your project. Codex loads it when a task matches its description.

Can I use Xiaoai Tts in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add coderzc/open-xiaoai-bridge --skill xiaoai-tts -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/xiaoai-tts, .gemini/skills/xiaoai-tts, .github/skills/xiaoai-tts and .opencode/skills/xiaoai-tts in your project.

What does Xiaoai Tts need to run?

Going by SKILL.md and its folder, Xiaoai Tts needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Xiaoai Tts access the network?

SKILL.md names 1 domain. As links in the text: console.volcengine.com. This is read from the text; nothing was executed.

Is Xiaoai Tts safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Xiaoai Tts use?

Xiaoai Tts is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Xiaoai Tts use?

About 749 tokens (SKILL.md is roughly 3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Xiaoai Tts?

Skills that share tags, products or a category with Xiaoai Tts: Setup API Key (elevenlabs/skills, 482 stars), Fish Audio API (waker240/FullVideoProductionSkill, 199 stars), Agents (elevenlabs/skills, 482 stars) and MoneyPrinterTurbo Video Generator (harry0703/MoneyPrinterTurbo, 129k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Xiaoai Tts?

coderzc (a GitHub user) maintains it in coderzc/open-xiaoai-bridge, which has 392 GitHub stars. The repository was last updated on September 24, 2026.

Source: coderzc/open-xiaoai-bridge on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.