Feishu Voice — ListenHub TTS
Send high-quality Chinese voice messages on Feishu using ListenHub's TTS engine.
Prerequisites
ffmpeg/ffprobecurl,python3- ListenHub API key (get from https://listenhub.ai/settings/api-keys)
- Feishu app with
im:message:send_as_botandim:filepermissions
Environment Variables
| Variable | Required | Description |
|---|---|---|
LISTENHUB_API_KEY | ✅ | ListenHub API key (lh_sk_...) |
FEISHU_APP_ID | ✅ | Feishu app ID |
FEISHU_APP_SECRET | ✅ | Feishu app secret |
LISTENHUB_SPEAKER_ID | ❌ | Default speaker (default: chat-girl-105-cn) |
LISTENHUB_LANGUAGE | ❌ | Language: zh or en (default: zh) |
LISTENHUB_TTS_MODE | ❌ | Mode: direct or smart (default: direct) |
If FEISHU_APP_ID / FEISHU_APP_SECRET are not in env, extract from openclaw config:
export FEISHU_APP_ID=$(python3 -c "import json; print(json.load(open('$HOME/.openclaw/openclaw.json'))['channels']['feishu']['appId'])")
export FEISHU_APP_SECRET=$(python3 -c "import json; print(json.load(open('$HOME/.openclaw/openclaw.json'))['channels']['feishu']['appSecret'])")
Sending Voice Messages
scripts/feishu-voice-send.sh <text> <receive_id> [receive_id_type] [speaker_id]
receive_id: target useropen_idorchat_idreceive_id_type:open_id(default) orchat_idspeaker_id: override default speaker for this message
Listing Available Speakers
scripts/list-speakers.sh [language]
Examples:
scripts/list-speakers.sh zh # Chinese voices only
scripts/list-speakers.sh en # English voices only
scripts/list-speakers.sh # All voices
Popular Chinese Speakers
| Speaker ID | Name | Gender | Style |
|---|---|---|---|
chat-girl-105-cn | 晓曼 | female | 日常对话 |
gaoqing3-bfb5c88a | 高晴 | female | 标准女声 |
xiaoyun | 若云 | female | 温柔女声 |
xinyi6 | 诗涵 | female | 温柔女声 |
ASMR-Female-CN | 宛星 | female | ASMR 风格 |
suzhe-45bbbe54 | 苏哲 | male | 标准男声 |
CN-Man-Beijing-V2 | 原野 | male | 北京腔 |
pingshu-c7c18f5a | 古今先生 | male | 评书风格 |
TTS Modes
direct— 原样朗读文本，不做修改（推荐日常用）smart— AI 优化文本后再朗读（适合粗稿）
Important Notes
- ListenHub TTS 是异步的，脚本会自动轮询等待（最长 60 秒）
- 生成的音频自动转为 opus 格式发送到飞书
- 中文语音质量非常高，特别是对话和叙事场景
msg_type必须是"audio"，OpenClaw 的asVoice不可用于飞书