How do I install the Feishu Audio skill?

Run npx skillmds@latest add knownasnaffy/feishu-audio-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Feishu Audio safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Feishu Audio?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Feishu Audio free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Feishu Audio?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Feishu Audio by knownasnaffy — Agent Skill

Name: Feishu Audio
Rating: 4.2 (5 reviews)
Author: knownasnaffy

Feishu Audio

Send TTS audio as a proper playable audio message (not file attachment) to Feishu chats. Use when asked to send voice messages, TTS audio, speech announcements, or 语音报数 (voice roll calls) to a Feishu group or user. Activates on requests like "send voice message to Feishu", "TTS to Feishu chat", "语音发送", "语音报数", or any task combining text-to-speech with Feishu messaging.

knownasnaffy Updated Sep 22, 2026 0 repo stars

File contents

feishu-audio

Send TTS audio to Feishu as a playable audio message (msg_type=audio), not a file attachment.

Why This Skill Exists

OpenClaw's message tool sends audio as a generic file. Feishu requires a two-step API flow to display it as a playable voice message:

Upload with file_type=opus
Send with msg_type=audio

Quick Usage

bash /root/.openclaw/skills/feishu-audio/scripts/send_audio.sh \
  "要说的内容" \
  "<chat_id or user open_id>" \
  [voice]          # optional, default: zh-CN-XiaoyiNeural

receive_id_type is always chat_id. For group chats use oc_xxx; for DMs use ou_xxx (open_id).

Common Voices

Language	Voice
Chinese (F)	`zh-CN-XiaoyiNeural` (default)
Chinese (M)	`zh-CN-YunxiNeural`
English (F)	`en-US-AriaNeural`
English (M)	`en-US-GuyNeural`

Credentials

Auto-read from /root/.openclaw/openclaw.json → channels.feishu.accounts.main. No manual setup needed in standard OpenClaw deployments.

Two-Step API Flow (for custom integrations)

# Step 1: Upload (file_type=opus is required regardless of actual format)
curl -X POST "https://open.feishu.cn/open-apis/im/v1/files" \
  -H "Authorization: Bearer $TOKEN" \
  -F "file_type=opus" -F "file_name=voice.opus" -F "file=@audio.mp3"
# → returns file_key

# Step 2: Send (msg_type=audio, NOT file)
curl -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=chat_id" \
  -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \
  -d '{"receive_id":"oc_xxx","msg_type":"audio","content":"{\"file_key\":\"...\"}"}'

Key pitfalls:

file_type must be opus (not mp3) or upload returns 234001
msg_type must be audio (not file) or it shows as attachment

---name: feishu-audio-3description: Send TTS audio as a proper playable audio message (not file attachment) to Feishu chats. Use when asked to send voice messages, TTS audio, speech announcements, or 语音报数 (voice roll calls) to a Feishu group or user. Activates on requests like "send voice message to Feishu", "TTS to Feishu chat", "语音发送", "语音报数", or any task combining text-to-speech with Feishu messaging.---# feishu-audioSend TTS audio to Feishu as a playable audio message (msg_type=audio), not a file attachment.## Why This Skill ExistsOpenClaw's `message` tool sends audio as a generic file. Feishu requires a two-step API flow to display it as a playable voice message:1. Upload with `file_type=opus`2. Send with `msg_type=audio`## Quick Usage```bashbash /root/.openclaw/skills/feishu-audio/scripts/send_audio.sh \ "要说的内容" \ "<chat_id or user open_id>" \ [voice] # optional, default: zh-CN-XiaoyiNeural```**receive_id_type** is always `chat_id`. For group chats use `oc_xxx`; for DMs use `ou_xxx` (open_id).### Common Voices| Language | Voice ||----------|-------|| Chinese (F) | `zh-CN-XiaoyiNeural` (default) || Chinese (M) | `zh-CN-YunxiNeural` || English (F) | `en-US-AriaNeural` || English (M) | `en-US-GuyNeural` |## CredentialsAuto-read from `/root/.openclaw/openclaw.json` → `channels.feishu.accounts.main`. No manual setup needed in standard OpenClaw deployments.## Two-Step API Flow (for custom integrations)```bash# Step 1: Upload (file_type=opus is required regardless of actual format)curl -X POST "https://open.feishu.cn/open-apis/im/v1/files" \ -H "Authorization: Bearer $TOKEN" \ -F "file_type=opus" -F "file_name=voice.opus" -F "file=@audio.mp3"# → returns file_key# Step 2: Send (msg_type=audio, NOT file)curl -X POST "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=chat_id" \ -H "Authorization: Bearer $TOKEN" -H "Content-Type: application/json" \ -d '{"receive_id":"oc_xxx","msg_type":"audio","content":"{\"file_key\":\"...\"}"}' ```**Key pitfalls:**- `file_type` must be `opus` (not `mp3`) or upload returns 234001- `msg_type` must be `audio` (not `file`) or it shows as attachment

Frequently asked questions