Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
steipete avatar

Openai Whisper Api

  • 3.1k installs
  • 385k repo stars
  • Updated August 3, 2026
  • steipete/clawdis

openai-whisper-api is an OpenClaw skill that transcribes local audio through OpenAI /v1/audio/transcriptions using a curl-based transcribe.sh helper.

About

The openai-whisper-api skill wraps OpenAI audio transcriptions through a bundled transcribe.sh script and curl. Default model is gpt-4o-transcribe with text output saved beside the input file as a sibling .txt path. Supported flags switch to gpt-4o-mini-transcribe for lower cost, gpt-4o-transcribe-diarize with JSON speaker labels, legacy whisper-1, explicit language codes, prompt hints for names or jargon, and custom --out paths for JSON transcripts. Upload formats include mp3, mp4, mpeg, mpga, m4a, wav, and webm with a documented 25 MB hosted API limit. OPENAI_API_KEY is required from the environment or OpenClaw skills config, and OPENAI_BASE_URL supports compatible proxies or local gateways. Diarize mode sends chunking_strategy auto and rejects prompt flags per API rules. Install metadata lists curl and node binaries with brew fallback guidance. The skill targets OpenClaw and agent environments that need quick speech-to-text without hand-building multipart HTTP requests.

  • transcribe.sh quick start with gpt-4o-transcribe default and txt output.
  • Model flags for mini, diarize JSON, and legacy whisper-1.
  • OPENAI_BASE_URL override for OpenAI-compatible gateways.
  • Documented 25 MB upload limit and supported audio formats.
  • OpenClaw config apiKey path when env var is not set.

Openai Whisper Api by the numbers

  • 3,146 all-time installs (skills.sh)
  • +159 installs in the week ending Aug 2, 2026 (Skillselion tracking)
  • Ranked #248 of 16,556 AI & Agent Building skills by installs in the Skillselion catalog
  • Security screen: MEDIUM risk (skills.sh audit)
  • Data as of Aug 3, 2026 (Skillselion catalog sync)
At a glance

openai-whisper-api capabilities & compatibility

Capabilities
gpt 4o transcribe default transcription script · diarized json output with chunking_strategy auto · language and prompt hint flags · openai_base_url compatible gateway support · multiple audio format upload support
Works with
openai
Use cases
transcription · orchestration
Pricing
Bring your own API key
From the docs

What openai-whisper-api says it does

25 MB upload limit on the hosted API.
SKILL.md
npx skills add https://github.com/steipete/clawdis --skill openai-whisper-api

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs3.1k
repo stars385k
Security audit3 / 3 scanners passed
Last updatedAugust 3, 2026
Repositorysteipete/clawdis

How do I turn a local m4a or mp3 into text with OpenAI transcription models from an agent environment?

Transcribe local audio files through OpenAI /v1/audio/transcriptions with gpt-4o-transcribe, mini, diarize, or whisper-1 models via curl script.

Who is it for?

Agent setups that already have OPENAI_API_KEY and need a documented curl script for common transcription flags.

Skip if: Skip for real-time streaming transcription, on-device offline STT, or audio longer than the hosted 25 MB limit without chunking.

When should I use this skill?

User asks to transcribe audio, convert speech to text, or run gpt-4o-transcribe on a local file.

What you get

A .txt or .json transcript file beside the input audio using the selected OpenAI transcription model.

  • Transcription text from audio files

By the numbers

  • Supports 4 OpenAI transcription models: gpt-4o-transcribe, mini, diarize, and whisper-1

Files

SKILL.mdMarkdownGitHub ↗

OpenAI transcriptions API

Transcribe audio through /v1/audio/transcriptions. Set OPENAI_BASE_URL for an OpenAI-compatible proxy or local gateway.

Quick start

{baseDir}/scripts/transcribe.sh /path/to/audio.m4a

Defaults:

  • Model: gpt-4o-transcribe
  • Output: <input>.txt

Useful flags

{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-transcribe --out /tmp/transcript.txt
{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-mini-transcribe
{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model gpt-4o-transcribe-diarize --json
{baseDir}/scripts/transcribe.sh /path/to/audio.ogg --model whisper-1
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --language en
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --prompt "Speaker names: Peter, Daniel"
{baseDir}/scripts/transcribe.sh /path/to/audio.m4a --json --out /tmp/transcript.json

Notes:

  • Supported upload formats include mp3, mp4, mpeg, mpga, m4a, wav, webm.
  • 25 MB upload limit on the hosted API.
  • Use diarize for speaker labels; script sends chunking_strategy=auto and rejects --prompt.

API key

Set OPENAI_API_KEY, or configure it in the active OpenClaw config file ($OPENCLAW_CONFIG_PATH, default ~/.openclaw/openclaw.json). Optionally set OPENAI_BASE_URL:

{
  skills: {
    "openai-whisper-api": {
      apiKey: "OPENAI_KEY_HERE",
    },
  },
}

Related skills

FAQ

Which transcription models are supported?

gpt-4o-transcribe, gpt-4o-mini-transcribe, gpt-4o-transcribe-diarize, and whisper-1 via transcribe.sh flags.

Where is the API key configured?

Set OPENAI_API_KEY in the environment or under skills.openai-whisper-api.apiKey in OpenClaw config.

Can I use a custom OpenAI base URL?

Yes. Set OPENAI_BASE_URL for an OpenAI-compatible proxy or local gateway before running transcribe.sh.

Is Openai Whisper Api safe to install?

skills.sh reports 3 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

AI & Agent Buildingllmautomation

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.