富格式 Telegram 消息自动投递引擎

通过 Telegram Bot API 发送富格式 HTML 消息，专用于结构化报告、通知与警报的自动编排与投递

基本信息

• 技能名称?Telegram Compose
• 中文名称?富格式 Telegram 消息自动投递引擎
• 作者?tmchow
• 分类?专业技能
• 版本?1.0.4
• 标签?telegram, messaging, notification, automation, api-integration, html-formatting, subagent

使用方法

使用说明
核心用法
telegram-compose 是一个子代理技能（sub-agent），由主会话自动调用以格式化并投递富文本 Telegram 消息。它基于决策规则运行：当消息超过 3 行或包含结构化数据（列表、统计、章节、报告）时，主代理会生成 Haiku 子代理任务，由该技能完成 HTML 格式化与 API 投递。
显著优点

1. 专业化 HTML 格式化 ：内置完整的 Telegram HTML 标签支持（粗体、斜体、下划线、删除线、代码块、剧透、引用、可展开引用、链接、用户提及），并提供结构模板与样式规则，确保消息在移动端清晰可扫描。
2. 智能长度处理 ：自动检测 4,096 字符限制，支持按章节边界智能拆分消息，并添加延续标记，避免截断或发送失败。
3. 移动优先的数据展示 ：明确禁止 标签用于统计数据（避免等宽字体在移动端错位），改用「emoji + 粗体 + 分隔符」的自然流式布局。
4. 健壮的错误处理 ：针对常见 API 错误（HTML 解析失败、消息过长、线程不存在、速率限制）制定分级回退策略，最终兜底为纯文本发送，确保消息必达。
5. 配置灵活 ：支持多账户管理（通过 channels.telegram.accounts. .botToken ），自动检测 OpenClaw 配置文件路径，支持话题线程（Thread ID）投递。
   潜在缺点与局限性
   依赖外部配置 ：需预配置 Telegram Bot Token，且账户名必须由调用方显式指定，无法自动选择，配置缺失将直接导致任务失败。
   无持久化状态 ：不存储消息历史或投递状态，失败重试仅依赖单次会话内的错误处理。
   HTML 转义责任 ：要求格式化时正确转义 & 、 、 > ，虽有规则指导，但仍存在人工或自动化处理出错的风险。
   网络单点 ：仅支持 Telegram 官方 API（api.telegram.org），无代理或备选端点配置。
   适合人群
   使用 OpenClaw 框架的自动化工作流开发者
   需要向 Telegram 频道/群组投递结构化通知、监控警报、研究报告的系统管理员与运维团队
   构建 CLI 工具链、需要将终端输出转换为移动端友好格式的技术用户
   常规风险
   凭证泄露风险 ：Bot Token 存储于本地 JSON 文件，需确保 ~/.openclaw/ 目录权限正确（建议 700）。
   API 滥用与封禁 ：高频调用可能触发 Telegram 速率限制，虽实现了指数退避等待，但异常流量仍可能导致账户受限。
   HTML 注入风险 ：若原始内容未正确转义，可能导致消息格式错乱或意外解析（如用户输入包含未转义的 ）。
   消息可见性 ：Telegram 消息投递后无法撤回（除非额外实现），批量发送前建议测试格式化结果。