openclawv1.0.0

VoiceClaw

@Asif2BD⭐ 1 stars· last commit 7mo ago· 0 open issues

A 100% local voice skill for OpenClaw agents — transcribes inbound voice messages with Whisper and replies with synthesized speech via Piper TTS. No cloud, no API keys, no paid services required.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

Adopt or update this skill from https://proskills.md/skills/automation/voiceclaw. First identify the installation path supported by this platform, detect whether it is already installed, compare the installed version with the latest stable release, show me what will change, and only then install or update it. If no native installer is available, use the complete package or source fallback described on the page.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

8.2/10

Verified

Mar 8, 2026

// RATINGS

⭐GitHub Stars

⭐ 0 on GitHubGitHub ↗

New / niche

🔵ClawHub

⬇ 1.3k on ClawHubView ↗

1.3k downloads · 35 installs on ClawHub · checked Oct 9, 2026

🟢ProSkills ScoreAI Verified

8.2/10

// README

🎙️ VoiceClaw — Local Voice I/O for OpenClaw Agents

ClawHub: clawhub.ai/Asif2BD/voiceclaw · GitHub: github.com/Asif2BD/VoiceClaw

Created by M Asif Rahman — Founder of MissionDeck.ai · xCloud · WPDevelopers

A local-only voice skill for OpenClaw agents. Transcribe inbound voice messages with Whisper and reply with synthesized speech via Piper TTS — no cloud, no API keys, no paid services.

Install

Option 1 — Via ClawHub (if ClawHub is installed)

clawhub install voiceclaw

Option 2 — Via Git (no ClawHub needed)

git clone https://github.com/Asif2BD/VoiceClaw.git ~/.openclaw/custom-skills/voiceclaw

Option 3 — Download release (manual, no tools needed)

curl -L https://github.com/Asif2BD/VoiceClaw/releases/latest/download/voiceclaw.skill -o voiceclaw.skill
unzip voiceclaw.skill -d ~/.openclaw/custom-skills/voiceclaw

After any install method, restart OpenClaw for the skill to be detected.

Requirements

whisper — whisper.cpp binary (install guide)

Whisper model: ggml-base.en.bin — auto-downloaded on first use, or manually:

# One-time setup only — not run by the skill scripts
mkdir -p ~/.cache/whisper
curl -L -o ~/.cache/whisper/ggml-base.en.bin \
  https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.en.bin

Set WHISPER_MODEL=/path/to/ggml-base.en.bin if your model is stored elsewhere.

piper — TTS binary + .onnx voice models (install guide). Set VOICECLAW_VOICES_DIR=/path/to/voices/ to point to your voice models (default: ~/.local/share/piper/voices/)
ffmpeg — for audio format conversion

What it does

Speech-to-Text: Inbound voice/audio (OGG, MP3, WAV, M4A) → transcript text via Whisper.cpp
Text-to-Speech: Agent text replies → voice audio via Piper TTS (7 English voices)
Agent behavior: When a voice message arrives, the agent automatically responds with both voice + text
100% local: No data sent anywhere — all inference runs on your server

How it works

Inbound voice message (OGG/MP3/WAV)
        ↓
  ffmpeg → 16kHz mono WAV
        ↓
  whisper.cpp → transcript text
        ↓
  Agent reads transcript, composes reply
        ↓
  Piper TTS → WAV → OGG Opus
        ↓
  Voice reply + text transcript sent together

Usage

# Transcribe a voice message
bash scripts/transcribe.sh /path/to/voice.ogg

# Generate a voice reply (returns path to WAV)
bash scripts/speak.sh "Your task is complete." /tmp/reply.wav

# Convert WAV → OGG Opus for Telegram
ffmpeg -i /tmp/reply.wav -c:a libopus -b:a 32k /tmp/reply.ogg -y

Available Voices

Voice ID	Style
`en_US-lessac-medium`	Neutral American (default)
`en_US-amy-medium`	Warm American female
`en_US-joe-medium`	American male
`en_US-kusal-medium`	Expressive American male
`en_US-danny-low`	Deep American male (fast)
`en_GB-alba-medium`	British female
`en_GB-northern_english_male-medium`	Northern British male

Voice models live at /opt/piper/voices/. See SKILL.md for full agent integration instructions.

Security

All processing is local — no audio or text is sent to any cloud service or external API
Temp files are cleaned up — audio is converted in /tmp and deleted immediately after transcription (bash trap on EXIT)
Voice names are sanitized — input stripped to [a-zA-Z0-9_-] only, preventing path traversal
No network calls — neither script makes any network request

Author

M Asif Rahman

License

// HOW IT'S BUILT

KEY FILES

README.mdSKILL.md

// REPO STATS

1 stars

0 open issues

Last commit: 7mo ago

// SHARE

Share on X Share on LinkedIn