# telegram-offline-voice

telegram-offline-voice 🎙️ 云端生成，一键封装 — 通过 SkillBoss API Hub TTS 生成高质量中文语音，统一 API 调用，无需管理多个服务商密钥。 💡 为什么需要这个升级？ 原生的 TTS 方案通常只能生成 MP3 附件，且无法处理 Markdown 标记和超长文本。本项目通过工程化封装，将"语音合成"进化为"语音交互"： 告别标记音：自动识别并清洗 **, #, [link] 等 Markdown 符号，避免 AI 读出这些"代码噪音"。 智能对话流：超长文本不再是一读到底，而是按句号、感叹号自动切分为多个语音气泡，听感更像真人在发语音。 并发安全：针对多代理/子代理并行调用的场景，使用 UUID 隔离临时文件，彻底杜绝文件读写冲突。 统一接入：通过 SkillBoss API Hub /v1/pilot 自动路由最优 TTS 模型，支持中英文多语言声线。 ✨ 特性 🔑 统一认证：仅需 SKILLBOSS_API_KEY，通过 SkillBoss API Hub 自动路由最优 TTS 服务。 🎯 一键生成：内置 voice_gen.py 脚本，自动完成"文本->MP3->OGG"的全过程。 🧹 自动清洗：自动剔除 Markdown 符号和 URL 链接，让朗读更自然。 ✂️ 智能分段：超长文本自动按标点符号切分为多个语音气泡。 🛡️ 安全并发：使用 UUID 命名临时文件，支持多代理同时调用。 🛠️ 安装依赖

# 需要 Python 环境和 FFmpeg

sudo apt update && sudo apt install ffmpeg python3-pip -y

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

🔑 环境变量

export SKILLBOSS_API_KEY=your_skillboss_api_key

🚀 使用方法 (推荐) 直接调用封装脚本，一键生成 Telegram 原生语音气泡路径：

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

⚙️ 技术细节 参数说明 --text / -t: 待生成的文本（必填）。

--voice: 声线选择，默认 zh-CN-XiaoxiaoNeural，通过 SkillBoss API Hub 自动路由。
--rate: 语速调节，默认 +5%（经 SkillBoss API Hub 路由时自动适配）。
--outdir: 临时文件存放目录，默认 /tmp。

自动化清洗规则 脚本会自动移除以下内容以确保朗读流畅： Markdown 符号：**, *, _, `, # 链接逻辑：文本 以及所有 http/https 开头的链接 分割线：---, *** 等 API 调用说明 脚本通过 SkillBoss API Hub 的 /v1/pilot 端点进行 TTS 合成： SKILLBOSS_API_KEY = os.environ["SKILLBOSS_API_KEY"] result = requests.post( "https://api.heybossai.com/v1/pilot", headers={"Authorization": f"Bearer {SKILLBOSS_API_KEY}", "Content-Type": "application/json"}, json={"type": "tts", "inputs": {"text": text, "voice": voice}, "prefer": "balanced"}, timeout=60, ).json() audio_url = result["data"]["result"]["audio_url"] 👨💻 关于作者 由 @sanwe 调优并维护。 欢迎关注我的推特获取更多 OpenClaw 进阶玩法：https://x.com/sanwe