sherpa-onnx-tts — скилл для Claude Code: что делает и как установить
Локальный синтез речи через sherpa-onnx без облачных сервисов. Скилл озвучивает текст и сохраняет результат в аудиофайл WAV прямо на рабочей станции.
npx skills add openclaw/openclaw --skill sherpa-onnx-tts -a claude-codeЧто делает sherpa-onnx-tts
Скилл вызывает утилиту sherpa-onnx для генерации речи на локальном компьютере. Аудио создаётся без обращения к облачным API и работает без интернета. По умолчанию используется модель Piper en_US lessac (high), но можно указать другие модели ONNX через аргументы --model-file, --tokens-file или переменные окружения.
Для работы требуется скачать архив рантайма sherpa-onnx v1.13.6 под вашу систему (macOS, Linux x64 или Windows x64) и распаковать модель голоса. Затем пути к ним прописываются в переменных SHERPA_ONNX_RUNTIME_DIR и SHERPA_ONNX_MODEL_DIR в конфигурационном файле ~/.openclaw/openclaw.json. На Windows запуск обёртки выполняется через Node.js.
Инструмент полезен, если вам критична автономная озвучка текстов без оплаты сторонних API. Если на диске нет места под рантайм и веса моделей, проще остаться на облачных сервисах.
Какие задачи решает
- Озвучивать текст в файлы формата WAV без подключения к сети
- Генерировать речь локально на macOS, Linux или Windows
- Подключать голосовые ONNX-модели семейства Piper
Примеры запросов агенту
- Озвучь этот текст в файл ./tts.wav через sherpa-onnx-tts
- Сгенерируй аудиофайл tts.wav с фразой "Hello from local TTS."
Как установить sherpa-onnx-tts
1Через Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill sherpa-onnx-tts -a claude-code2Вручную: положить файлы
~/.claude/skills/sherpa-onnx-tts/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sherpa-onnx-tts/
1Через Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill sherpa-onnx-tts -a codex2Вручную: положить файлы
.agents/skills/sherpa-onnx-tts/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill sherpa-onnx-tts -a cursor2Вручную: положить файлы
.cursor/skills/sherpa-onnx-tts/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install openclaw/openclaw sherpa-onnx-tts2Вручную: положить файлы
.github/skills/sherpa-onnx-tts/SKILL.md1Через Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill sherpa-onnx-tts -a gemini-cli2Командой платформы
gemini skills install https://github.com/openclaw/openclaw --path skills/sherpa-onnx-ttsВручную: положить файлы
.devin/skills/sherpa-onnx-tts/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add openclaw/openclaw --skill sherpa-onnx-tts -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора45
Весь набор →Похожие
Вопросы о sherpa-onnx-tts
Как установить sherpa-onnx-tts в Claude Code?
Выполните команду npx skills add openclaw/openclaw --skill sherpa-onnx-tts -a claude-code. Затем загрузите рантайм sherpa-onnx и модель голоса в каталог состояния OpenClaw.
Какие переменные окружения нужны для работы?
Скиллу требуются переменные SHERPA_ONNX_RUNTIME_DIR с путём к распакованному рантайму и SHERPA_ONNX_MODEL_DIR с путём к каталогу модели.
Можно ли использовать другую модель голоса?
Да, можно скачать модель из релизов sherpa-onnx. Путь переопределяется через флаги --model-file, --tokens-file и --data-dir.
Исходный текст
SKILL.md · MIT
---
name: sherpa-onnx-tts
description: "Local text-to-speech via sherpa-onnx (offline, no cloud)"
metadata:
{
"openclaw":
{
"emoji": "🔉",
"os": ["darwin", "linux", "win32"],
"requires": { "env": ["SHERPA_ONNX_RUNTIME_DIR", "SHERPA_ONNX_MODEL_DIR"] },
"install":
[
{
"id": "download-runtime-macos",
"kind": "download",
"os": ["darwin"],
"url": "https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.13.6/sherpa-onnx-v1.13.6-osx-universal2-shared.tar.bz2",
"sha256": "05ed5839bbdfb2da36bb9095961e6b4cfa470d55e29a9795100627dbc36df2ba",
"archive": "tar.bz2",
"extract": true,
"stripComponents": 1,
"targetDir": "runtime",
"label": "Download sherpa-onnx runtime (macOS)",
},
{
"id": "download-runtime-linux-x64",
"kind": "download",
"os": ["linux"],
"url": "https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.13.6/sherpa-onnx-v1.13.6-linux-x64-shared.tar.bz2",
"sha256": "58cc7d360fdedf9702954e8b585eb400bbee8668484bf25e4461d5d22ba439d8",
"archive": "tar.bz2",
"extract": true,
"stripComponents": 1,
"targetDir": "runtime",
"label": "Download sherpa-onnx runtime (Linux x64)",
},
{
"id": "download-runtime-win-x64",
"kind": "download",
"os": ["win32"],
"url": "https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.13.6/sherpa-onnx-v1.13.6-win-x64-shared-MD-Release.tar.bz2",
"sha256": "27efaed17a64a40fd3059ac24195dcf4ec0521c999906d288cc5107cbbf4cedc",
"archive": "tar.bz2",
"extract": true,
"stripComponents": 1,
"targetDir": "runtime",
"label": "Download sherpa-onnx runtime (Windows x64)",
},
{
"id": "download-model-lessac",
"kind": "download",
"url": "https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/vits-piper-en_US-lessac-high.tar.bz2",
"archive": "tar.bz2",
"extract": true,
"targetDir": "models",
"label": "Download Piper en_US lessac (high)",
},
],
},
}
---
# sherpa-onnx-tts
Local TTS using the sherpa-onnx offline CLI.
## Install
1. Download the runtime for your OS (extracts into `$OPENCLAW_STATE_DIR/tools/sherpa-onnx-tts/runtime`, default `~/.openclaw/tools/sherpa-onnx-tts/runtime`)
2. 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:
```bash
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`):
```json5
{
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:
```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."`
© openclaw · MIT · openclaw/openclaw
