← Back to Skills Marketplace
Deepgram Transcribe
by
Jesse Wunderlich
· GitHub ↗
· v1.0.0
423
Downloads
0
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install deepgram-transcribe
Description
Transcribe audio via Deepgram Nova-3 API (5.26% WER, 40x faster than Whisper, built-in speaker diarization). Use when user asks to transcribe audio, podcasts...
README (SKILL.md)
Deepgram Nova-3 Transcription
Transcribe audio files using Deepgram's Nova-3 model — more accurate and faster than OpenAI Whisper.
Why Deepgram over Whisper
- 5.26% word error rate (vs ~8-10% for Whisper)
- 40x faster for batch processing
- Built-in speaker diarization (who said what)
- Smart formatting (numbers, dates, punctuation)
- $200 free credits on signup at deepgram.com
Setup
Store your API key:
echo "YOUR_DEEPGRAM_API_KEY" > ~/.openclaw/secrets/deepgram-api-key.txt
Or set the environment variable:
export DEEPGRAM_API_KEY="your-key-here"
Usage
bash scripts/transcribe.sh /path/to/audio.mp3
bash scripts/transcribe.sh recording.mp3 --out transcript.txt
bash scripts/transcribe.sh recording.mp3 --json --out full.json
bash scripts/transcribe.sh recording.mp3 --language es
bash scripts/transcribe.sh recording.mp3 --model nova-2
Models
| Model | WER | Cost/min | Best for |
|---|---|---|---|
| nova-3 (default) | 5.26% | $0.0077 | Best accuracy |
| nova-2 | ~8% | $0.0043 | Budget-friendly |
| whisper-large | ~8-10% | $0.0048 | Whisper parity |
Supported Formats
mp3, wav, m4a, ogg, flac, webm, aiff
Fallback
If DEEPGRAM_API_KEY is not set, use the OpenAI Whisper skill instead (if installed).
Usage Guidance
This skill is coherent with its stated purpose, but check these before installing:
- It will send audio files to Deepgram (api.deepgram.com). Only use it for audio you are comfortable transmitting to that provider (PII/sensitive content consideration).
- Provide a Deepgram API key either as environment variable DEEPGRAM_API_KEY or by storing it at ~/.openclaw/secrets/deepgram-api-key.txt. Prefer secure file permissions (chmod 600) if you use the secrets file.
- The package metadata did not list required binaries; the script requires bash (already used), curl, and python3 to run. Ensure those are available and up-to-date.
- The script parses remote responses with embedded Python; while it appears to only parse JSON, avoid running it on untrusted systems or modifying it without understanding the parsing behavior.
- If you need offline/local transcription only, consider alternatives; otherwise the behavior and credentials requested are proportionate for a Deepgram integration.
Capability Analysis
Type: OpenClaw Skill
Name: deepgram-transcribe
Version: 1.0.0
The skill bundle is designed for Deepgram audio transcription, and its `SKILL.md` instructions are benign. However, the `scripts/transcribe.sh` script contains a potential shell injection vulnerability. The `$RESPONSE` variable, which holds the Deepgram API's JSON output, is directly embedded into a Python command's string literal (`python3 -c "... d = json.loads('''$RESPONSE''') ..."`). If an attacker could manipulate the Deepgram API response (e.g., via a compromised API or MITM), they could inject arbitrary Python code, leading to remote code execution. This is a vulnerability, not clear malicious intent, hence 'suspicious'.
Capability Assessment
Purpose & Capability
Name/description match the implementation: the script posts audio to Deepgram's API and parses the response. However the registry metadata does not declare the DEEPGRAM_API_KEY environment variable nor the runtime binaries the script uses (bash, curl, python3), which is an omission/inconsistency.
Instruction Scope
SKILL.md and the script limit actions to reading an audio file, reading an API key from DEEPGRAM_API_KEY or ~/.openclaw/secrets/deepgram-api-key.txt, POSTing the audio to api.deepgram.com, and writing transcript output. There are no instructions to read unrelated files or exfiltrate other system data.
Install Mechanism
No install spec (instruction-only plus a local shell script) — nothing is downloaded or extracted. This is the lower-risk model for skills.
Credentials
The skill legitimately requires a Deepgram API key (DEEPGRAM_API_KEY or the file under ~/.openclaw/secrets). That is proportionate for its purpose, but the registry's declared requirements did not list this credential; the omission should be corrected/acknowledged.
Persistence & Privilege
The skill does not request persistent 'always' inclusion and does not modify other skills or system-wide agent settings. It reads/writes only a per-user secret file location and user-specified output files.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install deepgram-transcribe - After installation, invoke the skill by name or use
/deepgram-transcribe - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Deepgram Transcribe?
Transcribe audio via Deepgram Nova-3 API (5.26% WER, 40x faster than Whisper, built-in speaker diarization). Use when user asks to transcribe audio, podcasts... It is an AI Agent Skill for Claude Code / OpenClaw, with 423 downloads so far.
How do I install Deepgram Transcribe?
Run "/install deepgram-transcribe" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Deepgram Transcribe free?
Yes, Deepgram Transcribe is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Deepgram Transcribe support?
Deepgram Transcribe is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Deepgram Transcribe?
It is built and maintained by Jesse Wunderlich (@jessewunderlich); the current version is v1.0.0.
More Skills