---

name: local-voice-reply description: Generate local OPUS/Ogg voice replies (default Juno voice) for Feishu and Discord using a local FastAPI TTS server. Requires ffmpeg on PATH plus local Python deps (torch/torchaudio/chatterbox-tts/fastapi/uvicorn). Activate when /voice_mode_on or when user asks for voice reply/audio message.

Local Voice Reply

Use this skill to turn text into a cloned-voice audio reply and deliver it reliably to Feishu or Discord.

Server implementation is kept with the skill (not workspace root):

• server/voice_server_v3.py (FastAPI routes)
• server/voice_engine.py (generation and cache engine)

Voice assets are also colocated with the skill:

• voice/

Runtime requirements

• ffmpeg must be installed and available on PATH (required for Opus encoding).
• Python packages required by the server:
  • fastapi
  • uvicorn
  • python-multipart
  • chatterbox-tts
  • torch
  • torchaudio
  • numpy
• On first startup, ChatterboxTTS.from_pretrained() may download model assets, so initial run can require network access and additional disk.
• Optional env vars:
  • TARVIS_VOICE_OUTPUT_DIR to override where generated Opus files are written.
  • TARVIS_VOICE_DEVICE to force device selection (cuda/gpu, mps, or cpu).

Persistence behavior

• Uploaded voice samples from POST /voice/register are persisted under server/voices/.
• Cache and registry data are persisted under server/voice_cache/.
• Generated Opus outputs are written under .openclaw/media/outbound/voice-server-v3/ by default (or TARVIS_VOICE_OUTPUT_DIR when set).
• POST /output/cleanup only deletes staged .opus files inside the configured output directory and their .json sidecar files.

Use this workflow

1. Ensure local v3.3 TTS server is running from this skill folder:
   • python -m uvicorn --app-dir server voice_server_v3:app --host 127.0.0.1 --port 8000
2. Call /speak with text (and optional speed, exaggeration, cfg).
   • voice_name defaults to juno.
3. Receive Opus directly from server (audio/ogg) in Juno voice.
4. Save final media into allowed path:
   • C:\Users\hanli\.openclaw\media\outbound\
5. Send with message tool:
   • action=send
   • filePath=<allowed-path>
   • asVoice=true
   • For Feishu: channel=feishu
   • For Discord: channel=discord

Defaults

• voice_name: juno
• speed: 1.2
• Output format: Opus in Ogg container from server /speak (no post-conversion)
• Discord compatibility: Ogg/Opus is supported and can be sent as voice/audio with asVoice=true

Speed Improvements In This Version

• Caches model capability lookups once at startup.
• Uses torch.inference_mode() during synthesis to reduce overhead.
• Reuses phrase cache for both /speak and /speak_stream.
• Improves chunking behavior for long CJK text to avoid oversized chunks.
• Keeps latency metrics for benchmarking and tuning.

Common failure and fix

• Error: LocalMediaAccessError ... path-not-allowed
• Fix: copy the file into .openclaw/media/outbound before sending.

Script

Use scripts/send_voice_reply.ps1 to generate Opus directly with defaults (voice_name=juno, speed=1.2). It auto-selects /speak_stream for longer text (or when -Stream is passed) for better throughput.

For stable CUDA generation command patterns under stricter exec approval policies, use:

• scripts/generate_cuda_voice.ps1 -Text "..." This keeps the outer command shape fixed so allow-always is more reusable.