Poetry Recitation#

Generate a video: voice recitation + starry background + timed Chinese subtitles.

Prerequisites#

• TTS pipeline at ~/.openclaw/skills/tts-gen-pipeline/ with at least one cloned voice
• Dependencies: dashscope, websockets, moviepy, pillow, numpy
• Font: NotoSerifCJK at /usr/share/fonts/opentype/noto/NotoSerifCJK-Regular.ttc

Quick Start#

bash

python3 scripts/poetry_recitation.py --poem "床前明月光\n疑是地上霜" --title "静夜思"
# or specify a voice:
python3 scripts/poetry_recitation.py --poem "..." --title "静夜思" --voice 章彦博

Arguments#

ArgRequiredDescription--poemYesPoem text, use \n for line breaks--titleNoTitle displayed at top of video--voiceNoVoice name: cloned voice (e.g. 章彦博) or system voice (cherry/serena/ethan/chelsie). Default: first cloned voice--outputNoOutput video path (default: ~/workspace/audio/<title>_朗诵.mp4)

Available Voices#

Cloned voices: Check with python3 ~/.openclaw/skills/tts-gen-pipeline/scripts/generate.py list-local

System voices: cherry (甜美女声), serena (温柔女声), ethan (沉稳男声), chelsie (磁性男声)

Workflow#

1. Accept poem text from user (and optional --voice preference)
2. Run poetry_recitation.py with the poem
3. Send the resulting video to user via MEDIA path — no extra confirmation needed

Voice Resolution#

• If --voice matches a local cloned voice name → uses cloned voice model
• If --voice matches a system voice name → uses system voice model
• If not specified → uses first available cloned voice

Output#

Generated video (1920x1080, 24fps, H.264 + AAC) saved to ~/workspace/audio/.