sherpa-onnx-tts

sherpa-onnx-tts 是做什么的？

使用 sherpa-onnx 离线 CLI 进行本地文本转语音。

安装

1. 下载对应操作系统的运行时（解压到 $OPENCLAW_STATE_DIR/tools/sherpa-onnx-tts/runtime，默认 ~/.openclaw/tools/sherpa-onnx-tts/runtime）
2. 下载一个语音模型（解压到 $OPENCLAW_STATE_DIR/tools/sherpa-onnx-tts/models，默认 ~/.openclaw/tools/sherpa-onnx-tts/models）

首先解析活跃状态目录：

STATE_DIR="${OPENCLAW_STATE_DIR:-$HOME/.openclaw}"

然后将解析后的路径写入活跃的 OpenClaw 配置文件（$OPENCLAW_CONFIG_PATH，默认 ~/.openclaw/openclaw.json）：

{
  skills: {
    entries: {
      "sherpa-onnx-tts": {
        env: {
          SHERPA_ONNX_RUNTIME_DIR: "/path/to/your/state-dir/tools/sherpa-onnx-tts/runtime",
          SHERPA_ONNX_MODEL_DIR: "/path/to/your/state-dir/tools/sherpa-onnx-tts/models/vits-piper-en_US-lessac-high",
        },
      },
    },
  },
}

包装脚本位于此技能文件夹内。可以直接运行，或者将其添加到 PATH 环境变量中：

export PATH="{baseDir}/bin:$PATH"

用法

{baseDir}/bin/sherpa-onnx-tts -o ./tts.wav "Hello from local TTS."

注意事项：

• 如果想使用其他声音，可以从 sherpa-onnx 的 tts-models 发布版本中选择另一个模型。
• 如果模型目录中有多个 .onnx 文件，请设置 SHERPA_ONNX_MODEL_FILE 或传递 --model-file 参数。
• 你也可以传递 --tokens-file 或 --data-dir 来覆盖默认值。
• Windows 系统：运行 node {baseDir}\bin\sherpa-onnx-tts -o tts.wav "Hello from local TTS."