← Back to Skills Marketplace
3109
Downloads
0
Stars
9
Active Installs
6
Versions
Install in OpenClaw
/install telegram-voice-group
Description
向指定 Telegram 群组发送语音消息
Usage Guidance
This skill appears to implement what it claims (generate TTS, convert with ffmpeg, and send to Telegram), but there are several concerns you should address before installing or enabling it: 1) Do not blindly grant the OpenClaw bot broad admin permissions (ban/add-admins/delete). For sending voice messages, send permissions/media are enough; avoid add-admins/ban/restrict unless you fully trust the bot. 2) The index.js has a bug extracting the group ID from a session key (it uses the wrong split index) — test that group/thread addressing works and correct the code (use the correct segment index). 3) The code invokes shell commands via child_process.exec with user-provided text; this can enable command injection. Prefer execFile/spawn with argument arrays or properly escape/sanitize input. 4) The docs suggest optional web aggregation (Reddit/Twitter) and extra CLIs — if you enable those flows, be aware the skill could collect external content and post it to your groups; only enable such integrations when you understand and trust them. 5) Verify that '@openclaw/core' messaging functions behave as expected in your environment and that temporary files are handled securely. If you are uncomfortable with these issues, test the skill in an isolated environment first, or request a corrected version that fixes the groupId parsing and avoids shell interpolation of unsanitized input.
Capability Analysis
Type: OpenClaw Skill
Name: telegram-voice-group
Version: 0.1.5
The skill is classified as suspicious primarily due to the excessive administrative permissions recommended for the Telegram bot in SKILL.md and README.md (e.g., 'Restrict Members', 'Ban Members', 'Add Admins'). While the skill's code does not directly utilize these permissions, instructing users to grant them creates a significant security risk for the bot account if compromised. Additionally, the `send_telegram_voice.js` utility script contains a potential command injection vulnerability in its `node -e` call, where user-controlled variables are directly interpolated into a JavaScript string, which could lead to arbitrary code execution if the script's inputs are maliciously crafted.
Capability Assessment
Purpose & Capability
The declared binaries (edge-tts and ffmpeg) and the included code align with sending TTS voice messages to Telegram groups. However the documentation recommends granting the bot broad admin permissions (Delete, Restrict, Ban, Add Admins) that are disproportionate to the stated function of sending voice messages. USE_CASES also describes web aggregation (Reddit/Twitter via web_fetch and bird CLI) which is not represented in required binaries or env vars — this is scope creep.
Instruction Scope
Runtime instructions and code are focused on generating TTS, converting to OGG/Opus, and sending via @openclaw/core message APIs. Problems: (1) index.js incorrectly extracts the group ID from a full session key (split index is wrong), which will break or misaddress messages; (2) the code uses child_process.exec with interpolated text (insufficient escaping), which can lead to shell injection if untrusted input is passed; (3) docs and USE_CASES suggest fetching and summarizing external web content (Reddit/Twitter) and running additional CLIs, though these tools are not declared as required — that capability could be used to aggregate and post external content to Telegram and represents scope expansion beyond the simple send-voice use case.
Install Mechanism
There is no install spec (instruction-only), which minimizes download risk. The package includes JS and a bash script but does not request external downloads. It does require the runtime availability of '@openclaw/core' (not listed in package.json deps) and the system binaries edge-tts and ffmpeg.
Credentials
The skill requests no environment credentials (which is appropriate), but the documentation instructs operators to give the OpenClaw bot elevated Telegram admin permissions (including banning and adding admins). Those elevated permissions are not necessary merely to send voice messages and enlarge the operational blast radius of the bot if misused. No other env vars or secrets are requested, which is reasonable.
Persistence & Privilege
The skill does not set always:true and does not modify other skills or system-wide settings. Autonomous model invocation is allowed by default (expected). The only persistent privilege recommendation is in the docs asking for broad Telegram admin rights for the bot — this is an external permission request rather than skill installation behavior, but it is noteworthy.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install telegram-voice-group - After installation, invoke the skill by name or use
/telegram-voice-group - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.5
Initial public release with documentation and implementation.
- Added core implementation files: index.js and send_telegram_voice.js
- Provided full usage, API, feature, dependency, and use case documentation (README.md, FEATURES.md, USE_CASES.md, DEPENDENCIES.md, TELEGRAM_TOPICS.md)
- Introduced skill for sending TTS voice messages to specific Telegram group topics with context isolation
- Integrated message text cleanup and audio conversion to Telegram-compatible format
- Included installation and group setup instructions for Telegram
v0.1.4
- 移除了所有代码文件和文档(包括 DEPENDENCIES.md、README.md、index.js 等),保留仅有 SKILL.md。
- 技能现在只包含功能和说明文档,暂无代码实现或依赖描述。
- 文档和使用说明未做内容更新,现作为纯文档技能存在。
v0.1.3
- 简化了描述,明确强调可以用 Telegram 群组话题功能隔离上下文、替代 Discord。
- 精简了开头说明及部分功能介绍,使说明更直接明了。
- 其余功能、用法和详细说明保持一致,未修改使用流程和参数细节。
- 无新功能,仅文档描述优化和简化。
v0.1.2
Version 0.1.2 of telegram-voice-group
- No file changes detected in this release.
- Functionality and documentation remain unchanged.
v0.1.1
## telegram-voice-group v0.1.1
- Updated documentation in README.md for improved clarity.
- No code changes; only documentation files were modified.
v0.1.0
Initial release of telegram-voice-group.
- Send voice messages to specified Telegram group topics
- Generates high-quality Chinese speech using Microsoft Edge-TTS
- Converts audio to Telegram-compatible voice bubble format
- Supports per-topic session isolation for independent conversation context
- Provides configuration and usage guides for group/topic setup and integration
- Automatically cleans Markdown, URLs, and special symbols from voice content before speech synthesis
- Requires edge-tts and ffmpeg binaries
Metadata
Frequently Asked Questions
What is Telegram Voice Group?
向指定 Telegram 群组发送语音消息. It is an AI Agent Skill for Claude Code / OpenClaw, with 3109 downloads so far.
How do I install Telegram Voice Group?
Run "/install telegram-voice-group" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Telegram Voice Group free?
Yes, Telegram Voice Group is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Telegram Voice Group support?
Telegram Voice Group is cross-platform and runs anywhere OpenClaw / Claude Code is available (linux).
Who created Telegram Voice Group?
It is built and maintained by sanwe (@sanwecn); the current version is v0.1.5.
More Skills