How do I install the Feishu Voice skill?

Run npx skillmds@latest add knownasnaffy/feishu-voice-8 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 Voice 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 Voice?

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 Voice free to use?

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

Who published Feishu Voice?

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

Feishu Voice by knownasnaffy — Agent Skill

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

Feishu Voice

Send and receive voice messages on Feishu (Lark) using ElevenLabs TTS and STT. Activate when user asks to send a voice message on Feishu, or when receiving a Feishu audio message (media attachment with .ogg/.opus file) that needs transcription. Supports smart reply mode — auto voice-reply to voice messages, text-reply to text messages.

knownasnaffy Updated Sep 22, 2026 0 repo stars

File contents

Security Tests

Includes tests that verify dangerous inputs are properly rejected:

Command injection attempts are blocked
Path traversal is detected and denied
SQL injection patterns are sanitized

Test payloads in tests/test_security.py are for validation only.

Feishu Voice (TTS + STT)

Send voice messages and transcribe received voice messages on Feishu using ElevenLabs.

Prerequisites

sag CLI (ElevenLabs TTS): npm i -g sag or go install
ffmpeg / ffprobe: brew install ffmpeg
ElevenLabs paid plan (required for library voices)
Feishu app with im:message:send_as_bot and im:file permissions

Environment Variables

Variable	Required	Description
`ELEVENLABS_API_KEY`	✅	ElevenLabs API key
`FEISHU_APP_ID`	✅ (TTS)	Feishu app ID
`FEISHU_APP_SECRET`	✅ (TTS)	Feishu app secret
`ELEVENLABS_VOICE_ID`	✅ (TTS)	Voice ID (browse at elevenlabs.io/voice-library)
`ELEVENLABS_MODEL_ID`	✅ (TTS)	Model ID (e.g. `eleven_multilingual_v2`, `eleven_v3`)
`ELEVENLABS_SPEED`	❌	Speech speed 0.5-2.0 (default: 1.0)

If FEISHU_APP_ID / FEISHU_APP_SECRET are not in env, extract from openclaw config:

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'])")

Voice Selection

See config/voice-config.example.json for a curated voice list. Browse all voices at https://elevenlabs.io/voice-library or run sag voices.

Recommended models:

eleven_multilingual_v2 — best for Chinese and multilingual content
eleven_v3 — latest English-optimized model

Sending Voice Messages (TTS)

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

receive_id: target user open_id or chat_id
receive_id_type: open_id (default) or chat_id
speed: speech speed multiplier, 0.5-2.0 (default: 1.0)

Receiving Voice Messages (STT)

When OpenClaw delivers a Feishu voice message, it arrives as a media attachment (.ogg file). Transcribe with:

scripts/feishu-voice-stt.sh /path/to/audio.ogg

Returns recognized text to stdout. Uses ElevenLabs scribe_v1 model with automatic language detection.

Fallback: Download via Feishu API

If the audio file is not delivered as an attachment (only file_key available):

List recent messages: GET /im/v1/messages?container_id_type=chat&container_id=CHAT_ID&page_size=5&sort_type=ByCreateTimeDesc
Download audio: GET /im/v1/messages/{message_id}/resources/{file_key}?type=file
Run STT script on the downloaded file

Smart Reply Mode

When receiving messages, follow this pattern for natural conversation:

Voice message received → transcribe with STT → understand → reply with voice (TTS)
Text message received → understand → reply with text
Override: user can request voice/text reply explicitly

Important Notes

Feishu msg_type must be "audio" — not "media" or "file"
OpenClaw's message tool asVoice does not work correctly for Feishu — use this script instead
STT uses ElevenLabs scribe_v1 model, supports Chinese, English, and 90+ languages
For free ElevenLabs accounts, only premade voices work; library voices require a paid plan

---name: feishu-voice-8description: Send and receive voice messages on Feishu (Lark) using ElevenLabs TTS and STT. Activate when user asks to send a voice message on Feishu, or when receiving a Feishu audio message (media attachment with .ogg/.opus file) that needs transcription. Supports smart reply mode — auto voice-reply to voice messages, text-reply to text messages.---## Security TestsIncludes tests that verify dangerous inputs are properly rejected:- Command injection attempts are blocked- Path traversal is detected and denied- SQL injection patterns are sanitizedTest payloads in `tests/test_security.py` are for validation only.# Feishu Voice (TTS + STT)Send voice messages and transcribe received voice messages on Feishu using ElevenLabs.## Prerequisites- `sag` CLI (ElevenLabs TTS): `npm i -g sag` or `go install`- `ffmpeg` / `ffprobe`: `brew install ffmpeg`- ElevenLabs paid plan (required for library voices)- Feishu app with `im:message:send_as_bot` and `im:file` permissions## Environment Variables| Variable | Required | Description ||---|---|---|| `ELEVENLABS_API_KEY` | ✅ | ElevenLabs API key || `FEISHU_APP_ID` | ✅ (TTS) | Feishu app ID || `FEISHU_APP_SECRET` | ✅ (TTS) | Feishu app secret || `ELEVENLABS_VOICE_ID` | ✅ (TTS) | Voice ID (browse at elevenlabs.io/voice-library) || `ELEVENLABS_MODEL_ID` | ✅ (TTS) | Model ID (e.g. `eleven_multilingual_v2`, `eleven_v3`) || `ELEVENLABS_SPEED` | ❌ | Speech speed 0.5-2.0 (default: 1.0) |If `FEISHU_APP_ID` / `FEISHU_APP_SECRET` are not in env, extract from openclaw config:```bashexport 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'])")```## Voice SelectionSee `config/voice-config.example.json` for a curated voice list. Browse all voices at https://elevenlabs.io/voice-library or run `sag voices`.Recommended models:- `eleven_multilingual_v2` — best for Chinese and multilingual content- `eleven_v3` — latest English-optimized model## Sending Voice Messages (TTS)```bashscripts/feishu-voice-send.sh <text> <receive_id> [receive_id_type] [speed]```- `receive_id`: target user `open_id` or `chat_id`- `receive_id_type`: `open_id` (default) or `chat_id`- `speed`: speech speed multiplier, 0.5-2.0 (default: 1.0)## Receiving Voice Messages (STT)When OpenClaw delivers a Feishu voice message, it arrives as a media attachment (`.ogg` file). Transcribe with:```bashscripts/feishu-voice-stt.sh /path/to/audio.ogg```Returns recognized text to stdout. Uses ElevenLabs `scribe_v1` model with automatic language detection.### Fallback: Download via Feishu APIIf the audio file is not delivered as an attachment (only `file_key` available):1. List recent messages: `GET /im/v1/messages?container_id_type=chat&container_id=CHAT_ID&page_size=5&sort_type=ByCreateTimeDesc`2. Download audio: `GET /im/v1/messages/{message_id}/resources/{file_key}?type=file`3. Run STT script on the downloaded file## Smart Reply ModeWhen receiving messages, follow this pattern for natural conversation:- **Voice message received** → transcribe with STT → understand → reply with voice (TTS)- **Text message received** → understand → reply with text- Override: user can request voice/text reply explicitly## Important Notes- Feishu `msg_type` must be `"audio"` — not `"media"` or `"file"`- OpenClaw's `message` tool `asVoice` does not work correctly for Feishu — use this script instead- STT uses ElevenLabs `scribe_v1` model, supports Chinese, English, and 90+ languages- For free ElevenLabs accounts, only premade voices work; library voices require a paid plan

Frequently asked questions