← Back to Skills Marketplace
Free Groq Voice Recognition
by
huixionghexiyi
· GitHub ↗
· v1.0.0
1084
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install free-groq-voice
Description
FREE voice recognition using Groq's complimentary Whisper API. Transcribe audio messages to text in 50+ languages at no cost. Perfect for voice-to-text autom...
README (SKILL.md)
Free Groq Voice Recognition
Overview
100% FREE voice recognition powered by Groq's complimentary Whisper API (whisper-large-v3 model). No credit card required, no usage limits.
Convert audio messages, voice notes, and recordings to text in 50+ languages. Perfect for:
- 🎙️ Voice message transcription
- 📝 Meeting notes
- ♿ Accessibility features
- 🤖 Voice-controlled automation
Cost: $0.00
- ✅ Completely free Groq API tier
- ✅ No credit card needed
- ✅ No monthly fees
- ✅ Generous rate limits
- ✅ Whisper-large-v3 model (most accurate)
Setup
1. Get Your FREE Groq API Key
- Visit https://console.groq.com/
- Sign up for free (takes 30 seconds)
- Navigate to API Keys
- Create a new API key
- Copy the key
That's it! No payment required.
2. Configure Proxy (If in Restricted Regions)
Groq API may require a proxy in certain regions (e.g., mainland China).
Add to your TOOLS.md:
### Proxy Settings
- HTTP Proxy: http://127.0.0.1:7890
### Voice Recognition (FREE Groq Whisper)
- API Key: gsk_your_key_here
- Model: whisper-large-v3
- Language: zh (or your preferred language)
- Requires Proxy: Yes (if in restricted region)
3. Test the Skill
Send a voice message and ask me to transcribe it!
Usage Examples
Basic Transcription:
User: [sends voice message]
You: You said: "你好，这是一条测试消息"
With Language Hint:
User: 识别这段英文语音
You: [automatically uses language=en]
Batch Processing:
User: 帮我识别这个文件夹里所有的语音文件
You: [processes all .ogg/.mp3/.wav files]
Supported Languages
- 🇨🇳 Chinese (zh) - Mandarin, Cantonese
- 🇺🇸 English (en) - US, UK, Australian
- 🇯🇵 Japanese (ja)
- 🇰🇷 Korean (ko)
- 🇫🇷 French (fr)
- 🇩🇪 German (de)
- 🇪🇸 Spanish (es)
- 🇮🇹 Italian (it)
- 🇵🇹 Portuguese (pt)
- 🇷🇺 Russian (ru)
- ... and 40+ more
Technical Details
API Endpoint:
https://api.groq.com/openai/v1/audio/transcriptions
Model: whisper-large-v3 (OpenAI's most accurate model)
Supported Formats:
- OGG/OPUS (Feishu, Telegram default)
- MP3
- WAV
- M4A
- WebM
Proxy Requirements:
- Use HTTP proxy (not SOCKS5)
- Default:
http://127.0.0.1:7890
Troubleshooting
❌ "Forbidden" Error:
- Check API key is valid
- Ensure proxy is configured (if in restricted region)
- Try HTTP proxy instead of SOCKS5
❌ "File Not Found":
- Check file path is absolute
- Ensure file exists
❌ Slow Response:
- Check proxy speed
- Groq API is usually fast (\x3C 1s for short audio)
Privacy & Security
- ✅ Audio processed by Groq's API (not stored permanently)
- ✅ API key stored locally in your TOOLS.md
- ✅ No data sent to third parties
- ✅ Open-source and auditable
Why Groq?
FREE vs Paid Alternatives:
| Service | Cost | Accuracy | Speed |
|---|---|---|---|
| Groq (FREE) | $0 | ⭐⭐⭐⭐⭐ | ⚡⚡⚡⚡⚡ |
| OpenAI Whisper | $0.006/min | ⭐⭐⭐⭐⭐ | ⚡⚡⚡ |
| Google Speech | $0.006/min | ⭐⭐⭐⭐ | ⚡⚡⚡⚡ |
| AWS Transcribe | $0.024/min | ⭐⭐⭐⭐ | ⚡⚡⚡ |
Groq's free tier offers:
- Same Whisper-large-v3 model as OpenAI
- Faster inference (Groq's LPU chip)
- No usage limits (fair use policy)
- No credit card required
Contributing
Want to improve this skill?
- Fork on ClawHub
- Submit improvements
- Share with the community
License
MIT - Free to use, modify, and distribute.
Enjoy FREE voice recognition! 🎉
No more paying for transcription services. Groq's complimentary API makes professional-grade speech-to-text accessible to everyone.
Usage Guidance
This skill's behavior (curl to api.groq.com with Authorization) matches its claimed purpose, but the package metadata is incomplete. Before installing: 1) Treat your GROQ_API_KEY as a secret — do not paste it into shared or public files; prefer storing it as an environment variable or in a secure vault rather than plaintext TOOLS.md. 2) Ensure your environment has curl, jq and bash available (transcribe.sh uses jq to extract .text). 3) Verify Groq's free-tier terms on https://console.groq.com/ to confirm the "100% free, no limits" claim. 4) If you need auditing or least privilege, ask the publisher to update the registry metadata to declare GROQ_API_KEY as a required credential and list required binaries (jq, curl). 5) If you are in a restricted network and must use a proxy, confirm the proxy address and understand that traffic (audio and API key in Authorization header) will be sent to api.groq.com. 6) If you want higher confidence, request the author to provide provenance (homepage or source repo) and a signed update to the metadata; without that, treat the skill as functional but inconsistently documented.
Capability Analysis
Type: OpenClaw Skill
Name: free-groq-voice
Version: 1.0.0
The skill is classified as suspicious due to its core functionality being implemented in a bash script (`transcribe.sh`), which inherently carries a higher risk of command injection vulnerabilities compared to more sandboxed execution environments. While the script's `curl` command appears to quote variables reasonably well and includes a file existence check, the use of shell execution for processing user-provided file paths (`AUDIO_FILE`) and language hints (`LANGUAGE`) introduces a potential attack surface for sophisticated prompt injection against the AI agent, which could lead to shell injection if not perfectly handled. Additionally, the script performs outbound network requests and reads local files, which are necessary for its function but represent risky capabilities without clear malicious intent from the skill author.
Capability Assessment
Purpose & Capability
The skill's purpose (Groq Whisper transcription) is consistent with the included transcribe.sh and SKILL.md. However the registry metadata declares no required environment variables or binaries while the runtime files clearly require GROQ_API_KEY and the jq binary (and the README mentions a Bash shell). This mismatch between declared requirements and actual needs is an incoherence.
Instruction Scope
SKILL.md and transcribe.sh stay within transcription scope (calling Groq's /audio/transcriptions endpoint and processing audio files). The docs advise storing the API key in a local TOOLS.md and support batch processing of audio files; these are reasonable for the task but the instructions don't specify secure handling of the key and implicitly allow processing arbitrary files in a folder, which increases risk if misused.
Install Mechanism
No install spec is provided (instruction-only plus a small shell script), so nothing is downloaded or executed during install. That's low-risk. Note: the script depends on external tools (curl, jq, bash), but the metadata didn't declare those dependencies.
Credentials
Functionality reasonably requires a single API credential (GROQ_API_KEY) and optionally a GROQ_PROXY setting — that is proportionate. The problem is the skill registry declares no required env vars or primary credential, which is misleading and prevents platform-level controls or warning about secret use.
Persistence & Privilege
The skill does not request always:true, does not modify other skills, and has no install-time persistence. It only expects the operator to provide an API key/config locally; no elevated platform privileges are requested.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install free-groq-voice - After installation, invoke the skill by name or use
/free-groq-voice - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release - 100% FREE voice recognition using Groq's complimentary Whisper API
Metadata
Frequently Asked Questions
What is Free Groq Voice Recognition?
FREE voice recognition using Groq's complimentary Whisper API. Transcribe audio messages to text in 50+ languages at no cost. Perfect for voice-to-text autom... It is an AI Agent Skill for Claude Code / OpenClaw, with 1084 downloads so far.
How do I install Free Groq Voice Recognition?
Run "/install free-groq-voice" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Free Groq Voice Recognition free?
Yes, Free Groq Voice Recognition is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Free Groq Voice Recognition support?
Free Groq Voice Recognition is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Free Groq Voice Recognition?
It is built and maintained by huixionghexiyi (@huixionghexiyi); the current version is v1.0.0.
More Skills