add-voice-transcription

Transcribe WhatsApp voice messages into text for BioClaw agent context.

401|53|Updated Feb 26, 2026
One-click install
npx skills add https://github.com/Runchuan-BU/BioClaw --skill add-voice-transcription-runchuan-bu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-voice-transcription
Source: https://github.com/Runchuan-BU/BioClaw/tree/main/.claude/skills/add-voice-transcription
Command: npx skills add https://github.com/Runchuan-BU/BioClaw --skill add-voice-transcription-runchuan-bu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many WhatsApp interactions use voice notes that agents cannot read, causing missed context and limiting conversational automation; this Skill converts audio messages into text so the BioClaw agent can understand and act on spoken input.

Core Features & Use Cases

  • Automatic Transcription: Integrates OpenAI Whisper to transcribe incoming WhatsApp voice notes and convert them into plain text stored with message history.
  • Database Integration & Fallbacks: Stores transcribed content in the SQLite database for agent context, with configurable fallback messages when transcription fails.
  • Message-Handler Integration: Hooks into the message upsert pipeline to detect voice notes, run transcription, and persist results; includes guidance to avoid orphaned container issues on restart.
  • Operational Controls: Provides a local transcription configuration file to enable/disable the feature, change providers, and customize fallback content.
  • Use Case: In a registered research WhatsApp group, a user sends a short voice note asking for an analysis; the agent transcribes the note, indexes it, and replies with results based on the transcribed content.

Quick Start

Send a voice note in a registered BioClaw WhatsApp group and the agent will transcribe the audio, store the text, and respond using the transcribed content.

Frequently Asked Questions about add-voice-transcription

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

FAQPage Schema
How do I auto-transcribe WhatsApp voice notes for agent context?

Auto-transcribe WhatsApp voice notes by integrating OpenAI Whisper into the message handler pipeline, converting audio messages into plain text stored in SQLite for agent consumption. The feature hooks into the message upsert pipeline to detect and process voice inputs.

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

Yes, transcribing WhatsApp audio messages requires an OpenAI API key to access the OpenAI Whisper transcription service. You must also configure a local transcription configuration file to connect the provider within your message-processing pipeline.

What happens when WhatsApp voice transcription fails in the pipeline?

When WhatsApp voice transcription fails, the system uses configurable fallback messages defined in the local transcription configuration file. This error handling ensures the message-processing pipeline continues operating without breaking the agent's conversational context.

How does audio transcription integrate with SQLite message history?

Audio transcription integrates with SQLite message history by storing the transcribed text directly in the database during the message upsert pipeline. This allows the agent to index and retrieve the voice note content as conversational context.

Can I disable voice transcription for WhatsApp group chats?

Yes, you can disable voice transcription for WhatsApp group chats by modifying the local transcription configuration file. This operational control allows you to enable or disable the feature and change providers as needed for your registered chats.