feishu-voice-skill

What This Skill Does

The feishu-voice-skill is a specialized utility designed to empower OpenClaw AI agents to communicate with users on Feishu (Lark) using authentic, playable voice messages. Unlike standard file attachments that require users to open a player, this skill generates high-quality speech via NoizAI TTS and processes the output into the OPUS format, enabling native 'tap-to-play' voice notes directly within the Feishu chat interface. It acts as a bridge between powerful AI generation and corporate messaging platforms.

Installation

To integrate this capability into your agent, use the OpenClaw command-line interface. Ensure you have FFmpeg installed on your system, as it is a critical dependency for audio transcoding. Run the following command in your terminal:

clawhub install openclaw/skills/skills/anightmare2/feishu-voice-skill

After installation, you must configure your environment variables by exporting your FEISHU_APP_ID, FEISHU_APP_SECRET, and a base64-encoded NOIZ_API_KEY. Without these credentials, the agent will be unable to authenticate with the Feishu API or generate synthetic speech.

Use Cases

This skill is highly versatile for automation-heavy workflows. Use it for personalized morning or evening greetings to build rapport, automated daily weather or stock market briefings that users can listen to on the go, or narrating bedtime stories. It is also exceptional for critical notifications, ensuring that urgent alerts are delivered as distinct voice messages rather than easily ignored text snippets, thus increasing the visibility and urgency of the information.

Example Prompts

• "Send a gentle morning greeting as a voice message to the team channel expressing hope for a productive day."
• "Convert the latest weather forecast for Shanghai into an upbeat voice note and send it to the daily-briefing chat."
• "Take the content of story.txt, set the speed to 0.9 for a calmer tone, and send it as a voice message to my personal workspace."

Tips & Limitations

To maintain high-quality output, ensure your input text is clear and avoids excessive abbreviations that might confuse the TTS engine. Note that the skill relies on external API calls to NoizAI and the Feishu platform; therefore, stable internet connectivity is required. Always monitor your API usage limits on the NoizAI developer portal. For long-form content, be aware of the character limits imposed by the TTS API; for very long text, consider splitting your message into smaller, logical segments to ensure smooth delivery.