add-voice-transcription

Transcribe WhatsApp voice messages into readable text for agents.

Updated Mar 12, 2026
One-click install
npx skills add https://github.com/theowenyoung/nanoclaw --skill add-voice-transcription-theowenyoung
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: add-voice-transcription
Source: https://github.com/theowenyoung/nanoclaw/tree/main/.claude/skills/add-voice-transcription
Command: npx skills add https://github.com/theowenyoung/nanoclaw --skill add-voice-transcription-theowenyoung

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many WhatsApp voice notes are inaccessible to chat agents and humans who prefer text; this Skill turns PTT audio into readable text so agents can understand and respond to voice messages without manual listening.

Core Features & Use Cases

  • Automatic transcription: Downloads incoming WhatsApp PTT audio and converts it into text delivered to the agent as [Voice: <transcript>].
  • OpenAI Whisper integration: Uses the OpenAI Whisper API with an OPENAI_API_KEY and includes fallbacks for missing keys, API errors, and download failures.
  • Developer-friendly packaging: Adds deterministic code changes, unit tests, and a manifest to apply the skill safely into NanoClaw with clear intent files for merges.
  • Use case: Enable agents to read and act on voice notes from registered WhatsApp groups, improving accessibility and automation for conversational workflows.

Quick Start

Send a voice note to any registered WhatsApp chat and confirm the agent receives it as [Voice: <transcript>].

Frequently Asked Questions about add-voice-transcription

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

FAQPage Schema
How do I transcribe WhatsApp voice notes into text for a chat agent?▼

WhatsApp voice transcription uses OpenAI Whisper to convert PTT audio messages into text, delivering the transcript to your agent as a readable message for automatic processing.

Do I need an OpenAI API key to transcribe WhatsApp audio messages?▼

Yes, an OpenAI API key is required for WhatsApp audio transcription. The system includes fallback messages to handle API errors, missing keys, or download failures gracefully.

Can I use Node.js and Baileys to convert WhatsApp voice messages to text?▼

Yes, this Node.js solution uses Baileys media download support to fetch incoming WhatsApp PTT audio and transcribe it into text for agent consumption in registered groups.

How does a chat agent handle incoming WhatsApp PTT audio files?▼

The agent receives transcribed WhatsApp PTT audio as a formatted text message, allowing it to understand and respond to voice notes without manual listening or human intervention.

What happens if the OpenAI Whisper API fails during voice transcription?▼

If the OpenAI Whisper API fails during voice transcription, the system provides clear fallback messages to handle API errors, missing keys, or download failures without crashing.

Is there a way to automatically convert WhatsApp voice notes to text in registered groups?▼

Automatic transcription downloads incoming WhatsApp PTT audio from registered groups and converts it into readable text, injecting the transcript directly into the message handling workflow.