OpenSkillIndex← back to search
claude-code

Skills feishu-voice-send

飞书语音消息发送：使用官方 API 上传 OPUS 音频并发送语音消息，解决 OpenClaw 内置发送缺少 duration 参数的问题。| Send voice messages via Feishu official API, fixing OpenClaw's missing duration parameter bug.

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/54meteor/feishu-voice-api-sender" ~/.claude/skills/clawdbot-skills-feishu-voice-send && rm -rf "$T"
manifest: skills/54meteor/feishu-voice-api-sender/SKILL.md
source content

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

  1. 用 edge-tts 生成 TTS（mp3）
  2. 用 ffmpeg 转换为标准 Ogg Opus
  3. 自动获取 duration
  4. 调用官方 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 内置函数：

  1. 获取 tenant_access_token
  2. 上传 opus 文件（带 duration）
  3. 发送 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 更新丢失，不推荐。

获取飞书应用凭证

  1. 前往 飞书开放平台 创建应用
  2. 获取应用的 
    App ID
    和 
    App Secret
  3. 配置应用权限（需要 
    im:message
    相关权限）
  4. 将机器人添加到飞书群或与用户单聊