Feishu Voice Tts

飞书语音 TTS 技能

当用户要求"给飞书发语音"、"在飞书里读这段话"或类似需求时，执行以下流程：

核心流程 MOSS-TTS 生成 WAV → 2. ffmpeg 转 opus → 3. 上传飞书 → 4. 发送语音消息 前置要求 系统已安装 ffmpeg 已配置环境变量 MOSS_API_KEY（MOSS-TTS API Key） 飞书配置在 OpenClaw 安装时已自动完成 使用方法 命令行模式 # 基本用法 python scripts/feishu_tts.py --text "要发送的文本" --chat_id "飞书群ID"

# 指定音色 python scripts/feishu_tts.py --text "文本" --voice_id "音色ID" --chat_id "群ID"

# 发送给个人（需要 open_id） python scripts/feishu_tts.py --text "文本" --接收_id "用户open_id" --接收_id_type "open_id"

参数说明 参数 必填 说明 --text ✅ 要转语音的文本 --chat_id ❌ 飞书群 ID（与 接收_id 二选一） --接收_id ❌ 接收者 ID（open_id 或 chat_id） --接收_id_type ❌ 接收者类型：chat_id 或 open_id，默认 chat_id --voice_id ❌ MOSS 音色 ID，默认 2001286865130360832（周周） --输出 ❌ 输出文件路径，默认 feishu_voice.wav 示例 # 给飞书群发语音 python scripts/feishu_tts.py --text "你好，我是 AI 助手" --chat_id "oc_xxx"

# 给指定用户发语音 python scripts/feishu_tts.py --text "你好" --接收_id "ou_xxx" --接收_id_type "open_id"

飞书权限要求

确保飞书应用已开通以下权限：

im:message:发送_as_机器人 - 以机器人身份发送消息 drive:file:上传 - 上传文件（发送语音消息必需） im:message.group:readonly - 读取群组消息（获取历史记录必需） im:chat:readonly - 读取会话列表

注意：需要在飞书开放平台应用配置中添加 drive:file:上传 权限并发布。

获取消息历史 脚本：获取_历史.py

获取飞书群消息历史，按时间排序。

# 获取最近 24 小时的消息 python scripts/获取_历史.py --chat_id "oc_xxx"

# 获取最近 1 小时的消息 python scripts/获取_历史.py --chat_id "oc_xxx" --hours 1

# 获取所有消息 python scripts/获取_历史.py --chat_id "oc_xxx" --all

# 只显示 audio 类型的消息 python scripts/获取_历史.py --chat_id "oc_xxx" --type audio

# 显示最近 10 条 python scripts/获取_历史.py --chat_id "oc_xxx" --limit 10

参数说明 参数 必填 说明 --chat_id ✅ 飞书群 ID --hours ❌ 获取最近几小时的消息，默认 24 --all ❌ 获取所有消息（不使用时间过滤） --limit ❌ 显示最近多少条消息，默认 30 --type ❌ 只显示指定类型的消息，如 audio, file, text, image 环境变量

需要设置飞书应用认证：

FEISHU_应用_ID=你的应用ID FEISHU_应用_SECRET=你的应用密钥