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.
