skills.rest
webboty
webbotyCOMMUNITY
Explore all skills by this author →
GitHub

add-voice-transcription

Transcribe WhatsApp voice notes into text using OpenAI Whisper.

Updated Feb 24, 2026
Search Tags:#transcription#audio#whatsapp#nanoclaw#openai-whisper#voice-transcription#baileys
One-click install
npx skills add https://github.com/webboty/flexclaw --skill add-voice-transcription-webboty
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-voice-transcription
Source: https://github.com/webboty/flexclaw/tree/main/.claude/skills/add-voice-transcription
Command: npx skills add https://github.com/webboty/flexclaw --skill add-voice-transcription-webboty

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Agents running in NanoClaw's WhatsApp channel cannot read or act on audio-only voice notes, which forces human intervention and slows automated responses; this Skill converts audio messages into readable text so agents can process and reply to voice content automatically.

Core Features & Use Cases

  • Automatic transcription: Downloads WhatsApp PTT audio, transcribes it using OpenAI Whisper, and delivers the transcript as agent-readable content.
  • Integration with NanoClaw/WhatsApp: Adds a transcription module, integrates into the Baileys-based WhatsApp channel handler, and records behavior with tests and manifest metadata.
  • Robust fallbacks and testing: Provides clear fallback messages when API keys are missing, transcription fails, or downloads error, and includes unit tests that mock transcription behavior.
  • Use Cases: Customer support teams receiving voice notes, group chat automation that must parse spoken instructions, and accessibility improvements for users who prefer text.

Quick Start

Enable the skill, provide an OpenAI API key (OPENAI_API_KEY), and send a WhatsApp voice note to see it arrive as a transcribed text message for the agent.

Frequently Asked Questions about add-voice-transcription

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automatically transcribe WhatsApp voice notes into text for my agents?▼

To enable WhatsApp voice transcription, you must set the OPENAI_API_KEY environment variable. The Skill uses this key to authenticate OpenAI Whisper API requests, returning readable text or a fallback message if missing.

Can I use OpenAI Whisper to convert WhatsApp audio messages in NanoClaw?▼

Yes, this Skill works with NanoClaw's WhatsApp channel to download PTT audio files and call OpenAI Whisper for transcription. The resulting text is delivered directly to agents for automated processing and response.

What happens if WhatsApp voice transcription fails or the API key is missing?▼

If transcription fails, downloads error, or the OPENAI_API_KEY is missing, the Skill implements clear fallback messages. It also includes unit tests that mock transcription behavior to handle these failure modes robustly.

Do I need an OpenAI API key to transcribe WhatsApp voice notes?▼

Yes, an OPENAI_API_KEY environment variable is required to transcribe WhatsApp voice notes. The Skill relies on this key to access OpenAI Whisper for converting audio messages into agent-readable text.

What is the best way to handle audio-only WhatsApp messages for customer support automation?▼

The best way to handle audio-only WhatsApp messages is automatic transcription. This Skill converts voice notes to text using OpenAI Whisper, enabling agents to parse spoken instructions and reply without human intervention.

Related Skills

Explore More Software Engineering Skills→
Arno37Arno37

add-voice-transcription

Transcribe WhatsApp voice messages into text using OpenAI's Whisper API.

Community
Advanced
cxnaivecxnaive

yuanbao

Manage Yuanbao group members and dispatch messages via the gateway.

Community
Intermediate
reasonlayerreasonlayer

add-whatsapp

Add WhatsApp as a channel to NanoClaw using Baileys and Node.js.

Official
Advanced
wientjeswientjes

add-voice-transcription

Transcribe WhatsApp voice messages into text using OpenAI Whisper.

Community
Intermediate