通过sherpa-onnx实现本地文本转语音离线无需云服务。技能概述sherpa-onnx-tts 技能是一个基于sherpa-onnx的本地文本转语音TTS工具完全离线运行不需要云服务。它支持多种操作系统macOS、Linux、Windows并提供高质量的语音输出。该技能特别适合需要隐私保护、离线使用或低延迟TTS的场景。下载地址https://github.com/openclaw/openclaw/tree/main/skills主要功能离线TTS完全本地运行无需网络连接多平台支持支持macOS、Linux和Windows多种语音模型支持Piper等多种TTS模型高质量输出生成高质量的WAV音频文件灵活配置支持自定义模型、tokens文件等易于集成提供包装脚本便于集成到工作流程中触发条件当用户需要执行以下操作时应该使用sherpa-onnx-tts技能需要离线文本转语音功能需要保护隐私不想使用云TTS服务需要低延迟的语音生成在没有网络连接的环境中使用TTS需要自定义或特定的语音模型使用场景场景1离线语音助手用户需要在没有网络连接的环境中使用语音助手可以使用sherpa-onnx-tts生成语音回复。场景2隐私保护用户需要保护隐私不想将文本发送到云端可以使用本地TTS服务。场景3批量音频生成用户需要批量生成音频文件可以使用sherpa-onnx-tts的高效处理能力。场景4嵌入式系统用户需要在资源受限的嵌入式系统中使用TTS可以使用sherpa-onnx-tts的轻量级模型。处理过程1. 下载运行时根据操作系统下载相应的sherpa-onnx运行时。# macOS 下载: https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-osx-universal2-shared.tar.bz2# 解压到: ~/.openclaw/tools/sherpa-onnx-tts/runtime# Linux x64 下载: https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-linux-x64-shared.tar.bz2# 解压到: ~/.openclaw/tools/sherpa-onnx-tts/runtime# Windows x64 下载: https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-win-x64-shared.tar.bz2# 解压到: ~/.openclaw/tools/sherpa-onnx-tts/runtime2. 下载语音模型下载所需的语音模型。bash# 下载Piper en_US lessac (high)模型# 下载: https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/vits-piper-en_US-lessac-high.tar.bz2# 解压到: ~/.openclaw/tools/sherpa-onnx-tts/models3. 配置环境变量更新~/.openclaw/openclaw.json配置文件。json{skills: {entries: {sherpa-onnx-tts: {env: {SHERPA_ONNX_RUNTIME_DIR: ~/.openclaw/tools/sherpa-onnx-tts/runtime,SHERPA_ONNX_MODEL_DIR: ~/.openclaw/tools/sherpa-onnx-tts/models/vits-piper-en_US-lessac-high}}}}}4. 使用TTS运行sherpa-onnx-tts生成语音。# macOS/Linux{baseDir}/bin/sherpa-onnx-tts -o ./tts.wav Hello from local TTS.# Windowsnode {baseDir}\\bin\\sherpa-onnx-tts -o tts.wav Hello from local TTS.输入要求使用sherpa-onnx-tts需要以下输入运行时目录sherpa-onnx运行时的路径SHERPA_ONNX_RUNTIME_DIR模型目录语音模型的路径SHERPA_ONNX_MODEL_DIR文本内容要转换为语音的文本输出文件生成的音频文件路径模型文件可选如果模型目录有多个.onnx文件Tokens文件可选用于覆盖默认设置数据目录可选用于覆盖默认设置输出说明sherpa-onnx-tts提供以下输出音频文件生成的WAV格式音频文件状态信息处理过程中的状态和错误信息使用示例示例1基本使用{baseDir}/bin/sherpa-onnx-tts -o ./tts.wav Hello from local TTS.示例2指定模型文件{baseDir}/bin/sherpa-onnx-tts -o ./tts.wav --model-file model.onnx Hello from local TTS.示例3指定tokens文件{baseDir}/bin/sherpa-onnx-tts -o ./tts.wav --tokens-file tokens.txt Hello from local TTS.示例4指定数据目录{baseDir}/bin/sherpa-onnx-tts -o ./tts.wav --data-dir /path/to/data Hello from local TTS.最佳实践模型选择从sherpa-onnx的tts-models发布版本中选择不同的模型根据需求选择合适的语音质量和模型大小测试多个模型以找到最适合的语音模型目录配置如果模型目录有多个.onnx文件设置SHERPA_ONNX_MODEL_FILE或传递--model-file参数确保模型目录路径正确且可访问可以使用--tokens-file或--data-dir覆盖默认设置环境变量设置在~/.openclaw/openclaw.json中配置环境变量确保SHERPA_ONNX_RUNTIME_DIR指向正确的运行时目录确保SHERPA_ONNX_MODEL_DIR指向正确的模型目录PATH配置可以将包装脚本添加到PATH中以便全局使用使用export PATH{baseDir}/bin:$PATH添加到PATH确保包装脚本具有执行权限Windows使用Windows用户需要使用node运行包装脚本命令格式node {baseDir}\\bin\\sherpa-onnx-tts -o tts.wav Hello from local TTS.注意路径分隔符的使用Windows使用反斜杠性能优化选择适合硬件的模型大小以平衡质量和速度对于批量处理考虑使用脚本自动化监控内存使用特别是在资源受限的环境中安装说明sherpa-onnx-tts的安装包括两个部分运行时和模型。运行时下载根据操作系统从GitHub发布版本下载相应的运行时包模型下载从sherpa-onnx的tts-models发布版本下载所需的语音模型配置文件更新~/.openclaw/openclaw.json配置环境变量包装脚本使用技能文件夹中的包装脚本或将其添加到PATH安装完成后确保运行时和模型目录正确配置并且包装脚本具有执行权限。