- name
- FlowVoice
- description
- Clone any voice from a short audio sample and generate speech with it. Powered by LuxTTS (150x realtime, local, free, no API key). Use when asked to clone a voice, generate a voiceover, add speech to a video, or bake audio into an animation. Supports wav/mp3 input, 48kHz output. Works on CPU and MPS (Apple Silicon).
- homepage
- https://github.com/ysharma3501/LuxTTS
- metadata
- openclaw
- emoji
- 🎙️
- version
- 1.0.0
- author
- windseeker1111
- requires
- bins
- ["uv", "ffmpeg"]
- pip
- ["zipvoice", "soundfile", "librosa"]
Flow Voice — Voice Cloning for OpenClaw
Clone any voice from a 3–30 second audio sample and generate speech from text. Powered by LuxTTS — 150x realtime, runs locally, fits in 1GB VRAM, works on CPU and Apple Silicon MPS. No API key, no cloud, no cost.
Output directory: ~/clawd/output/voice/
Commands
| What you say | What it does |
|---|---|
| "clone this voice [audio file]" | Encode a voice profile from a sample |
| "speak as [name]: [text]" | Generate speech using a saved voice profile |
| "add voiceover to [video]: [text]" | Generate speech + bake into video with ffmpeg |
| "list voices" | Show saved voice profiles |
| "clone voice from URL [url]" | Download audio from URL, then clone |
Workflow
Step 1: Clone a voice
uv run ~/clawd/skills/flow-voice/scripts/clone.py \
--sample /path/to/sample.wav \
--name "eric"Saves encoded profile to ~/clawd/output/voice/profiles/eric.pkl. Requires at least 3 seconds of clean audio. 10–30 seconds is ideal.
Step 2: Generate speech
uv run ~/clawd/skills/flow-voice/scripts/speak.py \
--voice "eric" \
--text "Hello, this is a test of voice cloning." \
--output ~/clawd/output/voice/output.wavOutputs 48kHz WAV. Use --speed 1.0 to adjust pace.
Step 3: Bake into video (optional)
uv run ~/clawd/skills/flow-voice/scripts/speak.py \
--voice "eric" \
--text "Your agent can think. Now teach it to draw." \
--output /tmp/vo.wav
ffmpeg -i input.mp4 -i /tmp/vo.wav \
-c:v copy -c:a aac -shortest output_with_voice.mp4One-Shot: Clone + Speak in one command
uv run ~/clawd/skills/flow-voice/scripts/flow_voice.py \
--sample /path/to/sample.wav \
--text "Beautiful diagrams, from a single prompt." \
--output ~/clawd/output/voice/result.wavNo profile saving — just clone and speak immediately.
Bake voiceover directly into a video
uv run ~/clawd/skills/flow-voice/scripts/flow_voice.py \
--sample /path/to/sample.wav \
--text "Your agent can think. Now teach it to draw." \
--video /path/to/animation.mp4 \
--output ~/clawd/output/voice/final_with_voice.mp4Parameters
| Flag | Default | Description |
|---|---|---|
--sample | required | Reference audio file (wav/mp3, min 3s) |
--text | required | Text to speak |
--output | auto-named | Output file path |
--video | none | If set, bakes audio into this video |
--voice | none | Use saved profile instead of --sample |
--name | none | Save cloned profile with this name |
--speed | 1.0 | Speech speed (0.8 = slower, 1.2 = faster) |
--steps | 4 | Inference steps (3–4 recommended) |
--t-shift | 0.9 | Sampling param (higher = potentially better quality) |
--smooth | false | Add smoothing (reduces metallic artifacts) |
--device | auto | Force cpu / mps / cuda |
Tips
- Minimum 3 seconds of audio for cloning — 10–30s is ideal
- If you hear metallic artifacts, add
--smooth - For Apple Silicon (M1/M2/M3), device defaults to
mpsautomatically - First run downloads the model (~200MB) to
~/.cache/huggingface/ - Clean audio works best — no background music or noise in the reference sample
Examples
Clone Eric's voice from a recording:
uv run ~/clawd/skills/flow-voice/scripts/flow_voice.py \
--sample ~/recordings/eric-30s.wav \
--name eric \
--text "FlowStay is live. Book your room with AI." \
--output ~/clawd/output/voice/flowstay-promo.wavAdd voiceover to a Flow Visual Explainer animation:
uv run ~/clawd/skills/flow-voice/scripts/flow_voice.py \
--voice eric \
--text "Your agent can think. Now teach it to draw." \
--video ~/clawd/2026-03-10-flowvisual-c3-magic-wand-comp.mp4 \
--output ~/clawd/output/voice/flowvisual-voiced.mp4Quick one-shot from a downloaded audio clip:
yt-dlp -x --audio-format wav -o /tmp/ref.wav "https://www.instagram.com/reel/..."
uv run ~/clawd/skills/flow-voice/scripts/flow_voice.py \
--sample /tmp/ref.wav \
--text "Hello from OpenClaw." \
--output ~/clawd/output/voice/test.wav*Powered by LuxTTS (ysharma3501/LuxTTS, ZipVoice-based) — Free, local, no API key required.* *Packaged for OpenClaw by Flow — March 2026*