Agent Skills › the-open-agent/openagent › sherpa-onnx-tts

sherpa-onnx-tts

GitHub

提供基于 sherpa-onnx 的本地离线文本转语音功能，无需云端服务。支持配置运行时和模型路径，生成 WAV 音频文件，适用于隐私敏感或无网环境下的 TTS 需求。

skills/sherpa-onnx-tts/SKILL.md the-open-agent/openagent

Trigger Scenarios

需要将文本转换为语音要求本地离线执行 TTS 生成音频文件用于播放

Install

npx skills add the-open-agent/openagent --skill sherpa-onnx-tts -g -y

More Options

Use without installing

npx skills use the-open-agent/openagent@sherpa-onnx-tts

指定 Agent (Claude Code)

npx skills add the-open-agent/openagent --skill sherpa-onnx-tts -a claude-code -g -y

安装 repo 全部 skill

npx skills add the-open-agent/openagent --all -g -y

预览 repo 内 skill

npx skills add the-open-agent/openagent --list

SKILL.md

Frontmatter

{
    "name": "sherpa-onnx-tts",
    "metadata": {
        "openclaw": {
            "os": [
                "darwin",
                "linux",
                "win32"
            ],
            "emoji": "🔉",
            "install": [
                {
                    "id": "download-runtime-macos",
                    "os": [
                        "darwin"
                    ],
                    "url": "https:\/\/github.com\/k2-fsa\/sherpa-onnx\/releases\/download\/v1.12.23\/sherpa-onnx-v1.12.23-osx-universal2-shared.tar.bz2",
                    "kind": "download",
                    "label": "Download sherpa-onnx runtime (macOS)",
                    "archive": "tar.bz2",
                    "extract": true,
                    "targetDir": "runtime",
                    "stripComponents": 1
                },
                {
                    "id": "download-runtime-linux-x64",
                    "os": [
                        "linux"
                    ],
                    "url": "https:\/\/github.com\/k2-fsa\/sherpa-onnx\/releases\/download\/v1.12.23\/sherpa-onnx-v1.12.23-linux-x64-shared.tar.bz2",
                    "kind": "download",
                    "label": "Download sherpa-onnx runtime (Linux x64)",
                    "archive": "tar.bz2",
                    "extract": true,
                    "targetDir": "runtime",
                    "stripComponents": 1
                },
                {
                    "id": "download-runtime-win-x64",
                    "os": [
                        "win32"
                    ],
                    "url": "https:\/\/github.com\/k2-fsa\/sherpa-onnx\/releases\/download\/v1.12.23\/sherpa-onnx-v1.12.23-win-x64-shared.tar.bz2",
                    "kind": "download",
                    "label": "Download sherpa-onnx runtime (Windows x64)",
                    "archive": "tar.bz2",
                    "extract": true,
                    "targetDir": "runtime",
                    "stripComponents": 1
                },
                {
                    "id": "download-model-lessac",
                    "url": "https:\/\/github.com\/k2-fsa\/sherpa-onnx\/releases\/download\/tts-models\/vits-piper-en_US-lessac-high.tar.bz2",
                    "kind": "download",
                    "label": "Download Piper en_US lessac (high)",
                    "archive": "tar.bz2",
                    "extract": true,
                    "targetDir": "models"
                }
            ],
            "requires": {
                "env": [
                    "SHERPA_ONNX_RUNTIME_DIR",
                    "SHERPA_ONNX_MODEL_DIR"
                ]
            }
        }
    },
    "description": "Local text-to-speech via sherpa-onnx (offline, no cloud)"
}

sherpa-onnx-tts

Local TTS using the sherpa-onnx offline CLI.

Install

Download the runtime for your OS (extracts into $OPENCLAW_STATE_DIR/tools/sherpa-onnx-tts/runtime, default ~/.openclaw/tools/sherpa-onnx-tts/runtime)
Download a voice model (extracts into $OPENCLAW_STATE_DIR/tools/sherpa-onnx-tts/models, default ~/.openclaw/tools/sherpa-onnx-tts/models)

Resolve the active state directory first:

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

Then write those resolved paths into the active OpenClaw config file ($OPENCLAW_CONFIG_PATH, default ~/.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",
        },
      },
    },
  },
}

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

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

Usage

{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."