Edge TTS Global
Use this skill when the user wants fast text-to-speech with the globally installed edge-tts command.
What is available
Global commands:
Bundled helper script:
Preferred Chinese test voice:
Fast workflow
- Put output files in the current caller workspace
temp/ directory.
- Prefer the bundled Python script
scripts/tts_edge.py for standard generation.
- If needed, call
edge-tts directly.
- If sending back to Telegram and the user wants a voice bubble, send the audio with
message and set asVoice=true.
- If the user wants a normal file/audio attachment, send it normally.
- After successful sending, immediately delete the generated temporary file.
Preferred script usage
Generate audio to the current caller workspace temp/ directory automatically:
python3 /data/claw/shared/skills/edge-tts-global/scripts/tts_edge.py -t "老板,你好,我是你的小助理。"
Generate audio with explicit relative path under the current caller workspace:
python3 /data/claw/shared/skills/edge-tts-global/scripts/tts_edge.py -t "老板,你好,我是你的小助理。" -o ./temp/out.mp3
Delete temporary file after successful sending:
python3 /data/claw/shared/skills/edge-tts-global/scripts/tts_edge.py cleanup ./temp/out.mp3
Delete both audio and subtitles:
python3 /data/claw/shared/skills/edge-tts-global/scripts/tts_edge.py cleanup ./temp/out.mp3 ./temp/out.vtt
Change voice explicitly:
python3 /data/claw/shared/skills/edge-tts-global/scripts/tts_edge.py -t "你好" -v zh-CN-XiaoxiaoNeural -o ./temp/out.mp3
Generate subtitles too:
python3 /data/claw/shared/skills/edge-tts-global/scripts/tts_edge.py -t "你好" -o ./temp/out.mp3 --subs ./temp/out.vtt
Direct command patterns
Generate MP3
mkdir -p ./temp
edge-tts --voice zh-CN-XiaoxiaoNeural --text "老板,你好,我是你的小助理。" --write-media ./temp/out.mp3
List voices
edge-tts --list-voices
Telegram sending rule
If the user asks for “气泡语音”, “语音条”, or a voice-message style result:
- generate the file first
- send with
message
- set
asVoice=true
- after successful sending, delete the temporary file immediately
If the user asks for a normal audio file:
- send as a regular attachment
- do not set
asVoice=true
- after successful sending, delete the temporary file immediately
Cleanup guidance
- Temporary outputs belong in the current caller workspace
temp/ directory
- Sending succeeds → delete the generated temporary files immediately
- Prefer
python3 scripts/tts_edge.py cleanup <file> [subtitle] for deterministic cleanup
- Do not remove the global
edge-tts install unless the user explicitly asks