核心用法
Telegram Media 技能是一套基于 Python 的自动化媒体推送工具,主要用于在 Telegram 平台上发送图片、图表、文档及 AI 生成的语音消息。核心功能包括:
- 照片/图表发送:通过 Telegram Bot API 发送本地图片,支持自定义标题
- 文档传输:支持 PDF、CSV 等各类文件的发送
- 金融图表生成:运行
crypto_charts.py生成 BTC、ETH、XRP、SUI、XAU、XAG 等资产的蜡烛图,含斐波那契、SMA、RSI 技术指标 - TTS 语音合成:集成 ElevenLabs API,将文本转换为自然语音,支持多语言模型
eleven_multilingual_v2 - 一键工作流:支持"生成+发送"串联操作,无需人工干预
显著优点
1. 端到端自动化:从数据获取、图表渲染到消息推送形成闭环,适合量化交易监控场景
2. 多资产覆盖:预置主流加密货币与贵金属模板,开箱即用
3. 语音交互增强:ElevenLabs 集成使机器人具备人格化表达能力,提升用户体验
4. 环境配置灵活:通过 .env 文件管理多组 API 密钥,便于不同环境部署
潜在缺点与局限性
- 外部依赖重:依赖 Telegram Bot API、ElevenLabs API 及加密货币数据源,任一节点的服务中断都会导致功能失效
- 无状态设计:不保存发送历史,无法追踪消息送达状态或实现消息撤回
- 硬编码路径:图表输出路径
/tmp/frank_voice.mp3和~/clawd/charts/固定,多实例部署时可能冲突 - 无权限校验:假设执行环境已具备文件系统访问权限,缺乏细粒度的操作审计
适合人群
- 量化交易员与加密货币分析师,需要定时推送行情图表
- 自动化工作流开发者,构建 Telegram 通知机器人
- 需要语音交互增强的客户服务场景
常规风险
- API 密钥泄露:
.env文件若权限配置不当,Telegram Token 和 ElevenLabs Key 可能被窃取 - API 配额耗尽:ElevenLabs 按字符计费,高频调用可能导致意外费用
- 内容合规风险:自动生成语音可能被滥用于虚假信息传播
- 临时文件残留:
/tmp/frank_voice.mp3未及时清理存在隐私泄露隐患