skills/skills.volces.com/tts-media-route-fix

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

  1. Locate active hashed gateway-cli-*.js files.
  2. Back up each file to *.bak before modifying.
  3. Patch HTTP handler for GET/HEAD /media/tts/<id>.mp3 with auth, validation, binary output, and Range.
  4. Ensure tts.convert payload returns audioUrl under /media/tts/<id>.mp3 and mp3 metadata.
  5. Restart gateway.
  6. Verify with Bearer-authenticated curl (including --range).
  7. Confirm temporary file TTL cleanup (2–5 minutes).

Commands

Installs
2
First Seen
Apr 23, 2026