- name
- telnyx-tts
- description
- Generate speech audio from text using Telnyx Text-to-Speech API. Use when you need to convert text to spoken audio, create voice messages, or generate audio content.
- metadata
- {"openclaw":{"emoji":"🔊","requires":{"bins":["python3"],"env":["TELNYX_API_KEY"]},"primaryEnv":"TELNYX_API_KEY"}}
Telnyx Text-to-Speech
Generate high-quality speech audio from text using the Telnyx TTS API.
Usage
To convert text to speech, run the script:
{baseDir}/scripts/telnyx-tts.py "Your text here" -o /tmp/output.mp3The script outputs the path to the generated audio file on success.
Options
-o, --output PATH: Output file path (default: output.mp3)--voice VOICE: Voice ID (default: Telnyx.NaturalHD.astra)
Available Voices
Telnyx provides multiple voice options:
- Telnyx NaturalHD: Premium voices with refined prosody
- Telnyx.NaturalHD.astra (default) - Telnyx.NaturalHD.luna - Telnyx.NaturalHD.andersen_johan
- Telnyx KokoroTTS: Budget-friendly for high-volume
- Telnyx.KokoroTTS.af - Telnyx.KokoroTTS.am
Example
Generate speech and return as media:
{baseDir}/scripts/telnyx-tts.py "Hello! This is a test of Telnyx text to speech." -o /tmp/tts-output.mp3Then return the audio file:
MEDIA: /tmp/tts-output.mp3For Telegram voice notes, the audio will be sent as a voice message.
Environment
Requires TELNYX_API_KEY environment variable to be set.