TG Voice Whisper Transcriber

name: tg-voice-whisper

description: Auto-transcribe Telegram voice messages (.ogg Opus) to text using local OpenAI Whisper (tiny model). Reply with transcription + auto-delete file for privacy. No API keys, fully offline after install.

emoji: 🎙️🔊

requires:

bins: [whisper, ffmpeg]

install:

• kind: apt

packages: [ffmpeg]

• kind: pip

packages: [openai-whisper]

flags: [--break-system-packages]

min-server: 4GB RAM recommended for fast/stable work (cached model <1s transcribe on 1vCPU).

Safe: Local-only, auto-rm files, no external APIs/credentials stored.

Usage (agent):

When voice .ogg arrives in /root/.openclaw/media/inbound/:

exec 'whisper PATH --model tiny --language ru --output_format txt --output_dir /tmp/whisper; text=$(cat /tmp/whisper/*.txt); message action=send message="🔊 [text]" reply_to_current; rm PATH /tmp/whisper/*'

Auto-setup (non-block):

Spawn sub-agent or cron every 5s:

sessions_spawn task="LOOP: find /root/.openclaw/media/inbound/*.ogg -mmin -1 → background whisper ru tiny → message reply text → rm" label="voice-auto" cleanup="keep"

Or cron:

cron add job={"name":"voice-auto","schedule":{"kind":"every","everyMs":5000},"payload":{"kind":"systemEvent","text":"🔊 VOICE_CHECK"},"sessionTarget":"main"}

Test:

whisper /path.ogg --model tiny --language ru

Notes:

• First run: ~15s model download (72MB ~/.cache/whisper/tiny.bin).
• Cached: <1s on 1vCPU/4GB.
• Languages: ru/en best; --language detect auto.
• Accuracy: tiny 85-95% ru speech; upgrade to base/small for better.