telegram-voice-to-voice-macos
by fiberian1981
Image & Video GenerationBrief
Telegram voice-to-voice for macOS Apple Silicon: transcribe inbound .ogg voice notes with yap (Speech.framework)
Description
What This Skill Does
Handles Telegram voice note conversations on macOS Apple Silicon. Transcribes incoming .ogg voice notes using Apple's Speech.framework via the yap CLI, generates a spoken reply with say and ffmpeg, and sends it back as a Telegram voice note. Supports per-user toggle between voice and text reply modes.
Uses Apple's on-device Speech.framework for transcription instead of a cloud API, so no audio leaves the machine.
When to Use It
- Replying to Telegram voice messages hands-free on a Mac
- Transcribing received voice notes into readable text
- Running a voice-native Telegram bot on an Apple Silicon machine
- Switching specific contacts between voice and text reply modes
- Automating voice responses in a Telegram workflow on macOS
Example Workflow
User sends a Telegram voice note asking a question
- 1
Locate the inbound .ogg file from ~/.openclaw/media/inbound/
- 2
Run scripts/transcribe_telegram_ogg.sh to transcribe the audio using yap
- 3
Check voice_state/telegram.json to determine the reply mode for this sender
- 4
Generate a reply text, then run scripts/tts_telegram_voice.sh to produce a .ogg voice note
- 5
Send the .ogg back to Telegram as a voice note with asVoice: true
A Telegram voice note reply sent to the original sender
Requirements
- yap CLI installed and available in PATH (https://github.com/finnvoor/yap)
- ffmpeg installed and available in PATH
- macOS on Apple Silicon hardware
Installation
clawhub install fiberian1981/telegram-voice-to-voice-macosRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.