← Back to Skills Marketplace
1706
Downloads
0
Stars
4
Active Installs
4
Versions
Install in OpenClaw
/install telegram-voice-to-voice-macos
Description
Telegram voice-to-voice for macOS Apple Silicon: transcribe inbound .ogg voice notes with yap (Speech.framework) and reply with Telegram voice notes via say+ffmpeg. Not compatible with Linux/Windows.
Usage Guidance
This skill appears to do exactly what it says: transcribe .ogg voice notes locally (yap) and produce Telegram voice notes via say+ffmpeg. Before installing, confirm you are on macOS Apple Silicon and that you trust the local 'yap' and 'ffmpeg' binaries you will provide. Understand the skill will read inbound .ogg files from ~/.openclaw/media/inbound and create TTS output in ~/.openclaw/workspace/voice_out and (per the SKILL.md) expects a per-user state file voice_state/telegram.json in the workspace — the provided scripts don't manage that state file, so the agent must handle toggling between voice/text. No network endpoints or credentials are requested by the skill itself.
Capability Analysis
Type: OpenClaw Skill
Name: telegram-voice-to-voice-macos
Version: 0.1.3
The skill bundle is classified as benign. All scripts (`transcribe_telegram_ogg.sh`, `tts_telegram_voice.sh`) and instructions (`SKILL.md`) are directly aligned with the stated purpose of providing a Telegram voice-to-voice workflow on macOS. File system operations are confined to expected OpenClaw media and workspace directories (`~/.openclaw/media/inbound`, `~/.openclaw/workspace/voice_out`). The use of external commands (`yap`, `ffmpeg`, `say`, `defaults`) is necessary for the skill's functionality, and arguments are generally quoted, mitigating direct shell injection risks from the script's side. There is no evidence of intentional data exfiltration, malicious execution, persistence mechanisms, or prompt injection attempts designed to subvert the agent's purpose.
Capability Assessment
Purpose & Capability
Name/description align with what the skill asks for: yap for Speech.framework transcription, say + ffmpeg for TTS/encoding, and defaults for reading macOS locale. The included helper scripts implement transcription and TTS and operate on the documented ~/.openclaw media/workspace paths.
Instruction Scope
SKILL.md instructs the agent to read inbound .ogg files from ~/.openclaw/media/inbound and to write reply files under workspace paths; the helper scripts do the transcription and TTS but do not implement the per-user 'voice_state/telegram.json' preference logic described in SKILL.md (that state management is expected to be done by the agent). The instructions do not request secrets or contact unknown external endpoints — sending replies is delegated to the agent's message tool as expected.
Install Mechanism
No install spec (instruction-only plus two small shell scripts). Nothing downloads or executes remote code; risk from install-time actions is low.
Credentials
The skill requires no credentials or sensitive environment variables. It accesses files under the user's home (~/.openclaw/*) and the macOS system locale, which are proportionate to the described functionality.
Persistence & Privilege
The skill is not always-enabled and does not request elevated privileges, but it does write/read files in the user's home (~/.openclaw/workspace and voice_state paths). Autonomous invocation is allowed by default (normal for skills); this combined with file I/O is expected for the workflow but worth noticing.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install telegram-voice-to-voice-macos - After installation, invoke the skill by name or use
/telegram-voice-to-voice-macos - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.3
telegram-voice-to-voice-macos v0.1.3
- Updated scripts/tts_telegram_voice.sh (details not shown).
- No user-facing changes in SKILL.md.
v0.1.2
- Added OpenClaw metadata to specify OS as macOS ("darwin") and required binaries: yap, ffmpeg, say, and defaults.
- Documented the optional YAP_LOCALE environment variable for overriding the transcription locale.
v0.1.1
- Added README.md for improved documentation and onboarding.
- Clarified the skill is strictly macOS Apple Silicon-only and updated compatibility warnings.
- Updated transcription logic to use the current macOS system locale by default if YAP_LOCALE is unset.
- Revised documentation for more concise, accurate requirement and usage details.
v0.1.0
Initial release: Voice-to-voice Telegram workflow for macOS Apple Silicon, with local processing and persistent user preferences.
- Handles incoming Telegram voice notes (.ogg), transcribes locally, generates replies, and sends voice notes back using macOS speech tools.
- Supports per-user persistent toggling between voice and text replies via `/audio on` and `/audio off` commands.
- Stores user reply preferences in a local JSON state file.
- Relies on local requirements: `yap` for transcription, `ffmpeg` for audio processing.
- No cloud services required for voice transcription or TTS—fully runs on-device.
Metadata
Frequently Asked Questions
What is Telegram Voice To Voice Macos?
Telegram voice-to-voice for macOS Apple Silicon: transcribe inbound .ogg voice notes with yap (Speech.framework) and reply with Telegram voice notes via say+ffmpeg. Not compatible with Linux/Windows. It is an AI Agent Skill for Claude Code / OpenClaw, with 1706 downloads so far.
How do I install Telegram Voice To Voice Macos?
Run "/install telegram-voice-to-voice-macos" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Telegram Voice To Voice Macos free?
Yes, Telegram Voice To Voice Macos is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Telegram Voice To Voice Macos support?
Telegram Voice To Voice Macos is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin).
Who created Telegram Voice To Voice Macos?
It is built and maintained by Fiberian (@fiberian1981); the current version is v0.1.3.
More Skills