add-voice-transcription
Skill1 starsChanged 9 months agoMITView on GitHub
Add voice message transcription to NanoClaw using OpenAI's Whisper API. Automatically transcribes WhatsApp voice notes so the agent can read and respond to them.
- Reads credentials
4 other projects use a version of this, 2 of them edited.
Adopted by
Most recently taken up by
- juancruzmunozalbelo/swarmclawtheir own version, first seen Oct 8, 2026
- Runchuan-BU/BioClawtheir own version, first seen Aug 2, 2026
- b1rdmania/ghostclawedited, first seen May 3, 2026
- DingyangLyu/MatClawedited, first seen Mar 17, 2026
Other versions4 projects use a version of this.
Word for word · 0
None found.
Edited · 2
- DingyangLyu/MatClaw★ 9893% same
- b1rdmania/ghostclaw★ 9165% same
Wrote their own version · 2
- Runchuan-BU/BioClaw★ 405same name
- juancruzmunozalbelo/swarmclaw★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository20 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- add-discordSkill
- add-gmailSkill
- add-image-visionSkill
- add-ollama-toolSkill
- add-parallelSkill
- add-pdf-readerSkill
- add-slackSkill
- add-telegramSkill
- add-telegram-swarmSkill
- add-whatsappSkill
- convert-to-apple-containerSkill
- customizeSkill
- debugSkill
- get-qodo-rulesSkill
- qodo-pr-resolverSkill
- setupSkill
- update-nanoclawSkill
- use-local-whisperSkill
- x-integrationSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
14 rules. 0 are common, 9 are distinctive, and 5 are very specific to this project.
0
Common
Most of the 4 edited versions we read keep these.
9
Distinctive
This author's own choices. Worth a look.
5
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 14
Read .nanoclaw/state.yaml.
- Very specific: line 18
Use AskUserQuestion to collect information:
- Distinctive: line 22
If yes, collect it now. If no, direct them to create one at https://platform.openai.com/api-keys.
- Distinctive: line 26
Run the skills engine to apply this skill's code package.
- Very specific: line 30
If .nanoclaw/ directory doesn't exist yet:
- Distinctive: line 50
If the apply reports merge conflicts, read the intent files:
- Distinctive: line 61
All tests must pass (including the 3 new voice transcription tests) and build must be clean before proceeding.
- Distinctive: line 67
If the user doesn't have an API key:
- Distinctive: line 78
Wait for the user to provide the key.
- Very specific: line 128
Check OPENAI_API_KEY is set in .env AND synced to data/env/env
- Very specific: line 129
Verify key works: curl -s https://api.openai.com/v1/models -H "Authorization: Bearer $OPENAI_API_KEY" | head -c 200
- Distinctive: line 130
Check OpenAI billing — Whisper requires a funded account
- Distinctive: line 134
Check logs for the specific error.
- Distinctive: line 141
Verify the chat is registered and the agent is running.
“Common” is measured: kept by at least 6 in 10 of the 4 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Add Voice Transcription
This skill adds automatic voice message transcription to NanoClaw's WhatsApp channel using OpenAI's Whisper API. When a voice note arrives, it is downloaded, transcribed, and delivered to the agent as [Voice: <transcript>].
Phase 1: Pre-flight
Check if already applied
Read .nanoclaw/state.yaml. If voice-transcription is in applied_skills, skip to Phase 3 (Configure). The code changes are already in place.
Ask the user
Use AskUserQuestion to collect information:
AskUserQuestion: Do you have an OpenAI API key for Whisper transcription?
If yes, collect it now. If no, direct them to create one at https://platform.openai.com/api-keys.
Phase 2: Apply Code Changes
Run the skills engine to apply this skill's code package.
Initialize skills system (if needed)
If .nanoclaw/ directory doesn't exist yet:
npx tsx scripts/apply-skill.ts --initApply the skill
npx tsx scripts/apply-skill.ts .claude/skills/add-voice-transcriptionThis deterministically:
- Adds
src/transcription.ts(voice transcription module using OpenAI Whisper) - Three-way merges voice handling into
src/channels/whatsapp.ts(isVoiceMessage check, transcribeAudioMessage call) - Three-way merges transcription tests into
src/channels/whatsapp.test.ts(mock + 3 test cases) - Installs the
openainpm dependency - Updates
.env.examplewithOPENAI_API_KEY - Records the application in
.nanoclaw/state.yaml
If the apply reports merge conflicts, read the intent files:
modify/src/channels/whatsapp.ts.intent.md— what changed and invariants for whatsapp.tsmodify/src/channels/whatsapp.test.ts.intent.md— what changed for whatsapp.test.ts
Validate code changes
npm test
npm run buildAll tests must pass (including the 3 new voice transcription tests) and build must be clean before proceeding.
Phase 3: Configure
Get OpenAI API key (if needed)
If the user doesn't have an API key:
I need you to create an OpenAI API key:
- Go to https://platform.openai.com/api-keys
- Click "Create new secret key"
- Give it a name (e.g., "NanoClaw Transcription")
- Copy the key (starts with
sk-)Cost:
$0.006 per minute of audio ($0.003 per typical 30-second voice note)
Wait for the user to provide the key.
Add to environment
Add to .env:
OPENAI_API_KEY=<their-key>Sync to container environment:
mkdir -p data/env && cp .env data/env/envThe container reads environment from data/env/env, not .env directly.
Build and restart
npm run build
launchctl kickstart -k gui/$(id -u)/com.nanoclaw # macOS
# Linux: systemctl --user restart nanoclawPhase 4: Verify
Test with a voice note
Tell the user:
Send a voice note in any registered WhatsApp chat. The agent should receive it as
[Voice: <transcript>]and respond to its content.
Check logs if needed
tail -f logs/nanoclaw.log | grep -i voiceLook for:
Transcribed voice message— successful transcription with character countOPENAI_API_KEY not set— key missing from.envOpenAI transcription failed— API error (check key validity, billing)Failed to download audio message— media download issue
Troubleshooting
Voice notes show "[Voice Message - transcription unavailable]"
- Check
OPENAI_API_KEYis set in.envAND synced todata/env/env - Verify key works:
curl -s https://api.openai.com/v1/models -H "Authorization: Bearer $OPENAI_API_KEY" | head -c 200 - Check OpenAI billing — Whisper requires a funded account
Voice notes show "[Voice Message - transcription failed]"
Check logs for the specific error. Common causes:
- Network timeout — transient, will work on next message
- Invalid API key — regenerate at https://platform.openai.com/api-keys
- Rate limiting — wait and retry
Agent doesn't respond to voice notes
Verify the chat is registered and the agent is running. Voice transcription only runs for registered groups.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

