← 返回 Skills 市场
347
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install telegram-voice-message-skill
功能描述
基于实际踩坑经验，指导AI将TTS音频转换为OGG并正确使用asVoice参数发送Telegram语音消息。
安全使用建议
This package implements exactly what it claims (TTS → convert to OGG/libopus → send Telegram voice messages), but the metadata omitted the environment variables and credentials the scripts actually need. Before installing or running: 1) Inspect scripts (tts_generator.sh, telegram_sender.sh) to confirm the endpoints (Aliyun/OpenAI/Telegram) are what you expect; 2) Do not run with real production API keys — test in an isolated container/VM with throwaway credentials; 3) Ensure TELEGRAM_BOT_TOKEN and TTS API keys are not committed to VCS; 4) Verify log paths and the presence of any Python packages (e.g., json_log_formatter) before enabling logging to avoid unexpected installs; 5) If you need strict control, ask the author to update the skill metadata to declare required env vars (TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID, ALIYUN_TTS_API_KEY/OPENAI_API_KEY/etc.) so the platform can show clear permission requests. If you are uncomfortable with network calls or giving API keys, do not install/run the scripts.
功能分析
Type: OpenClaw Skill
Name: telegram-voice-message-skill
Version: 1.0.0
The telegram-voice-message-skill bundle is a comprehensive and well-documented utility designed to help AI agents correctly send voice messages via the Telegram Bot API. It includes scripts for generating audio via TTS services (Aliyun, OpenAI), converting audio to the required OGG/Opus format using ffmpeg (scripts/audio_converter.sh), and transmitting the files with the correct API parameters (scripts/telegram_sender.sh). The bundle follows security best practices by using environment variables for API keys, providing extensive validation scripts (scripts/final_validation.sh), and including detailed troubleshooting documentation. No malicious intent, data exfiltration, or unauthorized execution patterns were detected.
能力评估
Purpose & Capability
SKILL.md, README and the included scripts (tts_generator.sh, audio_converter.sh, telegram_sender.sh, etc.) all implement TTS generation, ffmpeg conversion and Telegram sending — this aligns with the skill name/description. However the registry metadata declares no required environment variables or primary credential while the instructions and scripts clearly require TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID and TTS API keys (ALIYUN_TTS_API_KEY, OPENAI_API_KEY, etc.). That metadata omission is an incoherence.
Instruction Scope
Runtime instructions and scripts explicitly download TTS audio URLs, call external TTS endpoints (dashscope.aliyuncs.com, api.openai.com) and perform network uploads to Telegram. They use environment variables for secrets and write/read temporary files under /tmp. This is expected for the stated task, but SKILL.md and scripts access credentials that are not declared in the package metadata, increasing surprise risk. There are no steps that request unrelated system secrets, but the skill does perform arbitrary network I/O and temporary file handling which the user should review.
Install Mechanism
No install spec is provided (instruction-only style), so nothing is automatically downloaded or executed on install. The package includes multiple shell scripts and a Python template that would run when invoked; absence of an automatic installer lowers supply-chain risk. Still, the included scripts will execute network calls when run.
Credentials
The skill requires multiple sensitive environment variables in practice (TELEGRAM_BOT_TOKEN, TELEGRAM_CHAT_ID, ALIYUN_TTS_API_KEY, OPENAI_API_KEY, optional GOOGLE credentials) but the registry metadata lists none. Requiring multiple service credentials is reasonable for this functionality, but their absence from the declared requirements is a mismatch and a transparency problem. Also the templates/logging may write logs to /tmp and reference third-party Python logging formatters (json_log_formatter) which could cause additional package installs if used.
Persistence & Privilege
The skill does not request always:true and does not declare modifications to other skills or global agent settings. Scripts create and clean up temporary files; the skill does not appear to attempt persistent, privileged changes beyond writing to /tmp and optional log file paths configured in templates.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install telegram-voice-message-skill - 安装完成后，直接呼叫该 Skill 的名称或使用
/telegram-voice-message-skill触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
telegram-voice-message-skill v1.0.0
- 初始版本发布，教你如何避免常见错误在Telegram发送语音消息时踩坑。
- 明确Telegram语音消息的音频格式、参数及流程规范。
- 提供音频格式自动转换和错误处理的脚本与说明。
- 涵盖环境配置、安全提醒、常见错误及解决方法。
- 包含详细文档、实践经验总结和最佳实践示例。
元数据
常见问题
Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。 是什么？
基于实际踩坑经验，指导AI将TTS音频转换为OGG并正确使用asVoice参数发送Telegram语音消息。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 347 次。
如何安装 Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install telegram-voice-message-skill」即可一键安装，无需额外配置。
Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。 是免费的吗？
是的，Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。 完全免费，采用 MIT-0 许可证，可自由下载、安装和使用。
Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。 支持哪些平台？
Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。？
由 shynloc（@shynloc）开发并维护，当前版本 v1.0.0。
推荐 Skills