A utility that converts local audio files into the specific format required for native, playable voice messages within the Feishu messaging platform.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install feishu-audio
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install feishu-audio using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Feishu Audio Messenger?
The Feishu Audio Messenger is a specialized tool designed to streamline the process of sending voice content to Feishu users. Because Feishu requires a very specific audio encoding (Opus in an OGG container) for its native playback interface, this skill automates the complex transcoding steps using FFmpeg.
By incorporating this tool into your Openclaw Skills library, you can bridge the gap between generic audio files and enterprise-ready voice notifications. It handles everything from format validation and transcoding to API authentication and message delivery, making it an essential asset for developers building internal communication bots.
Feishu Audio Messenger Use Cases
- Sending automated system alerts as audible voice messages to team members.
- Implementing 'Read Aloud' features for documents by combining TTS engines with Feishu delivery.
- Converting existing voice recordings or meetings into mobile-friendly Feishu voice notes.
- Building custom notification bots that provide a more personal touch than standard text messages.
How Feishu Audio Messenger Works
- The script verifies that FFmpeg is installed and accessible in the system path.
- It checks the source audio file and uses FFmpeg to transcode it into a Feishu-compliant Opus format at 24000 Hz in mono.
- The skill authenticates with the Feishu API using your APP_ID and APP_SECRET to obtain a valid tenant access token.
- It uploads the converted file to Feishu's media servers specifically as an opus file type.
- Finally, it sends an audio message to the designated recipient using their unique Open ID.
Feishu Audio Messenger Setup
System Requirements
Ensure FFmpeg is installed on your machine:
brew install ffmpeg
Environment Variables
Configure your Feishu application credentials as environment variables:
export FEISHU_APP_ID='your_app_id'
export FEISHU_APP_SECRET='your_app_secret'
export FEISHU_RECEIVER='optional_default_receiver_openid'
Basic Usage
Execute the conversion and sending script directly via CLI:
bash scripts/send_audio.sh /path/to/your/audio.mp3 [optional_recipient_openid]
Feishu Audio Messenger Data Schema & Taxonomy
The skill processes audio files and interacts with the Feishu API using the following metadata structure:
| Parameter | Description | Technical Requirement |
|---|---|---|
| Audio Format | Opus (OGG) | Must use libopus codec |
| Sample Rate | 24000 Hz | Fixed for Feishu compatibility |
| Channels | Mono | 1 channel required |
| file_type | Media category | Must be set to opus |
| duration | Audio length | Required for playback UI |
All generated temporary opus files are managed during the script lifecycle to ensure a clean workspace.
Feishu Audio Messenger Advanced Features
- Dynamic TTS integration: Easily pair with edge-tts to generate and send voice messages in a single command pipeline.
- Automated token management: Handles the acquisition and lifecycle of Feishu tenant access tokens.
- Flexible routing: Support for both environment-based default recipients and command-line overrides for specific targeting.
- Error diagnostics: Includes checks for common Feishu API permission issues such as im:message:send_as_bot scopes.
SKILL.md
Loading
Related Openclaw Skills
Git Pushing
An automated git workflow utility that stages changes, generates conventional commits, and pushes code to remote repositories seamlessly.
md2pdf-converter
An offline Markdown to PDF converter featuring full Unicode support, professional layouts, and a massive library of 3660 colorful emojis.
Hugging Face Trends
A specialized tool for discovering and tracking the most popular AI models on Hugging Face by task, framework, and engagement metrics.
Personality Match
An interactive personality assessment tool for AI agents to define their character and test compatibility with human users.
Chinese Chess Game Assistant
A specialized tool for generating new Chinese chess games or enhancing existing ones using pre-built, optimized source code templates.
Arkade Bitcoin & Lightning SDK
A TypeScript SDK for building programmable Bitcoin applications with instant offchain transactions, Lightning support, and atomic stablecoin swaps.
Featured*
