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.