← Back to Skills Marketplace
609
Downloads
0
Stars
2
Active Installs
7
Versions
Install in OpenClaw
/install voiceclaw
Description
Local voice I/O for OpenClaw agents. Transcribe inbound audio/voice messages using local Whisper (whisper.cpp) and generate voice replies using local Piper T...
Usage Guidance
This skill appears to be what it says: an offline STT/TTS helper that runs local whisper/piper/ffmpeg. Before installing: ensure you obtain whisper, piper, ffmpeg, and voice/model files from trusted sources; verify the model files exist (scripts will error otherwise); note that any one-time model download (documented in README) will contact the network only if you run the manual curl/git commands yourself; review and test the included scripts in a safe environment (they operate on /tmp and local files). If you need absolute assurance, inspect the whisper and piper binaries you will use (third-party native binaries can have their own risks). Finally, be aware of the minor doc mismatch: the project mentions an "auto-download on first use" but the provided scripts do not perform automatic downloads — model provisioning is manual or handled by the underlying whisper/piper install you choose.
Capability Analysis
Type: OpenClaw Skill
Name: voiceclaw
Version: 1.0.6
The OpenClaw skill 'voiceclaw' is classified as benign. The code and documentation consistently emphasize and implement a 'local-only' approach for speech-to-text and text-to-speech, with no network calls made by the operational scripts (`speak.sh`, `transcribe.sh`). Key security features include robust input sanitization for voice names in `speak.sh` to prevent path traversal, piping text to stdin for Piper TTS to avoid shell injection, and proper temporary file cleanup using `trap cleanup EXIT` in `transcribe.sh`. The `SKILL.md` instructions for the agent are clear and align with the stated purpose, showing no signs of prompt injection attempts. The `SECURITY.md` accurately describes the implemented protections, confirming the absence of data exfiltration, malicious execution, or persistence mechanisms.
Capability Assessment
Purpose & Capability
Name/description (local STT/TTS) matches required binaries (whisper, piper, ffmpeg) and included scripts. Declared env vars (WHISPER_BIN, WHISPER_MODEL, PIPER_BIN, VOICECLAW_VOICES_DIR) are appropriate and optional for locating binaries/models.
Instruction Scope
Runtime instructions and the two scripts operate on local files (input audio, local model files, /tmp) and call only the declared binaries. SKILL.md and README consistently instruct local usage. One minor inconsistency: README/SKILL.md mention the Whisper model may be "auto-downloaded on first use," but the shipped scripts do not perform any automatic download — model download is a manual/optional step documented in README. This is informational rather than a security mismatch.
Install Mechanism
No install spec in registry (instruction-only), so nothing is automatically downloaded or executed by the skill itself. README documents optional manual install routes (git clone, curl from GitHub releases, ClawHub). Those manual commands point to expected project hosts and are not executed by the skill.
Credentials
No credentials or sensitive environment variables are required. Optional env vars relate directly to binary/model paths. The skill does not request unrelated secrets or system config paths.
Persistence & Privilege
Skill is not set to always:true and is user-invocable only. It does not modify other skills or system-wide configs. Scripts write temporary files under /tmp and return output paths; they do not persist credentials or install background services.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install voiceclaw - After installation, invoke the skill by name or use
/voiceclaw - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.6
v1.0.6: Complete SKILL.md rewrite — runtime-only content, zero download/URL/install references in body, clean description with no contradictions. Resolves ClawHub scanner suspicious flag.
v1.0.5
v1.0.5: Remove all curl/network references from SKILL.md — setup docs in README only. SKILL.md now 100% network-free, matching zero-network-calls claim. Add proper openclaw metadata frontmatter.
v1.0.4
v1.0.4: Add proper openclaw metadata frontmatter (requires.bins, network:none, env vars). Fix remaining /opt/piper path in example. Resolves ClawHub scanner suspicious flag.
v1.0.3
Fix ClawhHub security flags: portable $HOME paths (not /root/), all env vars declared in scripts + SKILL.md, network claim clarified (scripts=zero calls, curl=setup-only), non-standard frontmatter removed
v1.0.2
Fix ClawhHub security flags: portable paths ($HOME vs /root/), all env vars declared (WHISPER_MODEL, WHISPER_BIN, PIPER_BIN, VOICECLAW_VOICES_DIR), network claim clarified (scripts=zero calls, curl=setup-only), non-standard frontmatter removed
v1.0.1
v1.0.1: Declare binary requirements in frontmatter, remove hardcoded root paths (use env vars), clarify network=none (scripts make zero network calls), strengthen SECURITY.md with full threat model.
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is VoiceClaw?
Local voice I/O for OpenClaw agents. Transcribe inbound audio/voice messages using local Whisper (whisper.cpp) and generate voice replies using local Piper T... It is an AI Agent Skill for Claude Code / OpenClaw, with 609 downloads so far.
How do I install VoiceClaw?
Run "/install voiceclaw" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is VoiceClaw free?
Yes, VoiceClaw is completely free (open-source). You can download, install and use it at no cost.
Which platforms does VoiceClaw support?
VoiceClaw is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created VoiceClaw?
It is built and maintained by Asif (@asif2bd); the current version is v1.0.6.
More Skills