← Back to Skills Marketplace
shynloc

Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。

by shynloc · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
347
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install telegram-voice-message-skill
Description
基于实际踩坑经验，指导AI将TTS音频转换为OGG并正确使用asVoice参数发送Telegram语音消息。
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
ℹ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install telegram-voice-message-skill
  3. After installation, invoke the skill by name or use /telegram-voice-message-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
telegram-voice-message-skill v1.0.0 - 初始版本发布，教你如何避免常见错误在Telegram发送语音消息时踩坑。 - 明确Telegram语音消息的音频格式、参数及流程规范。 - 提供音频格式自动转换和错误处理的脚本与说明。 - 涵盖环境配置、安全提醒、常见错误及解决方法。 - 包含详细文档、实践经验总结和最佳实践示例。
Metadata
Slug telegram-voice-message-skill
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。?

基于实际踩坑经验，指导AI将TTS音频转换为OGG并正确使用asVoice参数发送Telegram语音消息。 It is an AI Agent Skill for Claude Code / OpenClaw, with 347 downloads so far.

How do I install Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。?

Run "/install telegram-voice-message-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。 free?

Yes, Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。 support?

Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Telegram语音消息技能包:基于实际踩坑经验的完整解决方案，帮助AI助手正确发送Telegram语音消息。解决WAV格式错误、缺少asVoice参数、TTS音频URL过期等常见问题。?

It is built and maintained by shynloc (@shynloc); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments