TTS Synthesizer | TTS 合成器
文字转语音(Text-to-Speech / TTS)工具。 支持 edge-tts(微软神经网络 TTS,在线合成)和 OpenAI 兼容 API TTS。 触发词:语音回复、TTS、文字转语音、语音合成、语音对话。 适用平台:Linux / Windows / macOS。 Skill: TTS Synthesizer | TTS 合成器 Owner: moroiser Summary: 文字转语音(Text-to-Speech / TTS)工具。 支持 edge-tts(微软神经网络 TTS,在线合成)和 OpenAI 兼容 API TTS。 触发词:语音回复、TTS、文字转语音、语音合成、语音对话。 适用平台:Linux / Windows / macOS。 Tags: latest:1.0.9 Version history: v1.0.9 | 2026-04-29T14:52:50.848Z | user test v1.0.8 | 2026-04-29T14:08:54.737Z | user 1. Fix all internal path references and display names to match the renamed tts-synthesizer slug. 修复
Rank
62
Safety
84
Downloads
1.1k
Updated
Oct 11, 2026
Version
1.0.9
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.1K downloads reported by the source. Last updated 10/11/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 11, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 11, 2026
- Adoption signal
- 1.1K downloadsadoption · observed Oct 11, 2026
- Latest release
- 1.0.9release · observed Apr 29, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: medium.
clawhub skill install s1708w2t7w31qf7b0gsy7kamnx83gqa6:tts-synthesizer- Python environment detected. Create a strict virtual environment (`python -m venv .venv`) before installing dependencies to prevent system-level package conflicts.
- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-moroiser-tts-synthesizer/snapshot"
Documentation
CLAWHUB
68,606 characters of source documentation, loaded on request.
Extracted files
4 files captured from the source.
SKILL.md
---
name: TTS Synthesizer | TTS 合成器
description: |
文字转语音(Text-to-Speech / TTS)工具。
支持 edge-tts(微软神经网络 TTS,在线合成)和 OpenAI 兼容 API TTS。
触发词:语音回复、TTS、文字转语音、语音合成、语音对话。
适用平台:Linux / Windows / macOS。
---
# TTS Synthesizer | TTS 合成器 🔊
将文字转换为语音,支持微软神经网络 TTS(联网合成)和 OpenAI 兼容 API。
## 目录
1. [概述](#概述)
2. [快速开始](#快速开始)
3. [脚本说明](#脚本说明)
4. [声音列表](#声音列表)
5. [输出目录](#输出目录)
6. [环境变量](#环境变量)
7. [故障排查](#故障排查)
---
## 概述
> ⚠️ **注意**:OpenClaw 内置了 `tts` 工具,但它的输出格式(MP3/WebM)不适合直接发送飞书语音。
> **飞书语音消息必须用 `tts_simple.py`**,它会自动输出 OGG/Opus 格式。
### 支持的 TTS 引擎
| 引擎 | 说明 | 优点 | 缺点 |
|------|------|------|------|
| `edge` ⭐ | 微软神经网络 TTS | 免费、联网合成、高音质、支持中文 | 需访问微软服务 |
| `api` | OpenAI 兼容 API | 质量高、可选声音多 | 需要 API Key |
### edge-tts 支持的声音(完整列表)
**中文(大陆)**:
| 声音 | 风格 |
|------|------|
| `zh-CN-XiaoxiaoNeural` | 晓晓(女声,**默认**)|
| `zh-CN-YunxiNeural` | 云希(男声)|
| `zh-CN-YunyangNeural` | 云扬(男声)|
| `zh-CN-XiaoyiNeural` | 晓伊(女声)|
**中文(台湾)**:
| 声音 | 风格 |
|------|------|
| `zh-TW-HsiaoYuNeural` | 小宇(女声)|
**英文**:
| 声音 | 风格 |
|------|------|
| `en-US-JennyNeural` | 美式女声 |
| `en-US-GuyNeural` | 美式男声 |
| `en-GB-SoniaNeural` | 英式女声 |
| `en-GB-RyanNeural` | 英式男声 |
| `en-AU-NatashaNeural` | 澳式女声 |
| `en-IN-NeerjaNeural` | 印度女声 |
**日文**:
| 声音 | 风格 |
|------|------|
| `ja-JP-NanamiNeural` | 日语女声 |
| `ja-JP-MayuNeural` | 日语男声 |
**韩文**:
| 声音 | 风格 |
|------|------|
| `ko-KR-SunHiNeural` | 韩语女声 |
| `ko-KR-InJoonNeural` | 韩语男声 |
**其他常用**:
| 声音 | 语言 |
|------|------|
| `fr-FR-DeniseNeural` | 法语女声 |
| `de-DE-KatjaNeural` | 德语女声 |
| `es-ES-ElviraNeural` | 西班牙语女声 |
| `ru-RU-SvetlanaNeural` | 俄语女声 |
| `pt-BR-FranciscaNeural` | 葡萄牙语女声 |
> 💡 查看完整列表:`python3 scripts/tts_edge.py "test" --list-voices`
---
## 快速开始
### 1. 安装依赖
```bash
cd ~/.openclaw/workspace/skills/tts-synthesizer
pip install -r requirements.txt
```
### 2. 运行(生成飞书语音用这个)
```bash
# ⭐ tts_simple.py — 输出 OGG/Opus,可直接作为飞书语音发送
python3 scripts/tts_simple.py "你好,这是测试语音"
# 使用指定声音(见下方声音列表)
python3 scripts/tts_simple.py "你好" --voice zh-CN-YunxiNeural
# 使用 API
python3 scripts/tts_simple.py "你好" --engine api \
--api-url https://api.openai.com/v1 \
--api-key sk-xxx \
--voice alloy
```
### 3. 调节语速和音调
```bash
# 语速 +10%(稍快)
python3 scripts/tts_simple.py "快速播报" --rate "+10%"
# 语速 -10%(稍慢)
python3 scripts/tts_simple.py "慢速播报" --rate "-10%"
# 音调升高
python3 scripts/tts_simple.py "音调较高" --pitch "+5Hz"
```
---
## 脚本说明
### scripts/tts_simple.py ⭐ 推荐
通用的文字转语音脚本,**自动输出 OGG/Opus 格式,适合飞书语音消息**。
```bash
python3 scripts/tts_simple.py "要转换的文字" [选项]
```
**参数**:
| 参数 | 说明 |
|------|------|
| `text` | 要转换的文字,或 `.txt` 文件路径 |
| `--output, -o` | 输出文件路径 |
| `--engine, -e` | 引擎:`edge`(默认)或 `api` |
| `--voice, -v` | 声音名称 |
| `--rate, -r` | 语速,如 `+10%`、`-5%`(仅 edge) |
| `--pitch, -p` | 音调,如 `+5Hz`、`-3Hz`(仅 edge) |
| `--api-url` | API URL(api 模式) |
| `--api-key` | API Key(api 模式) |
| `--api-model` | API 模型(默认 `tts-1`) |
### scripts/tts_edge.py
纯粹的 edge-tts 脚本,**输出 MP3 格式**(不适合直接发送飞书语音)。
```bash
# 列出所有声音
python3 scripts/tts_edge.py "test_meta.json
{
"ownerId": "kn75k53tcdhqwka2fra5x817p9821zpb",
"slug": "tts-synthesizer",
"version": "1.0.9",
"publishedAt": 1777474370848
}skill-card.md
## Description: Converts text to speech using Microsoft edge-tts or an OpenAI-compatible TTS API, with support for OGG/Opus output for Feishu voice messages. This skill is ready for commercial/non-commercial use. ## Publisher: [moroiser](https://clawhub.ai/user/moroiser) ### License/Terms of Use: MIT-0 ## Use Case: Developers and agent operators use this skill to synthesize spoken audio from text, choose TTS voices, and generate Feishu-ready OGG/Opus files or general MP3 output. ### Deployment Geography for Use: Global ## Known Risks and Mitigations: Risk: TTS input text may be sent to Microsoft edge-tts or to the configured OpenAI-compatible API endpoint. Mitigation: Avoid sending secrets or private regulated data for synthesis, and install the skill only when the configured provider is acceptable for the intended data. Risk: API mode sends credentials and requests to the configured TTS endpoint. Mitigation: Use a trusted HTTPS API URL and prefer environment variables over command-line API keys. Risk: Dependency changes could affect runtime behavior or provider communication. Mitigation: Pin dependencies in a virtual environment before use when reproducibility or change control matters. ## Reference(s): - [ClawHub skill page](https://clawhub.ai/moroiser/skills/tts-synthesizer) - [Publisher profile](https://clawhub.ai/user/moroiser) - [OpenAI-compatible API base URL example](https://api.openai.com/v1) ## Skill Output: **Output Type(s):** [Guidance, Shell commands, Configuration, Files] **Output Format:** [Markdown guidance with bash commands and generated audio file paths] **Output Parameters:** [1D] **Other Properties Related to Output:** [Produces OGG/Opus audio for Feishu voice messages through tts_simple.py and MP3 audio through tts_edge.py.] ## Skill Version(s): 1.0.9 (source: server release metadata) ## Ethical Considerations: Users should evaluate whether this skill is appropriate for their environment, review any generated or modified files before relying on them, and apply their organization's safety, security, and compliance requirements before deployment.
requirements.txt
# Audio TTS Skill - Python Dependencies # Install: pip install -r requirements.txt # # ⚠️ System dependencies required (install separately): # Ubuntu/Debian: sudo apt install ffmpeg libopus-tools # macOS: brew install ffmpeg # Windows: download ffmpeg and add to PATH # ── Core TTS ───────────────────────────────────────────────────────────────── # edge-tts: Microsoft Neural TTS (free, high quality, offline) edge-tts>=7.0.0 # ── API Support ─────────────────────────────────────────────────────────────── # For OpenAI-compatible API TTS openai>=1.0.0 # ── Audio Conversion ───────────────────────────────────────────────────────── # av (PyAV): audio/video conversion, required for OGG/Opus conversion av>=10.0.0 # ── Core ───────────────────────────────────────────────────────────────────── aiohttp>=3.8.0
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/moroiser/skills/tts-synthesizer",
"sourceUrl": "https://clawhub.ai/moroiser/skills/tts-synthesizer",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T10:27:11.793Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-moroiser-tts-synthesizer/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-moroiser-tts-synthesizer/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-11T10:27:11.793Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.1K downloads",
"href": "https://clawhub.ai/moroiser/tts-synthesizer",
"sourceUrl": "https://clawhub.ai/moroiser/tts-synthesizer",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-11T10:27:11.793Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.0.9",
"href": "https://clawhub.ai/moroiser/tts-synthesizer",
"sourceUrl": "https://clawhub.ai/moroiser/tts-synthesizer",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-29T14:52:50.848Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-moroiser-tts-synthesizer/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-moroiser-tts-synthesizer/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.0.9",
"description": "test",
"href": "https://clawhub.ai/moroiser/tts-synthesizer",
"sourceUrl": "https://clawhub.ai/moroiser/tts-synthesizer",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-29T14:52:50.848Z",
"isPublic": true
}
]
}Record generated Oct 11, 2026.
