telegram-voice-to-voice-macos

🎙️ Telegram 本地语音交互助手

OpenClaw官方技能,基于macOS Speech.framework实现Telegram语音本地转录与合成,确保隐私数据不上云,专为Apple Silicon优化。

收藏
3.2k
安装
784
版本
v0.1.3
CLS 安全性认证2026-06-04
点击查看完整报告 >

使用说明

该 Skill 专为 macOS Apple Silicon 设备打造,实现 Telegram 端到端语音交互闭环。接收到 OGG 语音消息后,系统通过 yap 调用 Speech.framework 进行本地转录,AI 生成回复后利用 say+ffmpeg 合成 OGG 语音并发送。用户可通过 /audio on/off 切换语音或文本回复模式,偏好设置持久化存储于本地 JSON 文件。

核心优势在于隐私安全性本地化处理能力。所有语音数据均在设备端通过 Apple Silicon 神经网络引擎处理,无需上传云端,特别适合敏感场景。作为 OpenClaw 官方技能,代码开源透明且通过 S 级安全认证,无 eval/exec 等危险操作。支持多语言转录(YAP_LOCALE 环境变量配置),且能自适应 macOS 系统区域设置,响应速度快无网络延迟。

平台限制是最显著的局限。该技能严格依赖 macOS Speech.framework 与 Apple Silicon 架构,在 Intel Mac 或 Linux/Windows 上无法运行。此外,依赖管理门槛较高,用户需自行安装配置 yapffmpeg 等外部工具并确保 PATH 正确,对非技术用户不够友好。语音识别准确率受限于本地模型,可能不及云端专业 ASR 服务,且对非英语语种支持有限。

适合注重隐私的 macOS 用户(如医疗、法律从业者)、Telegram 社区管理员及自动化工作流开发者。由于需要命令行环境配置,更适合具备技术基础的用户。不适用于需要跨平台部署或依赖高精度云端语音识别的场景。

使用风险主要包括依赖缺失导致的运行时失败,若 yapffmpeg 未安装或版本不兼容将直接报错。平台误判风险也需警惕,在非 Apple Silicon 设备运行会产生不可预期错误。虽然脚本启用 set -euo pipefail 严格模式,但文件路径权限问题(~/.openclaw/ 目录)或磁盘空间不足可能导致临时文件堆积。建议定期检查依赖状态并确保系统 TTS 语音包已下载。

安全解读

核心用法

该 Skill 为 macOS Apple Silicon 设备提供完整的 Telegram 语音消息本地处理闭环:自动转录收到的 OGG 格式语音消息,生成 AI 回复后,可选择以语音或文字形式回传。用户通过 /audio on/off 命令切换回复模式,偏好设置持久化存储于 voice_state/telegram.json

技术流程:接收语音附件 → 调用 yap(基于 Speech.framework)本地转录 → 生成回复内容 → 通过 say + ffmpeg 合成 OGG/Opus 语音消息 → 以 Telegram voice note 形式发送。全程零网络 API 调用,所有处理在设备本地完成。

显著优点

  • 极致隐私保护:语音数据不上传任何云服务,转录与合成完全本地执行,符合 GDPR/CCPA 标准
  • 零外部依赖:不依赖 OpenAI Whisper、Google Speech 等云端 API,无订阅费用与网络延迟
  • 硬件深度集成:充分利用 Apple Silicon 神经网络引擎与 macOS Speech.framework,转录效率高
  • 灵活回复模式:支持语音/文字双模式切换,适应不同场景(会议中静音阅读 vs. 驾驶时语音交互)

潜在局限

  • 平台独占性:仅支持 macOS Apple Silicon,Intel Mac 及 Linux/Windows 完全不可用
  • 工具链依赖:需手动安装 yapffmpeg,配置门槛高于纯 Python 方案
  • 功能单一性:仅处理语音消息,无群聊管理、消息过滤等进阶 Telegram 功能
  • 语音质量受限say 合成语音为系统级 TTS,自然度低于云端神经语音合成

适合人群

  • 注重隐私的 macOS 用户,拒绝云端语音服务
  • 需要离线/低延迟语音交互的开发者与极客
  • Telegram 重度语音消息使用者,希望获得 AI 辅助回复

常规风险

  • 路径遍历风险:输入文件路径未严格校验,需确保 ~/.openclaw/media/inbound/ 目录权限正确
  • 工具链失效yapffmpeg 版本不兼容或缺失时将导致运行时错误
  • 状态文件损坏:JSON 偏好文件若被手动篡改可能导致异常行为
  • 系统语音限制:非英语 locale 下 say 语音质量与可用性差异较大

telegram-voice-to-voice-macos 内容

scripts文件夹
手动下载zip · 4.1 kB
transcribe_telegram_ogg.shtext/x-shellscript
请选择文件