# Send Voice Reply to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "voice-reply",
    "name": "Voice Reply",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/stolot0mt0m/voice-reply",
    "canonicalUrl": "https://clawhub.ai/stolot0mt0m/voice-reply",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/voice-reply",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voice-reply",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "scripts/install.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "voice-reply",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-10T17:42:47.256Z",
      "expiresAt": "2026-05-17T17:42:47.256Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voice-reply",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=voice-reply",
        "contentDisposition": "attachment; filename=\"voice-reply-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "voice-reply"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/voice-reply"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/voice-reply",
    "downloadUrl": "https://openagent3.xyz/downloads/voice-reply",
    "agentUrl": "https://openagent3.xyz/skills/voice-reply/agent",
    "manifestUrl": "https://openagent3.xyz/skills/voice-reply/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/voice-reply/agent.md"
  }
}
```
## Documentation

### Voice Reply

Generate voice audio replies using local Piper TTS via sherpa-onnx. Completely offline, no cloud APIs needed.

### Features

100% Local - No internet connection required after setup
No API Keys - Free to use, no accounts needed
Multi-language - German and English voices included
Telegram Ready - Outputs voice notes that display as bubbles
Auto-detect Language - Automatically selects voice based on text

### Prerequisites

sherpa-onnx runtime installed
Piper voice models downloaded
ffmpeg for audio conversion

### Quick Install

cd scripts
sudo ./install.sh

### Manual Installation

1. Install sherpa-onnx

sudo mkdir -p /opt/sherpa-onnx
cd /opt/sherpa-onnx
curl -L -o sherpa.tar.bz2 "https://github.com/k2-fsa/sherpa-onnx/releases/download/v1.12.23/sherpa-onnx-v1.12.23-linux-x64-shared.tar.bz2"
sudo tar -xjf sherpa.tar.bz2 --strip-components=1
rm sherpa.tar.bz2

2. Download Voice Models

sudo mkdir -p /opt/piper-voices
cd /opt/piper-voices

# German - thorsten (medium quality, natural male voice)
curl -L -o thorsten.tar.bz2 "https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/vits-piper-de_DE-thorsten-medium.tar.bz2"
sudo tar -xjf thorsten.tar.bz2 && rm thorsten.tar.bz2

# English - ryan (high quality, clear US male voice)
curl -L -o ryan.tar.bz2 "https://github.com/k2-fsa/sherpa-onnx/releases/download/tts-models/vits-piper-en_US-ryan-high.tar.bz2"
sudo tar -xjf ryan.tar.bz2 && rm ryan.tar.bz2

3. Install ffmpeg

sudo apt install -y ffmpeg

4. Set Environment Variables

Add to your OpenClaw service or shell:

export SHERPA_ONNX_DIR="/opt/sherpa-onnx"
export PIPER_VOICES_DIR="/opt/piper-voices"

### Usage

{baseDir}/bin/voice-reply "Text to speak" [language]

### Parameters

ParameterDescriptionDefaulttextThe text to convert to speech(required)languagede for German, en for Englishauto-detect

### Examples

# German (explicit)
{baseDir}/bin/voice-reply "Hallo, ich bin dein Assistent!" de

# English (explicit)
{baseDir}/bin/voice-reply "Hello, I am your assistant!" en

# Auto-detect (detects German from umlauts and common words)
{baseDir}/bin/voice-reply "Guten Tag, wie geht es dir?"

# Auto-detect (defaults to English)
{baseDir}/bin/voice-reply "The weather is nice today."

### Output Format

The script outputs two lines that OpenClaw processes for Telegram:

[[audio_as_voice]]
MEDIA:/tmp/voice-reply-output.ogg

[[audio_as_voice]] - Tag that tells Telegram to display as voice bubble
MEDIA:path - Path to the generated OGG Opus audio file

### Available Voices

LanguageVoiceQualityDescriptionGerman (de)thorstenmediumNatural male voice, clear pronunciationEnglish (en)ryanhighClear US male voice, professional tone

### Adding More Voices

Browse available Piper voices at:

https://rhasspy.github.io/piper-samples/
https://github.com/k2-fsa/sherpa-onnx/releases/tag/tts-models

Download and extract to $PIPER_VOICES_DIR, then modify the script to include the new voice.

### "TTS binary not found"

Ensure SHERPA_ONNX_DIR is set and contains bin/sherpa-onnx-offline-tts.

### "Failed to generate audio"

Check that voice model files exist: *.onnx, tokens.txt, espeak-ng-data/

### Audio plays as file instead of voice bubble

Ensure the output includes [[audio_as_voice]] tag on its own line before the MEDIA: line.

### Credits

sherpa-onnx - Offline speech processing
Piper - Fast local TTS voices
Thorsten Voice - German voice dataset
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: stolot0mt0m
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-10T17:42:47.256Z
- Expires at: 2026-05-17T17:42:47.256Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/voice-reply)
- [Send to Agent page](https://openagent3.xyz/skills/voice-reply/agent)
- [JSON manifest](https://openagent3.xyz/skills/voice-reply/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/voice-reply/agent.md)
- [Download page](https://openagent3.xyz/downloads/voice-reply)