name: mlx-tts description: Text-To-Speech with MLX (Apple Silicon) and opensource models (default QWen3-TTS) locally. author: guoqiao metadata: {"openclaw":{"always":true,"emoji":"🦞","homepage":"https://clawhub.ai/guoqiao/mlx-tts","os":["darwin"],"requires":{"bins":["brew"]}}} triggers:

• "/mlx-tts "
• "TTS ..."
• "Convert text to audio ..."
• "Say "
• "Reply with voice message ..."

MLX TTS

Text-To-Speech with MLX (Apple Silicon) and open-source models (default QWen3-TTS) locally.

Free and Fast. No API key required. No server required.

Requirements

• mlx: macOS with Apple Silicon
• brew: used to install deps if not available

Installation

bash ${baseDir}/install.sh

This script will use brew to install these CLI tools if not available:

• uv: install python package and run python script
• mlx_audio: do the real job

Usage

To generate audio from text, run this script:

bash ${baseDir}/mlx-tts.sh "<text>"

Agent Instructions

1. Run the script: Pass the text to be spoken as an argument.
2. Handle Output: The script will output a path to a audio file. Use the message tool to send the audio file to the user as an voice message:

{
   "action": "send",
   "filePath": "<filepath>"
}

Example: User: "Say hello world" Agent:

1. Runs bash path/to/mlx-tts.sh "hello world"
2. Receives output: /tmp/folder/audio.ogg
3. Calls message(action="send", filePath="/tmp/folder/audio.ogg", ...)