SKILL.md
readonly

sherpa-onnx-tts

Author:openclaw
Category:
Development
323.9k
62.4k
name: sherpa-onnx-tts
description: Local text-to-speech via sherpa-onnx (offline, no cloud)

sherpa-onnx-tts

Local TTS using the sherpa-onnx offline CLI.

Install

  1. Download the runtime for your OS (extracts into ~/.openclaw/tools/sherpa-onnx-tts/runtime)
  2. Download a voice model (extracts into ~/.openclaw/tools/sherpa-onnx-tts/models)

Update ~/.openclaw/openclaw.json:

json5
{
  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",
        },
      },
    },
  },
}

The wrapper lives in this skill folder. Run it directly, or add the wrapper to PATH:

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

Usage

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

Notes:

  • Pick a different model from the sherpa-onnx tts-models release if you want another voice.
  • If the model dir has multiple .onnx files, set SHERPA_ONNX_MODEL_FILE or pass --model-file.
  • You can also pass --tokens-file or --data-dir to override the defaults.
  • Windows: run node {baseDir}\\bin\\sherpa-onnx-tts -o tts.wav "Hello from local TTS."

Actions

install --global skills.sh
npx skills add openclaw/openclaw/skills/sherpa-onnx-tts

Usage Guide

  1. 1. Run Install Command

    Copy the installation command above and run it in your terminal to install globally.

  2. 2. Configure Environment

    Add the required environment variables to your MCP client according to the skill description.

  3. 3. Use in Client

    Configure and enable this skill in any MCP-compatible app (e.g. Claude or Cursor).