tts-media-route-fix
Installation
SKILL.md
TTS Media Route Fix
Overview
Apply a production-safe patch workflow for OpenClaw installs where tts.convert and /media/tts/<id>.mp3 routing are broken or incomplete.
Always back up hashed dist files before edits, patch minimally, restart gateway, and verify with authenticated range curl.
Workflow
- Locate active hashed
gateway-cli-*.jsfiles. - Back up each file to
*.bakbefore modifying. - Patch HTTP handler for
GET/HEAD /media/tts/<id>.mp3with auth, validation, binary output, and Range. - Ensure
tts.convertpayload returnsaudioUrlunder/media/tts/<id>.mp3and mp3 metadata. - Restart gateway.
- Verify with Bearer-authenticated curl (including
--range). - Confirm temporary file TTL cleanup (2–5 minutes).