skills.rest
wientjes
wientjesCOMMUNITY
Explore all skills by this author →
GitHub

add-voice-transcription

Transcribe WhatsApp voice messages into text using OpenAI Whisper.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many WhatsApp voice notes arrive as audio blobs that agents cannot read, making it difficult for NanoClaw to understand and respond to voice messages. This Skill automates downloading and transcribing PTT audio so the agent receives readable, searchable text instead of opaque audio attachments.

Core Features & Use Cases

  • Automatic Transcription: Downloads WhatsApp PTT audio and transcribes it with OpenAI Whisper, delivering transcripts as readable message content.
  • Robust Integration: Integrates into NanoClaw's WhatsApp channel, preserving existing message handling, LID translation, and group discovery.
  • Safe Fallbacks & Tests: Provides clear fallback messages when the API key is missing or transcription fails, and includes unit tests and manifest for deterministic application.
  • Use Case: A user sends a WhatsApp voice note in a registered group and the agent receives and responds to the message as [Voice: <transcript>] without manual steps.

Quick Start

Enable the add-voice-transcription skill, provide your OpenAI API key when prompted, and send a WhatsApp voice note to a registered group to see it transcribed.

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 for an agent to read?▼

To transcribe WhatsApp voice notes automatically, you can use a Skill that downloads incoming PTT audio and converts it to text using OpenAI Whisper. This delivers readable transcripts directly to the agent, allowing it to process voice messages without manual intervention.

What happens to WhatsApp voice messages if the OpenAI API key is missing?▼

If the OpenAI API key is missing during WhatsApp voice transcription, the system provides a clear fallback message instead of failing. This ensures the message handling pipeline remains intact and alerts you to the missing configuration.

Can I use OpenAI Whisper to transcribe audio attachments in a Node.js WhatsApp channel?▼

Yes, you can use OpenAI Whisper to transcribe audio attachments in a Node.js WhatsApp channel. The integration operates within the channel's message handling, downloading PTT audio and sending it to Whisper for transcription before delivering the text.

Does adding voice transcription require installing new npm dependencies?▼

Yes, adding voice transcription requires installing the OpenAI npm dependency. This package is necessary to interface with the Whisper API and convert downloaded WhatsApp PTT audio files into readable text transcripts.

How do I handle transcription failures when processing WhatsApp audio messages?▼

To handle transcription failures when processing WhatsApp audio messages, the system includes built-in fallback messages. When OpenAI Whisper fails to transcribe the PTT audio, it alerts the group chat with an error message instead of crashing the agent.

Related Skills

Explore More Software Engineering Skills→
clsandovalclsandoval

add-voice-transcription

Transcribe WhatsApp voice notes to text using OpenAI Whisper.

Community
Advanced
IDEA-XLIDEA-XL
30

add-voice-transcription

Transcribe WhatsApp voice messages with OpenAI Whisper and store transcripts.

Official
Advanced
theowenyoungtheowenyoung

add-voice-transcription

Transcribe WhatsApp voice messages into readable text for agents.

Community
Intermediate
kaivyykaivyy
20

openai-whisper

Transcribe local audio files to text using the OpenAI Whisper CLI.

Community
Basic