telnyx-tts

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

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

Then return the audio file:

MEDIA: /tmp/tts-output.mp3

For Telegram voice notes, the audio will be sent as a voice message.

Environment

Requires TELNYX_API_KEY environment variable to be set.