add-voice-transcription

Transcribe WhatsApp voice notes to text using OpenAI Whisper.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires openai, @whiskeysockets/baileys.

What problem does it solve?

This skill adds automatic transcription of WhatsApp voice notes using OpenAI Whisper so the NanoClaw agent can read and respond to voice messages.

Core Features & Use Cases

  • Transcribes voice messages using OpenAI Whisper and presents transcripts as [Voice: <transcript>].
  • Falls back to a readable placeholder when transcription is unavailable or fails.
  • Integrates with the skills pipeline to store transcripts and expose them to the agent.

Quick Start

Enable Whisper transcription and provide your OpenAI API key to begin transcribing voice notes.

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 using OpenAI Whisper?

You can transcribe WhatsApp voice notes using OpenAI Whisper by deploying a skill that downloads the audio and sends it to the Whisper API. It returns the transcript formatted as [Voice: <transcript>] for the agent to read.

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

Yes, you need an active OpenAI API key configured in your environment to transcribe audio messages. The skill uses this key to authenticate requests to the Whisper API for processing voice notes.

What happens if Whisper audio transcription fails or is unavailable?

If Whisper audio transcription fails or the service is unavailable, the skill falls back to a readable placeholder. This ensures the pipeline continues processing without breaking the WhatsApp chat flow.

How does voice transcription integrate into the WhatsApp automation flow?

Voice transcription integrates into the WhatsApp automation flow by downloading the received audio file, processing it with Whisper, and presenting the text transcript to the agent within the NanoClaw WhatsApp channel.

Can I use Baileys to automate WhatsApp audio transcription?

Yes, you can use Baileys to automate WhatsApp audio transcription. The skill relies on the @whiskeysockets/baileys package to handle the WhatsApp integration and facilitate downloading voice notes for transcription.

What is the best way to handle voice messages in a WhatsApp agent?

The best way to handle voice messages in a WhatsApp agent is to automatically transcribe them using Whisper. This converts spoken audio into readable text, allowing the agent to understand and respond to voice notes seamlessly.