openai-whisper-api

openclaw/openclaw · Agent Skill

Transcribes audio files into text using the OpenAI Whisper API. Supports various models and audio formats.

Overview

Publisher	openclawOrganization
Repository	openclaw/openclaw ↗
Skill folder	`openai-whisper-api`
Stars	389,595
Forks	81,898
Bundled files	2
License	MIT
Last updated	September 13, 2026
Links	Skill source ↗ · Repository ↗

Mozgi check

What we found in the skill files. Details come with a subscription.

Security

elevated risk · 3 points need attention

Compatibility

not suitable for every system

Similar skills

133 similar skills found

Also with subscription

Installation

A skill is a folder with a SKILL.md file. Pick your agent and run the commands in a terminal (macOS, Linux or Git Bash on Windows) from your project root.

Copy the prompt into Claude, Codex or another assistant: it will review the skill and install it for you.

Install the “openai-whisper-api” skill from mozgi.io (https://mozgi.io/skills/openai-whisper-api/) for me.

1. Download the archive: https://mozgi.io/skills/openai-whisper-api/download
   If it fails, take the skill folder from the source: https://github.com/openclaw/openclaw/tree/main/skills/openai-whisper-api
2. Read SKILL.md and the other files. Check the skill is safe: no hidden commands, no sending data elsewhere, no scripts doing something other than described. If anything looks suspicious, stop and tell me.
3. Put the “openai-whisper-api” folder into your agent's skills folder: .claude/skills/ for Claude Code, .agents/skills/ for Codex, .cursor/skills/ for Cursor, .gemini/skills/ for Gemini CLI. Inside the project if we are in one, otherwise in the home folder (~/.claude/skills/ etc.).
4. Make sure <skills folder>/openai-whisper-api/SKILL.md exists.
5. Briefly tell me what this skill does and offer to try it on my task.

If you cannot do a step yourself, tell me what to click or type.

git clone --depth 1 --branch main https://github.com/openclaw/openclaw.git /tmp/openclaw
mkdir -p .claude/skills
cp -r /tmp/openclaw/skills/openai-whisper-api .claude/skills/openai-whisper-api

Restart Claude Code — the skill appears in the list; call it manually with /openai-whisper-api. For all projects use ~/.claude/skills.

git clone --depth 1 --branch main https://github.com/openclaw/openclaw.git /tmp/openclaw
mkdir -p .agents/skills
cp -r /tmp/openclaw/skills/openai-whisper-api .agents/skills/openai-whisper-api

Codex looks for skills in .agents/skills from the current folder up to the repo root; call one with /skills or $openai-whisper-api. For all projects use ~/.agents/skills.

git clone --depth 1 --branch main https://github.com/openclaw/openclaw.git /tmp/openclaw
mkdir -p .cursor/skills
cp -r /tmp/openclaw/skills/openai-whisper-api .cursor/skills/openai-whisper-api

Cursor picks the skill up on start; call it with “/” in Agent chat. Cursor also reads .claude/skills and .agents/skills. For all projects use ~/.cursor/skills.

git clone --depth 1 --branch main https://github.com/openclaw/openclaw.git /tmp/openclaw
mkdir -p .gemini/skills
cp -r /tmp/openclaw/skills/openai-whisper-api .gemini/skills/openai-whisper-api

Gemini CLI offers to activate the skill when a task matches — you approve it. For all projects use ~/.gemini/skills.

Review the source files

2 files Download Zip

Read SKILL.md and any companion files before deciding whether to install. Click a file to preview it.

SKILL.md contents

Original author text · read-only

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",
    },
  },
}

Frequently asked questions

What does the openai-whisper-api skill do?

Transcribes audio files into text using the OpenAI Whisper API. Supports various models and audio formats.

How do I install openai-whisper-api?

Open the “Installation” block on this page and pick your agent — Claude Code, Codex, Cursor or Gemini CLI — for ready-made commands that copy the skill folder to the right place. Or copy the prompt from the “Via assistant” tab and let the assistant review and install the skill.

Which AI models work with openai-whisper-api?

Skills are plain Markdown instructions (the Agent Skills format), so openai-whisper-api works with any agent that reads SKILL.md: Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and more. The model loads the instructions only when a task matches the skill's description.

Is openai-whisper-api free?

The skill is published openly by openclaw under the MIT license. The skill itself costs nothing — you only pay your AI provider for the tokens you use.

Is it safe to install skills?

A skill is a set of instructions your agent will follow, so read SKILL.md and its companion files before installing. Scripts in the skill folder only run if your agent runs them — keep an eye on what it does and do not grant unnecessary permissions.

How is a skill different from an MCP server or a plugin?

An MCP server or plugin gives the model new tools — code that runs and returns a result. A skill gives it knowledge and process: how to approach a task, which steps to follow and what good output looks like. It needs no server or API key.

Related skills

All skills →

summarize Summarizes or transcribes content from URLs, videos, podcasts, articles, PDFs, and local files. openclaw390k

marketing-campaign Plans and executes end-to-end marketing campaigns, covering audience research, positioning, content creation, and channel management. affaan-m258k

visa-doc-translate Translates visa application document images to English, creating a bilingual PDF with original and translation. Used for visa application documents. affaan-m258k

grill-me Conducts a detailed interview to refine plans or designs, identifying weaknesses. mattpocock256k

humanizer Enhances text by removing AI-isms and adding a natural human voice, making it more readable and authentic. NousResearch243k

natural-writing Helps create natural, accurate, and readable text by avoiding common AI pitfalls. Ideal for documents, descriptions, and documentation. flutter179k