- name
- feishu-voice-send
- description
- 飞书语音消息发送：使用官方 API 上传 OPUS 音频并发送语音消息，解决 OpenClaw 内置发送缺少 duration 参数的问题。| Send voice messages via Feishu official API, fixing OpenClaw's missing duration parameter bug.
- requires
- binaries
- runtime
Feishu Voice Send Skill
功能
通过飞书官方 API 发送语音消息，解决 OpenClaw 内置发送缺少 duration 参数的问题。
核心问题
OpenClaw 内置的飞书媒体发送存在 bug：
uploadFileFeishu缺少duration参数sendFileFeishu发送 audio 消息时 content 缺少duration
飞书官方 API 要求：
- 上传 opus 文件时必须提供
duration（毫秒） - 发送 audio 消息时 content 必须包含
file_key和duration
本 skill 直接调用飞书官方 API，绕过 OpenClaw 内置函数的 bug。
使用方式
方式一：发送现有音频文件
python3 /mnt/d/wslspace/workspace/skills/feishu-voice-send/scripts/send_voice.py <音频文件路径> <接收者open_id>方式二：直接生成 TTS 并发送
python3 /mnt/d/wslspace/workspace/skills/feishu-voice-send/scripts/tts_and_send.py "要转换的文字" <接收者open_id>核心脚本
send_voice.py
直接发送现有的 .ogg 音频文件：
python3 scripts/send_voice.py <ogg文件路径> <open_id>tts_and_send.py
- 用 edge-tts 生成 TTS（mp3）
- 用 ffmpeg 转换为标准 Ogg Opus
- 自动获取 duration
- 调用官方 API 发送语音消息
python3 scripts/tts_and_send.py "文字内容" <open_id> [-v voice] [-r rate]参数：
文字内容（必须）：要转换的文字open_id（必须）：接收者飞书 open_id-v voice：TTS 音色，默认 zh-CN-YunjianNeural-r rate：语速，默认 -10%（即90%速度）
示例
发送音频文件
python3 scripts/send_voice.py /path/to/audio.ogg <接收者open_id>发送 TTS 语音
python3 scripts/tts_and_send.py "你好，这是语音测试。" <接收者open_id>使用不同音色和语速
python3 scripts/tts_and_send.py "Hello world" <接收者open_id> -v en-US-EmmaNeural -r 0技术说明
关键问题
OpenClaw 内置的飞书媒体发送存在 bug：
uploadFileFeishu缺少duration参数sendFileFeishu发送 audio 消息时 content 缺少duration
飞书官方 API 要求：
- 上传 opus 文件时必须提供
duration（毫秒） - 发送 audio 消息时 content 必须包含
file_key和duration
解决方案
直接调用飞书官方 API，不走 OpenClaw 内置函数：
- 获取 tenant_access_token
- 上传 opus 文件（带 duration）
- 发送 audio 类型消息（content 包含 file_key 和 duration）
依赖
- Python 3
- requests
- ffprobe（ffmpeg 的一部分）
- edge-tts（通过 uvx 运行）
凭证配置
脚本从以下途径获取飞书凭证（优先级从高到低）：
方式一：环境变量（推荐）
设置环境变量，最灵活：
# 在终端中设置
export APP_ID="cli_xxxxxxxxxxxxxx"
export APP_SECRET="xxxxxxxxxxxxxxxxxxxxxxxx"
# 或直接运行
APP_ID="cli_xxxxxxxxxxxxxx" APP_SECRET="xxxxxxxx" python3 scripts/send_voice.py ...方式二：OpenClaw 配置（自动）
如果脚本在 OpenClaw 环境下运行，会自动从 ~/.openclaw/openclaw.json 读取 main 账号的凭证。
方式三：手动修改脚本
如果以上方式都不适用，可以直接在脚本开头修改：
APP_ID = "cli_xxxxxxxxxxxxxx"
APP_SECRET = "xxxxxxxxxxxxxxxxxxxxxxxx"注意：方式三会随 skill 更新丢失，不推荐。
获取飞书应用凭证
- 前往 飞书开放平台 创建应用
- 获取应用的
App ID和App Secret - 配置应用权限（需要
im:message相关权限） - 将机器人添加到飞书群或与用户单聊