核心用法
Telegram Compose 技能允许用户通过直接调用 Telegram Bot API，以 HTML 格式发送富文本消息。与普通的 Markdown 格式相比，该技能提供了更丰富的排版选项，包括下划线、剧透文本、可折叠引用块以及通过用户 ID 提及特定用户。
使用场景涵盖：(1) 超出简单单行回复的正式 Telegram 通信；(2) 需要分节、列表或状态更新的结构化消息；(3) Clawdbot 原生 Markdown 转换无法支持的格式需求；(4) 警报、报告、摘要或通知类消息；(5) 追求专业、易扫描的视觉层级效果。
技术实现
- 认证：从
~/.clawdbot/clawdbot.json配置文件中读取 Bot Token - API 端点：
https://api.telegram.org/bot<TOKEN>/sendMessage - 解析模式：
parse_mode: "HTML" - 支持标签：粗体、斜体、下划线、删除线、行内代码、代码块、剧透文本、引用块（可展开）、超链接、用户提及
显著优点
1. 格式丰富度：原生支持 Telegram 客户端的全部 HTML 子集，特别是 Markdown 无法实现的 underline、tg-spoiler、expandable blockquote 和 tg://user?id= 用户提及
2. 视觉层级：通过 emoji + 全大写粗体标题、分段空行、可折叠引用块构建专业的信息架构
3. 移动端优化：明确禁止使用 Markdown 表格（在手机上过宽难读），提供垂直键值、紧凑列表、记录卡片等替代方案
4. 结构化输出：为状态更新、警报、任务列表等场景提供成熟的设计模式
潜在缺点与局限性
1. 字符限制：单条消息 4096 字符，图片标题 1024 字符
2. HTML 转义需求：内容中的 <、>、& 必须手动转义为 <、>、&，增加构造复杂度
3. 无原生交互：仅支持纯文本消息，不含 inline keyboard、callback 按钮等交互元素
4. 配置依赖：需要预配置的 Bot Token 和目标 Chat ID，无法动态发现
5. API 直接调用：绕过 Clawdbot 的高层抽象，错误处理和重试逻辑需自行实现
适合人群
- 需要向 Telegram 频道或群组发送自动化报告、监控警报的运维人员
- 追求消息排版专业度的产品经理、社区运营
- 需要通过用户 ID 精确提及特定成员的场景（如工单分配、值班提醒）
- 需要发送剧透内容或可折叠详情的场景
常规风险
- Token 泄露：Bot Token 存储于本地 JSON 文件，若文件权限不当或意外提交至版本控制，可能导致未授权消息发送
- HTML 注入：若消息内容包含不可信用户输入，未正确转义可能导致格式混乱或意外解析
- 频率限制：Telegram API 存在调用频率限制，高频场景需考虑队列和退避策略
- 消息长度超限：超过 4096 字符的消息将被截断或拒绝，长内容需手动分片