AlphaMoatによると、2026-09時点でTelegram Offline Voiceのダウンロード数は4,710、スター数は2で、AIスキル全体5,078件中2,016位、デザイン・メディアでは512件中197位です。

インストール数

149

ダウンロード数

4710

スター数

総合順位

#2,016

全体の上位 40% · デザイン・メディアの上位 39%

プラットフォーム	インストール数	ダウンロード数	スター数	コメント
ClawHub ↗	149	4378	2	-
SkillHub ↗	149	4710	2	—

プラットフォームごとに集計方法と集計時点が異なります。

このスキルでできること

Microsoft Edge-TTSで中国語音声を生成し、長いテキストを句読点で分割してMP3/OGGファイルに変換します。資料はローカル生成と説明していますが、同時にEdge-TTSを指定しています。ネットワーク動作に関する独立した検証は含まれていないため、機密テキストを処理する前に実際のデータ経路を確認してください。音声ファイルを生成する機能であり、Telegramメッセージを自動送信するとは限りません。一時出力先と音声設定を指定できます。記載の環境は Linux で、ラッパーには ffmpeg と uv が必要です。

資料公開日 2026-10-29

できること

読み上げ用テキストを音声ファイルに変換する
Markdown記号やURLを除去して分割音声を生成する
音声、読み上げ速度、一時出力先を調整する

使う場面

テキストからTelegram互換の音声ファイルを作るとき
依存関係を準備し、テキスト処理とネットワーク動作がプライバシー要件を満たすと確認したとき

プロンプト例

スキルのドキュメントをもとに生成した例であり、実際の実行結果ではありません。

このテキストがどのように整形され音声に変換されるか、確認すべきプライバシー上の点を説明してください。TTS実行、ファイル生成、Telegram送信は行わないでください。

月次の推移

ダウンロード数4710

スター数2

2026-09 から集計方法を変更し、同名スキルを作者ごとに分けて集計し、全スキルを対象にしました。破線は変更前の月で、変更後のデータとは直接比較せず、変更をまたぐ増減も計算していません。

月	ダウンロード数	前月比	スター数
2026-09	4710	—	2
2026-08	4339	+3.0%	2
2026-07	4211	+5.8%	2
2026-06	3980	+3.6%	2
2026-05	3841	—	2

SKILL.md 原文

作者が公開した元のファイルをテキストのまま表示しています。AlphaMoat による編集や審査はしていません。リンクはクリックできません。コマンドは内容を確認してから実行してください。取得日 2026-10-23。

2.8 KB・ClawHub v0.1.3

---
name: telegram-offline-voice
description: 本地生成 Telegram 语音消息，支持自动清洗、分段与临时文件管理。
metadata: {"openclaw":{"emoji":"🎙️","os":["linux"],"requires":{"bins":["ffmpeg","uv"]}}}
---

# telegram-offline-voice 🎙️

**本地生成，一键封装** — 使用 Microsoft Edge-TTS 生成高质量中文语音，完全离线处理。

すべて表示(全 67 行)

## 💡 为什么需要这个升级？

原生的 TTS 方案通常只能生成 MP3 附件，且无法处理 Markdown 标记和超长文本。本项目通过工程化封装，将“语音合成”进化为“语音交互”：

- **告别标记音**：自动识别并清洗 `**`, `#`, `[link]` 等 Markdown 符号，避免 AI 读出这些“代码噪音”。
- **智能对话流**：超长文本不再是一读到底，而是按句号、感叹号自动切分为多个语音气泡，听感更像真人在发语音。
- **并发安全**：针对多代理/子代理并行调用的场景，使用 UUID 隔离临时文件，彻底杜绝文件读写冲突。
- **零token消耗**：完全基于 Edge-TTS 本地生成，无需 OpenAI/Azure 的付费 Token。

## ✨ 特性

- 🔒 **隐私保护**：100% 本地音频处理，不经过任何额外云端 TTS 提供商。
- 💰 **零token消耗**：使用免费的 Edge-TTS 引擎，省下昂贵的 API 额度。
- 🎯 **一键生成**：内置 `voice_gen.py` 脚本，自动完成“文本->MP3->OGG”的全过程。
- 🧹 **自动清洗**：自动剔除 Markdown 符号和 URL 链接，让朗读更自然。
- ✂️ **智能分段**：超长文本自动按标点符号切分为多个语音气泡。
- 🛡️ **安全并发**：使用 UUID 命名临时文件，支持多代理同时调用。

## 🛠️ 安装依赖

```bash
# 需要 Python 环境和 FFmpeg
sudo apt update && sudo apt install ffmpeg python3-pip -y

# 推荐安装 uv 以极速运行封装脚本
curl -LsSf https://astral.sh/uv/install.sh | sh
```

## 🚀 使用方法 (推荐)

直接调用封装脚本，一键生成 Telegram 原生语音气泡路径：

```bash
uv run {baseDir}/scripts/voice_gen.py --text "您的待播报内容"
```

## ⚙️ 技术细节

### 参数说明
- `--text` / `-t`: 待生成的文本（必填）。
- `--voice`: 声线选择，默认 `zh-CN-XiaoxiaoNeural`（晓晓）。
- `--rate`: 语速调节，默认 `+5%`。
- `--outdir`: 临时文件存放目录，默认 `/tmp`。

### 自动化清洗规则
脚本会自动移除以下内容以确保朗读流畅：
- Markdown 符号：`**`, `*`, `_`, `` ` ``, `#`
- 链接逻辑：`[文本](url)` 以及所有 `http/https` 开头的链接
- 分割线：`---`, `***` 等

---

## 👨💻 关于作者

由 **[@sanwe](https://x.com/sanwe)** 调优并维护。
欢迎关注我的推特获取更多 OpenClaw 进阶玩法：[https://x.com/sanwe](https://x.com/sanwe)