← Back to Skills Marketplace
xhunx

ElevenLabs STT OpenClaw

by xHUNx · GitHub ↗ · v1.2.2
cross-platform ✓ Security Clean
481
Downloads
0
Stars
1
Active Installs
3
Versions
Install in OpenClaw
/install elevenlabs-stt-openclaw
Description
Transcribe audio files with ElevenLabs Speech-to-Text (Scribe v2) from the local CLI. Supports diarization, events, JSON output, webhooks, and advanced STT o...
README (SKILL.md)

ElevenLabs Speech-to-Text (Local CLI)

Use

Run the script in scripts/transcribe.sh with an audio file path or URL.

Examples:

scripts/transcribe.sh /path/to/audio.mp3
scripts/transcribe.sh /path/to/audio.mp3 --diarize --lang en
scripts/transcribe.sh /path/to/audio.mp3 --json
scripts/transcribe.sh /path/to/audio.mp3 --webhook --webhook-metadata '{"job":"call-001"}'
scripts/transcribe.sh --url https://example.com/audio.mp3 --lang en

Environment

Set ELEVENLABS_API_KEY in your shell or OpenClaw env before running.

Notes

  • Defaults to scribe_v2 (the Speech-to-Text model) and uses a filesystem lock to avoid parallel requests.
  • Requires curl and jq.
  • For async workflows, use --webhook with optional --webhook-id and --webhook-metadata.
  • Realtime streaming is available via scripts/realtime.sh (requires ffmpeg + websocat) and uses the scribe_v2_realtime model.
  • Live listener mode is available via scripts/live_listen.sh with toggle/always-on modes and optional TTS response.
Usage Guidance
This skill appears to do what it claims: it streams or uploads audio to ElevenLabs for transcription and optionally uses ElevenLabs TTS for playback. Before installing/use: 1) Understand that your audio (and the ELEVENLABS_API_KEY) will be sent to api.elevenlabs.io — only use a key you trust to expose audio to that service. 2) To transcribe local files you must set ALLOW_LOCAL_FILE=true (the README and scripts require it, but SKILL.md metadata doesn't list it). 3) The live-listen mode will capture microphone audio — run it only when you intend to stream mic input. 4) Inspect the scripts locally (they are plain shell/python) and consider using a dedicated API key with limited permissions or usage limits. 5) If you plan to use webhooks, ensure the webhook endpoint you register is secure because ElevenLabs will deliver transcription results to it. If any of these behaviors are unexpected, do not run the scripts and rotate/revoke any keys used for testing.
Capability Analysis
Type: OpenClaw Skill Name: elevenlabs-stt-openclaw Version: 1.2.2 The skill bundle is designed for ElevenLabs Speech-to-Text transcription and exhibits no malicious intent. It correctly uses environment variables for API keys, validates user-provided URLs and JSON inputs, and employs `subprocess.Popen` with lists of arguments to prevent shell injection. The `ALLOW_LOCAL_FILE=true` requirement for local file access is a good security practice. While transcribed audio could theoretically contain malicious instructions, the skill itself only outputs or speaks this text, not executes it, making any downstream risk a vulnerability of the consuming agent, not the skill. All network calls are confined to the ElevenLabs API.
Capability Assessment
Purpose & Capability
Name/description (ElevenLabs STT CLI) match the implementation: scripts call ElevenLabs STT and TTS endpoints, use ffmpeg for audio conversion, websocat for realtime websockets, and jq/curl for API interaction. Required binaries and ELEVENLABS_API_KEY are appropriate for the stated functionality.
Instruction Scope
The SKILL.md and scripts consistently instruct sending audio to ElevenLabs endpoints and optionally streaming microphone audio. One minor mismatch: README and transcribe.sh require ALLOW_LOCAL_FILE=true to operate on local files, but SKILL.md metadata lists only ELEVENLABS_API_KEY. Scripts also read optional env vars (ELEVENLABS_VOICE_ID, RT_*), which are not declared in the metadata. Aside from that, the instructions stay within the stated STT/TTS scope and do not attempt to read unrelated host files or secrets.
Install Mechanism
No install spec; this is an instruction-and-script bundle that relies on existing system binaries. No remote downloads or archive extraction are performed by an installer, which keeps install risk low.
Credentials
Only ELEVENLABS_API_KEY is required and is appropriate for calling ElevenLabs APIs. The scripts reference additional environment variables (ALLOW_LOCAL_FILE, ELEVENLABS_VOICE_ID, RT_DEVICE/RT_LANG/RT_TTS/RT_VOICE_ID) that are optional/defaulted but not declared in the skill metadata — this mismatch should be noted before use. No unrelated credentials are requested.
Persistence & Privilege
The skill does not request persistent or elevated platform privileges; always:false and it doesn't modify other skills or system-wide agent configuration.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install elevenlabs-stt-openclaw
  3. After installation, invoke the skill by name or use /elevenlabs-stt-openclaw
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.2.2
Security hardening: validate inputs, remove .env sourcing, guard TTS
v1.2.1
Fix metadata requirements; remove .env sourcing; clarify binaries
v1.2.0
Polished README, realtime + live listener options, webhook support
Metadata
Slug elevenlabs-stt-openclaw
Version 1.2.2
License
All-time Installs 2
Active Installs 1
Total Versions 3
Frequently Asked Questions

What is ElevenLabs STT OpenClaw?

Transcribe audio files with ElevenLabs Speech-to-Text (Scribe v2) from the local CLI. Supports diarization, events, JSON output, webhooks, and advanced STT o... It is an AI Agent Skill for Claude Code / OpenClaw, with 481 downloads so far.

How do I install ElevenLabs STT OpenClaw?

Run "/install elevenlabs-stt-openclaw" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ElevenLabs STT OpenClaw free?

Yes, ElevenLabs STT OpenClaw is completely free (open-source). You can download, install and use it at no cost.

Which platforms does ElevenLabs STT OpenClaw support?

ElevenLabs STT OpenClaw is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ElevenLabs STT OpenClaw?

It is built and maintained by xHUNx (@xhunx); the current version is v1.2.2.

💬 Comments