← 返回 Skills 市场

Telegram Voice Messaging Recovery

Name: Telegram Voice Messaging Recovery
Author: stephenredmond-straiteis

作者 Stephen Redmond - Straitéis AI · GitHub ↗ · v1.1.0 · MIT-0

cross-platform ⚠ suspicious

115

总下载

当前安装

版本数

在 OpenClaw 中安装

/install lessac-offline-voice-system

功能描述

Complete offline voice system with high-quality Lessac TTS and faster-whisper speech recognition. Provides natural voice conversations without internet. Use...

使用说明 (SKILL.md)

Telegram Voice Messaging Recovery

This skill exists to restore a known-good OpenClaw native voice messaging setup.

What it restores

local faster-whisper transcription helper in ~/.openclaw/tts
local Python virtualenv with faster-whisper, edge-tts, and soundfile
helper scripts for local testing
working OpenClaw config for native Telegram voice-note replies
explicit bundled Microsoft speech plugin enablement

What it does not do

It does not manually send Telegram voice messages itself.
It does not replace OpenClaw native reply routing.
It does not require a separate Azure TTS API key.

Known-good OpenClaw config

Keep the live routing in openclaw.json:

"messages": {
  "ackReactionScope": "group-mentions",
  "tts": {
    "auto": "inbound",
    "provider": "microsoft",
    "providers": {
      "microsoft": {
        "voice": "en-IE-ConnorNeural",
        "lang": "en-IE"
      }
    }
  }
}

And explicitly enable the bundled Microsoft plugin:

"plugins": {
  "entries": {
    "microsoft": {
      "enabled": true
    }
  }
}

Important note

edge is a legacy alias. Current OpenClaw normalizes that path to microsoft.

Required restart

After applying the config, do a real manual gateway restart.

A hot reload / SIGUSR1 is not enough if the Microsoft speech provider is stale or unregistered.

Files restored

transcribe-audio
voice_handler.py
tts_edge_wrapper.py
voice_integration.sh
Python virtualenv with the required packages

Install

cd /root/.openclaw/workspace/skills/lessac_offline_voice_system
./scripts/install.sh

Verify

Test direct TTS.
Send a short Telegram voice note.
Confirm inbound transcription works.
Confirm outbound reply comes back as audio.

Failure signature this skill is meant to fix

inbound transcription works
outbound TTS reply fails
direct TTS reports:
- microsoft: no provider registered
- openai: not configured

安全使用建议

This package mostly does what it claims (installs a local faster-whisper wrapper and an edge-tts helper and suggests the OpenClaw config lines). Before installing: 1) Note the mismatch — it is not truly offline: edge-tts uses Microsoft-hosted endpoints and faster-whisper may download models from HuggingFace, so network access and bandwidth/storage are required. 2) Review install.sh — it may run apt-get (requires root) and pip install packages; consider running in a container or VM first. 3) Be aware of hardcoded /root/.openclaw/tts and Python-3.11 venv paths in the scripts; on non-root systems you may need to adjust INSTALL_DIR or edit scripts to avoid permission issues. 4) Back up your OpenClaw config before changing plugin settings and perform the manual gateway restart the skill recommends. 5) If you need truly offline TTS, this skill does not provide a fully local model-based TTS engine; verify whether network calls are acceptable in your environment. If you want, provide the exact runtime user account and OpenClaw install layout and I can point out which lines in the scripts you should edit to make paths and Python versions safe for your environment.

功能分析

Type: OpenClaw Skill Name: lessac-offline-voice-system Version: 1.1.0 The skill bundle contains a shell injection vulnerability in `scripts/voice_handler.py`, where the `audio_to_text` function executes `ffmpeg` via `subprocess.run(shell=True)` using unsanitized f-string input for the file path. Additionally, the `scripts/install.sh` script performs high-privilege operations, including `apt-get install` and creating directories in the root user's home folder (`/root/.openclaw/tts`). While these behaviors are consistent with the stated purpose of restoring a voice messaging system, the lack of input sanitization and the requirement for root execution pose significant security risks.

能力评估

⚠ Purpose & Capability

The README/SKILL.md and scripts consistently implement a local helper runtime for faster-whisper (STT) and edge-tts (TTS) and the config changes described align with restoring OpenClaw's Microsoft provider. However the skill repeatedly claims 'offline' operation and 'no Azure API key required' while relying on edge-tts (which calls Microsoft-hosted TTS endpoints) and faster-whisper model downloads from HuggingFace. That is a substantive mismatch: the implementation expects network access and external downloads, so the 'complete offline' claim is false/misleading.

ℹ Instruction Scope

SKILL.md instructs the agent to run scripts/install.sh which: check for python3/pip3/ffmpeg, run apt-get if missing, create a venv, pip install packages, write files into ~/.openclaw/tts (many code paths hardcode /root/.openclaw/tts). The runtime instructions do not read unrelated secrets or exfiltrate data, but they do perform system package installs and write into root-scoped paths if executed as root. They also insert a venv site-packages path into sys.path at runtime, which affects import resolution.

ℹ Install Mechanism

There is no registry 'install' spec, but the included install.sh will create a Python virtualenv and pip-install packages (faster-whisper, edge-tts, soundfile) and uses apt-get to install system packages. No external arbitrary archive downloads are used in the installer (no untrusted URLs), but faster-whisper will itself download model files from HuggingFace at runtime which requires network and large disk usage.

✓ Credentials

The skill does not declare or request credentials. It reads optional env vars (OPENCLAW_EDGE_TTS_VOICE, RATE, PITCH, VOLUME) which are appropriate for customizing TTS. No unrelated secrets or credentials are requested. However many paths in code are hardcoded to /root/.openclaw/tts and the venv Python path (.../venv/lib/python3.11/site-packages), which assumes root and Python 3.11 and may be inappropriate on other systems.

ℹ Persistence & Privilege

The skill does not request always:true and does not autonomously rewrite other skills; it installs persistent files into the OpenClaw runtime directory (~/.openclaw/tts). That persistent presence is expected for a helper runtime, but the use of absolute root paths (e.g., /root/.openclaw/tts) and system package installs via apt-get mean the installer will need elevated privileges on many systems and could affect system state outside the user's home directory.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install lessac-offline-voice-system
安装完成后，直接呼叫该 Skill 的名称或使用 /lessac-offline-voice-system 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.1.0

Rewrite skill around the proven OpenClaw native Telegram voice-messaging recovery path: restore local transcription helper, set microsoft TTS config, explicitly enable bundled Microsoft plugin, and require a real restart.

v1.0.1

Fix venv Python path for STT/TTS scripts

v1.0.0

Initial release of Lessac Offline Voice System for OpenClaw. - Provides complete offline voice conversations with high-quality Lessac TTS and accurate faster-whisper STT. - All voice processing happens locally for strong privacy; no internet connection required. - Easy integration with OpenClaw via Python or Bash scripts. - Supports multiple audio formats and provides automatic audio conversion. - Includes troubleshooting tips and flexible model configuration options.

元数据

Slug lessac-offline-voice-system

版本 1.1.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 3

常见问题