Skip to content
TakoAPI
Back to skills

telegram-voice-to-voice-macos

by fiberian1981

Image & Video Generation
1.1kDownloads reported by clawskills.sh
0Views
0 likesSign in to like this skill
—Not yet rated
Your rating

Brief

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

INPUT

User sends a Telegram voice note asking a question

AGENT
  1. 1

    Locate the inbound .ogg file from ~/.openclaw/media/inbound/

  2. 2

    Run scripts/transcribe_telegram_ogg.sh to transcribe the audio using yap

  3. 3

    Check voice_state/telegram.json to determine the reply mode for this sender

  4. 4

    Generate a reply text, then run scripts/tts_telegram_voice.sh to produce a .ogg voice note

  5. 5

    Send the .ogg back to Telegram as a voice note with asVoice: true

OUTPUT

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-macos

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links