Feishu Voice — ListenHub TTS#

Send high-quality Chinese voice messages on Feishu using ListenHub's TTS engine.

Prerequisites#

• ffmpeg / ffprobe
• curl, python3
• ListenHub API key (get from https://listenhub.ai/settings/api-keys)
• Feishu app with im:message:send_as_bot and im:file permissions

Environment Variables#

VariableRequiredDescriptionLISTENHUB_API_KEY✅ListenHub API key ( lh_sk_...)FEISHU_APP_ID✅Feishu app IDFEISHU_APP_SECRET✅Feishu app secretLISTENHUB_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:

bash

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#

bash

scripts/feishu-voice-send.sh <text> <receive_id> [receive_id_type] [speaker_id]

• receive_id: target user open_id or chat_id
• receive_id_type: open_id (default) or chat_id
• speaker_id: override default speaker for this message

Listing Available Speakers#

bash

scripts/list-speakers.sh [language]

Examples:

bash

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 IDNameGenderStylechat-girl-105-cn晓曼female日常对话gaoqing3-bfb5c88a高晴female标准女声xiaoyun若云female温柔女声xinyi6诗涵female温柔女声ASMR-Female-CN宛星femaleASMR 风格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 不可用于飞书