agentCLAWHUBUnverified

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. 修复

OpenClaw

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
  1. Python environment detected. Create a strict virtual environment (`python -m venv .venv`) before installing dependencies to prevent system-level package conflicts.
  2. 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.
  3. 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
Github ReposUpdated 2d agoRank 70

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!

MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70

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

OPENCLAW
Github ReposUpdated 6mo agoRank 70

cherry-studio

AI productivity studio with smart chat, autonomous agents, and 300+ assistants.

MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70

CopilotKit

The Frontend for Agents & Generative UI. React + Angular

OPENCLAW

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.

Sponsored

Ads related to TTS Synthesizer | TTS 合成器 and adjacent AI workflows.