telegram-voice-group

What This Skill Does

The telegram-voice-group skill enables OpenClaw AI agents to synthesize high-quality Chinese voice messages and broadcast them directly to specific Telegram group topics. By leveraging the Microsoft Edge-TTS engine, this skill provides human-like, expressive voice output that is perfectly formatted for Telegram's native voice playback. Its core value lies in its ability to utilize Telegram's 'Topics' feature to maintain strict context isolation. Each topic acts as a separate thread, preventing cross-talk between different project discussions or user interactions within a single group, making it a robust alternative to Discord channels for team communication.

Installation

To install this skill, use the ClawHub command line interface. Ensure you have ffmpeg installed on your system, as it is required for handling audio format conversions. Run the following command in your terminal: clawhub install openclaw/skills/skills/sanwecn/telegram-voice-group Once installed, you must ensure your OpenClaw Bot has the necessary administrative permissions in the target Telegram group, including the ability to send media and manage group topics. Obtain the Group ID and the relevant Topic ID (thread identifier) from your Telegram interface to begin configuration.

Use Cases

This skill is ideal for teams and communities that rely on Telegram for project management or automated notifications. Use it to send daily progress summaries, voice alerts for emergency monitoring, or to provide an interactive, conversational interface for group members. It effectively turns a standard Telegram group into a sophisticated voice-enabled information hub.

Example Prompts

1. "向 agent:main:telegram:group:123456:topic:789 发送语音: 各位成员注意，目前的生产环境部署已顺利完成，请查阅相关文档并开始测试。"
2. "使用语音播报一下当前服务器的状态，发送到开发讨论话题：agent:main:telegram:group:123456:topic:101"
3. "向 agent:main:telegram:group:888:topic:222 发送语音: 大家好，我是AI助理，今天我们的会议议程已经更新，请关注群组公告。"

Tips & Limitations

• Context Isolation: Always use the specific format agent:main:telegram:group:{groupId}:topic:{threadId} to ensure the agent maintains the correct session history for that specific topic.
• Voice Quality: You can adjust the rate and voice parameters in your function calls to fine-tune the speed and gender/accent of the TTS model.
• Prerequisites: Ensure ffmpeg is correctly configured in your system PATH to avoid audio file encoding errors.
• Permissions: The bot must be promoted to an admin in the group; otherwise, the Telegram API may reject voice media upload requests.