A command-line utility for high-accuracy audio transcription leveraging the OpenAI Whisper API via Openclaw Skills.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mh-openai-whisper-api
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install mh-openai-whisper-api using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is OpenAI Whisper API Transcription?
The OpenAI Whisper API skill is a robust transcription tool designed to interface directly with the OpenAI whisper-1 model. As a featured part of Openclaw Skills, it allows users to process audio files via the /v1/audio/transcriptions endpoint using a simple curl-based wrapper. This tool is ideal for developers who need reliable speech-to-text capabilities without complex library dependencies.
By utilizing this skill within the Openclaw Skills framework, you gain the ability to handle various audio formats and receive structured text or JSON outputs. It bridges the gap between raw audio data and actionable text content, making it an essential component for any AI-driven automation pipeline.
OpenAI Whisper API Transcription Use Cases
- Transcribing meeting recordings and interviews for documentation purposes.
- Converting podcast episodes into searchable text transcripts.
- Generating captions for video content through automated Openclaw Skills workflows.
- Extracting notes from voice memos for personal knowledge management.
How OpenAI Whisper API Transcription Works
- The user initiates the transcription script providing the path to an audio file.
- The skill validates the presence of the required OpenAI API key and curl utility.
- A network request is constructed including optional flags like language, prompts, or model selection.
- The audio data is transmitted to OpenAI's servers for processing by the Whisper model.
- The skill receives the transcribed text and saves it to the specified output directory as a text or JSON file.
OpenAI Whisper API Transcription Setup
To get started with this component of Openclaw Skills, ensure you have curl installed and an active OpenAI API key. Set your environment variable:
export OPENAI_API_KEY='your_api_key_here'
Or configure it within your local Openclaw Skills configuration file (~/.openclaw/openclaw.json):
{
"skills": {
"openai-whisper-api": {
"apiKey": "YOUR_API_KEY"
}
}
}
Run the transcription command:
./scripts/transcribe.sh /path/to/audio.m4a
OpenAI Whisper API Transcription Data Schema & Taxonomy
This skill generates output files based on the input filename and selected flags. The data organization is as follows:
| Feature | Description |
|---|---|
| Default Output | Saves a .txt file with the same name as the input audio file. |
| JSON Output | Generates a .json file containing full API metadata when the --json flag is used. |
| Custom Path | Allows redirection of output data to a specific directory using the --out parameter. |
| Metadata | Includes model version (whisper-1) and language identifiers if provided. |
OpenAI Whisper API Transcription Advanced Features
- Custom prompting to improve transcription accuracy for technical jargon or specific speaker names.
- Explicit language tagging to bypass auto-detection and speed up processing.
- Formatted JSON output for seamless integration with other Openclaw Skills and data pipelines.
- Support for multiple audio formats including .m4a, .mp3, .ogg, and .wav.
SKILL.md
Loading
Related Openclaw Skills
Obsidian Vault Automation
A powerful integration for managing Obsidian vaults, enabling automated note creation, searching, and link-safe refactoring via the command line.
Notion
A professional-grade integration for Openclaw Skills to programmatically manage Notion pages, data sources, and content blocks.
Healthcheck: Host Security Hardening
A dedicated security auditing and host hardening skill for Openclaw Skills deployments that balances risk tolerance with system usability.
blogwatcher
A lightweight CLI utility for tracking and managing updates from blogs and RSS/Atom feeds.
OpenAI Whisper (CLI)
A high-performance local speech-to-text engine that transcribes audio files without requiring an internet connection or API keys.
session-logs
Empower your AI agent to search, filter, and analyze its own historical conversation logs and usage metrics.
Featured*
