Edge-TTS Skill

Overview

Generate high-quality text-to-speech audio using Microsoft Edge's neural TTS service via Python edge-tts. Supports multiple languages, voices, adjustable speed/pitch, and subtitle generation (SRT/VTT).

Quick Start

When you detect TTS intent from triggers or user request:

1. 1. Call the tts tool (Clawdbot built-in) to convert text to speech
2. The tool returns a MEDIA: path
3. Clawdbot routes the audio to the current channel

Trigger Detection

Recognize "tts" keyword as TTS requests. The skill automatically filters out TTS-related keywords from text before conversion.

Advanced Customization

Using the Python Scripts

For more control, use the bundled scripts directly:

TTS Converter

Options:

• - --voice, -v: Voice name (default: en-US-MichelleNeural)
• INLINECODE1: Language code (e.g., en-US, zh-CN)
• INLINECODE2: Rate adjustment (e.g., +10%, -20%)
• INLINECODE3: Volume adjustment (e.g., +0%, -50%)
• INLINECODE4: Pitch adjustment (e.g., +0Hz, -10Hz)
• INLINECODE5: Output file path (default: temp file)
• INLINECODE6: Save subtitles to file (.vtt or .srt)
• INLINECODE7: Read text from file
• INLINECODE8: Proxy URL
• INLINECODE9: Receive timeout in seconds (default: 60)
• INLINECODE10: List available voices
• INLINECODE11: Filter voices by language (used with --list-voices)

Configuration Manager

Voice Selection

Common voices (use --list-voices for full list):

English:

• - en-US-MichelleNeural (female, natural, default)
• INLINECODE14 (female, natural)
• INLINECODE15 (male, natural)
• INLINECODE16 (female, British)
• INLINECODE17 (male, British)

Chinese:

• - zh-CN-XiaoxiaoNeural (female)
• INLINECODE19 (male, news style)
• INLINECODE20 (male, natural)

Other Languages:

• - es-ES-ElviraNeural (Spanish)
• INLINECODE22 (French)
• INLINECODE23 (German)
• INLINECODE24 (Japanese)
• INLINECODE25 (Arabic)

Rate Guidelines

Rate values use percentage format:

• - "+0%": Normal speed (default)
• INLINECODE27 to "-10%": Slow, clear (tutorials, stories, accessibility)
• INLINECODE29 to "+20%": Slightly fast (summaries)
• INLINECODE31 to "+50%": Fast (news, efficiency)

Resources

scripts/tts_converter.py

scripts/config_manager.py

Voice Testing

Installation

CODEBLOCK2

Workflow

1. 1. Detect intent: Check for "tts" trigger or keyword in user message
2. Choose method: Use built-in tts tool for simple requests, or scripts/tts_converter.py for customization
3. Generate audio: Convert the target text
4. Return to user: The tts tool returns a MEDIA: path; Clawdbot handles delivery

Testing

Basic Test

Chinese Test

List Voices

Configuration Test

Notes

• - edge-tts uses Microsoft Edge's online TTS service
• No API key needed (free service)
• Output is MP3 format by default
• Requires internet connection
• Supports subtitle generation (standard VTT/SRT format)
• Temporary File Handling: By default, audio files are saved to the system's temporary directory with unique filenames. Specify a custom output path with --output for permanent storage.
• TTS keyword filtering: Automatically filters out TTS-related keywords from text before conversion
• Neural voices (ending in Neural) provide higher quality