Lux Tts

LuxTTS 技能 - 本地高质量文本转语音 概述

LuxTTS 是一个高质量的本地文本转语音模型，支持语音克隆，速度达到实时150倍。本技能将 LuxTTS 集成到 OpenClaw 中，提供本地化的 TTS 服务。

特性 🚀 极速生成：150倍实时速度 🎯 高质量语音：48kHz 高清音频 🔒 完全本地：无需云端 API，保护隐私 🎨 语音克隆：支持自定义语音 💾 智能路径管理：自动检测安装位置 安装位置 主安装：D:\lux-tts\（模型、大文件） 接口层：workspace/lux-tts/（智能路径管理） 自动检测：支持多个可能的位置 部署步骤

• 运行部署脚本

# 在 D:\lux-tts\scripts\ 目录下 .\部署.ps1

• 下载模型

.\下载-模型.ps1

• 测试安装

# 在 OpenClaw 中测试 from lux_tts 导入 test_安装ation test_安装ation()

使用方法 基本使用 from lux_tts_工具 导入 tts_生成, tts_状态

# 检查状态 状态 = tts_状态() print(状态)

# 生成语音 结果 = tts_生成("你好，我是 LuxTTS") if 结果["成功"]: # 结果["audio_base64"] 包含 base64 编码的音频 print(f"生成成功，时长: {结果['duration']}秒")

在 OpenClaw 工具中调用 # 在 OpenClaw 技能中 from lux_tts_工具 导入 获取_tts_工具

tts = 获取_tts_工具() 结果 = tts.生成("需要转换为语音的文本")

命令行测试 # 检查状态 python lux_tts_工具.py 状态

# 列出语音 python lux_tts_工具.py 列出

# 生成语音 python lux_tts_工具.py 生成 "你好世界" --输出 输出.wav

配置 配置文件位置

D:\lux-tts\config.yaml

配置选项 安装_path: "D:\\lux-tts" # 安装位置 device: "cuda" # 设备：cuda/cpu 模型_repo: "YatharthS/LuxTTS" # 模型仓库 reference_voice: "voices/test.wav" # 默认语音 audio_格式化: "wav" # 音频格式 sample_rate: 48000 # 采样率 缓存_enabled: true # 启用缓存 缓存_dir: "缓存" # 缓存目录

语音管理 添加自定义语音 准备清晰的语音文件（WAV/MP3，≥3秒） 复制到 D:\lux-tts\voices\ 目录 或在代码中调用： tts.添加_voice("path/to/your/voice.wav", "my_voice.wav")

使用自定义语音 结果 = tts_生成("文本", voice="D:\\lux-tts\\voices\\my_voice.wav")

故障排除 常见问题

• "未找到 LuxTTS 安装"

检查 D:\lux-tts\ 目录是否存在 运行部署脚本：部署.ps1 设置环境变量：LUX_TTS_PATH=D:\lux-tts

• "无法导入 zipvoice"

激活虚拟环境：D:\lux-tts\venv\Scripts\activate 重新安装：pip 安装 zipvoice-luxvoice

• CUDA 不可用

检查 NVIDIA 驱动：nvidia-smi 回退到 CPU：修改 config.yaml 中的 device: "cpu"

• 音频质量不佳

确保参考音频 ≥3秒，清晰无噪音 调整参数：rms=0.01, t_shift=0.9, num_steps=4 日志查看 导入 记录ging 记录ging.获取记录ger('lux_tts').设置Level(记录ging.调试)

性能优化 GPU 加速 确保 CUDA 可用：nvidia-smi 配置文件中设置 device: "cuda" 缓存启用 启用缓存减少重复生成 缓存目录：D:\lux-tts\缓存\ 批量处理 # 批量生成可复用编码的提示 encoded = tts.命令行工具ent._模型.encode_prompt(voice_file) for text in texts: audio = tts.命令行工具ent._模型.生成_speech(text, encoded)

与现有 TTS 集成 并行运行模式 def hybrid_tts(text, use_local=True): """混合 TTS：本地优先，云端备用""" try: if use_local: return tts_生成(text) except 异常: pass # 回退到云端 TTS return cloud_tts_生成(text)

配置 OpenClaw

在 工具S.md 中添加：

TTS 选项

• 本地 LuxTTS：快速、免费、隐私好
• 云端 TTS：备用方案

更新和维护 更新模型 # 重新下载模型 .\下载-模型.ps1

备份配置 # 备份重要文件 Copy-Item "D:\lux-tts\config.yaml" "备份路径\" Copy-Item "D:\lux-tts\voices\" "备份路径\voices\" -Recurse

清理缓存 移除-Item "D:\lux-tts\缓存\*" -Recurse -Force

许可证 LuxTTS 模型：Apache-2.0 本技能：MIT 参考 LuxTTS GitHub Hugging Face 模型 OpenClaw 文档

最后更新: 2026-03-16