Awesome-openclaw-skills openrouter-transcribe

Transcribe audio files via OpenRouter using audio-capable models (Gemini, GPT-4o-audio, etc).

install

source · Clone the upstream repo

git clone https://github.com/sundial-org/awesome-openclaw-skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/openrouter-transcribe" ~/.claude/skills/sundial-org-awesome-openclaw-skills-openrouter-transcribe && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/sundial-org/awesome-openclaw-skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/openrouter-transcribe" ~/.openclaw/skills/sundial-org-awesome-openclaw-skills-openrouter-transcribe && rm -rf "$T"

manifest: skills/openrouter-transcribe/SKILL.md

source content

OpenRouter Audio Transcription

Transcribe audio files using OpenRouter's chat completions API with

input_audio

content type. Works with any audio-capable model.

Quick start

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

Output goes to stdout.

Useful flags

# Custom model (default: google/gemini-2.5-flash)
{baseDir}/scripts/transcribe.sh audio.ogg --model openai/gpt-4o-audio-preview

# Custom instructions
{baseDir}/scripts/transcribe.sh audio.m4a --prompt "Transcribe with speaker labels"

# Save to file
{baseDir}/scripts/transcribe.sh audio.m4a --out /tmp/transcript.txt

# Custom caller identifier (for OpenRouter dashboard)
{baseDir}/scripts/transcribe.sh audio.m4a --title "MyApp"

How it works

Converts audio to WAV (mono, 16kHz) using ffmpeg
Base64 encodes the audio
Sends to OpenRouter chat completions with
```
input_audio
```
content
Extracts transcript from response

API key

Set

OPENROUTER_API_KEY

env var, or configure in

~/.clawdbot/clawdbot.json

{
  skills: {
    "openrouter-transcribe": {
      apiKey: "YOUR_OPENROUTER_KEY"
    }
  }
}

Headers

The script sends identification headers to OpenRouter:

```
X-Title
```
: Caller name (default: "Peanut/Clawdbot")
```
HTTP-Referer
```
: Reference URL (default: "https://clawdbot.com")

These show up in your OpenRouter dashboard for tracking.

Troubleshooting

ffmpeg format errors: The script uses a temp directory (not

mktemp -t file.wav

) because macOS's mktemp adds random suffixes after the extension, breaking format detection.

Argument list too long: Large audio files produce huge base64 strings that exceed shell argument limits. The script writes to temp files (

--rawfile

for jq,

@file

for curl) instead of passing data as arguments.

Empty response: If you get "Empty response from API", the script will dump the raw response for debugging. Common causes:

Invalid API key
Model doesn't support audio input
Audio file too large or corrupted