← 返回 Skills 市场
sanwecn

Telegram Offline Voice

作者 sanwe · GitHub ↗ · v0.1.3
linux ⚠ suspicious
3487
总下载
2
收藏
17
当前安装
4
版本数
在 OpenClaw 中安装
/install telegram-offline-voice
功能描述
本地生成 Telegram 语音消息,支持自动清洗、分段与临时文件管理。
安全使用建议
This skill is mostly coherent: it converts text to OGG via edge_tts and ffmpeg and manages temp files correctly. However, the author repeatedly claims "100% local / zero token" while importing and using edge_tts — that library typically obtains TTS audio from Microsoft services (network calls), so the skill may not be truly offline. Before installing or running: 1) Verify edge_tts behavior in your environment (check its docs or run it in a sandbox) to confirm whether audio is generated locally or fetched from the network. 2) If you require strict offline operation, consider replacing edge_tts with a known local TTS engine (Coqui/tts, local OpenTTS endpoint, or local Edge browser invocation) or explicitly audit network traffic. 3) Avoid running curl | sh blindly — the uv install script is optional; prefer installing known packages from distro repos or inspecting the installer first. 4) Run the script in an isolated environment first (container or VM), monitor outbound connections (tcpdump/strace) and review installed Python dependencies (pip show edge-tts) to ensure no unexpected exfiltration. If you cannot confirm edge_tts is purely local, treat the offline claim as inaccurate and proceed with caution.
功能分析
Type: OpenClaw Skill Name: telegram-offline-voice Version: 0.1.3 The skill is classified as suspicious due to the use of `curl -LsSf https://astral.sh/uv/install.sh | sh` in both `SKILL.md` and `README.md` for installing the `uv` dependency. While `uv` is a legitimate tool and its installation is plausible for the skill's stated purpose, this method of executing remote code directly from the internet is a high-risk practice that bypasses integrity checks and introduces a supply chain vulnerability. The core Python script (`scripts/voice_gen.py`) itself appears benign, performing its stated function of text-to-speech and audio conversion using `ffmpeg` without evidence of malicious intent.
能力评估
Purpose & Capability
Name/description promise: local, offline TTS. Implementation: uses the Python package edge_tts (declared in the script header comments and imported in code). edge_tts typically requests audio from Microsoft TTS endpoints (i.e., network calls), so the claim of being fully offline and zero-token may be false or misleading. Other requirements (ffmpeg, Python, optional uv) match the stated purpose.
Instruction Scope
SKILL.md and the script keep scope to converting provided text -> temporary mp3 -> final ogg and printing file paths. The script only reads the supplied --text and writes temp files under outdir (/tmp by default). No instructions to read unrelated files or environment variables. However, runtime will transitively call edge_tts which may make network requests to Microsoft endpoints — the SKILL.md asserts local-only processing but does not document or justify any network usage.
Install Mechanism
No formal install spec (instruction-only), which is lower risk. SKILL.md recommends installing uv with curl | sh from https://astral.sh/ (third-party installer); piping remote scripts to sh is higher risk and should be treated cautiously. The script lists Python dependencies (edge-tts, aiofiles) in header comments but does not provide explicit pip install steps — user must install these. No arbitrary binary downloads or obscure URLs in included files beyond the uv installer suggestion.
Credentials
The skill requests no environment variables or credentials. The script operates entirely on supplied text and local temp files; there are no demanded tokens, keys, or config path access. This is proportionate to its stated functionality — except for the unresolved offline claim noted above.
Persistence & Privilege
The skill is user-invocable only (always: false) and does not request persistent agent-wide privileges or modify other skills. It does not persist credentials or change system-wide settings.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install telegram-offline-voice
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /telegram-offline-voice 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.3
telegram-offline-voice 0.1.3 - 新增 voice_gen.py 脚本,实现自动语音生成、清洗文本、分段和临时文件隔离。 - 自动移除 Markdown 符号、URL、分隔线,避免AI朗读源码“噪音”。 - 支持超长文本智能分句,批量输出 Telegram 原生语音气泡。 - 引入 UUID 隔离机制,提升多用户/多代理并发安全性。 - 文档全面升级,详细介绍新特性与参数用法。
v0.1.2
**Major update: Improved localization, documentation, and offline workflow.** - Switched documentation language from English to Chinese, with greater emphasis on local/offline capabilities. - Updated skill description to clarify no API token is required. - Expanded README/guide with detailed installation, usage, and audio cleaning instructions. - Added full command-line examples for both TTS generation and Telegram voice formatting. - Metadata revised: dependency definition updated and now reflects offline (本地) emphasis. - Enhanced explanation of recommended voices, playback standards, and additional technical details.
v0.1.1
- Added Edge-TTS support, enabling use of Microsoft's premium neural voices for Telegram voice messages. - Updated requirements: now uses edge-tts (pip) and only depends on ffmpeg. - Simplified installation instructions and removed dependency on sherpa-onnx-offline-tts. - Enhanced documentation with new usage examples and a focus on professional assistant personas. - Updated feature list and command-line usage details in documentation.
v0.1.0
Initial release — brings high-quality, offline TTS voice messages to Telegram via Sherpa-ONNX. - 100% offline text-to-speech; no API keys or network required - Speech output tuned for natural, human-like cadence using custom speed and silence settings - Automatically generates OGG/Opus voice messages compatible with Telegram - Integrates with the sherpa-onnx-tts skill and requires a Chinese VITS model
元数据
Slug telegram-offline-voice
版本 0.1.3
许可证
累计安装 17
当前安装数 17
历史版本数 4
常见问题

Telegram Offline Voice 是什么?

本地生成 Telegram 语音消息,支持自动清洗、分段与临时文件管理。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 3487 次。

如何安装 Telegram Offline Voice?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install telegram-offline-voice」即可一键安装,无需额外配置。

Telegram Offline Voice 是免费的吗?

是的,Telegram Offline Voice 完全免费(开源免费),可自由下载、安装和使用。

Telegram Offline Voice 支持哪些平台?

Telegram Offline Voice 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(linux)。

谁开发了 Telegram Offline Voice?

由 sanwe(@sanwecn)开发并维护,当前版本 v0.1.3。

💬 留言讨论