ClawHub

LH Edge TTS

Other

Text-to-speech conversion using Python edge-tts for generating audio from text. Supports multiple voices, languages, speed adjustment, pitch control, and subtitle generation. Use when: (1) User requests audio/voice output with the "tts" trigger or keyword. (2) Content needs to be spoken rather than read (multitasking, accessibility, driving, cooking). (3) User wants a specific voice, speed, pitch, or format for TTS output.

Install

openclaw skills install lh-edge-tts

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

cd scripts
python3 tts_converter.py "Your text" --voice en-US-AriaNeural --rate +10% -o output.mp3
python3 tts_converter.py -f input.txt --voice zh-CN-XiaoxiaoNeural -o output.mp3
python3 tts_converter.py -f input.txt -v zh-CN-YunxiNeural -r "+10%" -o output.mp3 -s output.vtt

Options:

  • --voice, -v: Voice name (default: en-US-MichelleNeural)
  • --lang, -l: Language code (e.g., en-US, zh-CN)
  • --rate, -r: Rate adjustment (e.g., +10%, -20%)
  • --volume: Volume adjustment (e.g., +0%, -50%)
  • --pitch: Pitch adjustment (e.g., +0Hz, -10Hz)
  • --output, -o: Output file path (default: temp file)
  • --subtitles, -s: Save subtitles to file (.vtt or .srt)
  • --file, -f: Read text from file
  • --proxy, -p: Proxy URL
  • --timeout: Receive timeout in seconds (default: 60)
  • --list-voices, -L: List available voices
  • --lang-filter: Filter voices by language (used with --list-voices)

Configuration Manager

cd scripts
python3 config_manager.py --set voice zh-CN-XiaoxiaoNeural
python3 config_manager.py --set rate "+10%"
python3 config_manager.py --get
python3 config_manager.py --reset

Voice Selection

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

English:

  • en-US-MichelleNeural (female, natural, default)
  • en-US-AriaNeural (female, natural)
  • en-US-GuyNeural (male, natural)
  • en-GB-SoniaNeural (female, British)
  • en-GB-RyanNeural (male, British)

Chinese:

  • zh-CN-XiaoxiaoNeural (female)
  • zh-CN-YunyangNeural (male, news style)
  • zh-CN-YunxiNeural (male, natural)

Other Languages:

  • es-ES-ElviraNeural (Spanish)
  • fr-FR-DeniseNeural (French)
  • de-DE-KatjaNeural (German)
  • ja-JP-NanamiNeural (Japanese)
  • ar-SA-ZariyahNeural (Arabic)

Rate Guidelines

Rate values use percentage format:

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

Resources

scripts/tts_converter.py

Main TTS conversion script using edge-tts. Generates audio files with customizable voice, rate, volume, pitch. Supports subtitle generation (VTT/SRT) and voice listing.

scripts/config_manager.py

Manages persistent user preferences for TTS settings. Stores config in ~/.tts-config.json.

Voice Testing

Test different voices and preview audio quality at: https://tts.travisvn.com/

Installation

pip install edge-tts

Workflow

  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

cd scripts
python3 tts_converter.py "Hello, this is a test." -o test-output.mp3

Chinese Test

python3 tts_converter.py "这是一个测试" -v zh-CN-XiaoxiaoNeural -o test-zh.mp3

List Voices

python3 tts_converter.py --list-voices --lang-filter zh

Configuration Test

python3 config_manager.py --get
python3 config_manager.py --set voice en-US-GuyNeural
python3 config_manager.py --get voice

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