Telegram富文本发送

技能简介

该技能用于将原始内容转换为结构清晰的HTML格式Telegram消息，并通过官方API直接投递。作为Haiku子代理运行，由主会话在检测到长内容或结构化数据时自动触发。

业务背景

当团队通过Telegram同步长篇幅信息时，纯文本易造成阅读疲劳。该技能自动识别超过3行或含列表、统计的数据，转换为加粗标题、代码块等结构化HTML格式，提升关键信息抓取效率。支持普通群聊与论坛话题两种场景，禁用链接预览避免消息冗长，让技术通知、数据周报等专业内容呈现更专业清晰。

落地案例：运维团队每日需向Telegram频道推送服务器状态报告，包含多组性能指标和异常清单。主会话检测到内容超过3行且含列表结构后，自动触发子代理：将"CPU使用率95%"转为加粗警示，错误日志包裹为代码块，按章节层级排版后投递至指定话题线程。接收方无需展开即可定位关键数值，较纯文本版本阅读时间缩短，降低误读风险。

能做什么

• 自动识别需要格式化的场景（超过3行或含列表/统计/章节）
• 将纯文本转换为加粗、斜体、代码块等HTML样式
• 支持普通聊天和论坛话题(thread)两种投递模式
• 禁用链接预览，保持消息整洁

使用说明

前置条件：

1. 安装依赖：jq、curl
2. 配置OpenClaw文件（~/.openclaw/openclaw.json 或 ~/.openclaw/clawdbot.json），添加 channels.telegram.accounts.<名称>.botToken

调用方式：主会话通过 sessions_spawn 启动子代理，需传入：账号名称、聊天ID、话题ID（可选）、原始内容。子代理读取SKILL.md获取格式规则后执行投递。

关键指令示例：

CONFIG=$([ -f ~/.openclaw/openclaw.json ] && echo ~/.openclaw/openclaw.json || echo ~/.openclaw/clawdbot.json)
BOT_TOKEN=$(jq -r ".channels.telegram.accounts.$ACCOUNT.botToken" "$CONFIG")
curl -s -X POST "https://api.telegram.org/bot${BOT_TOKEN}/sendMessage" \
  -H "Content-Type: application/json" \
  -d "$(jq -n --arg chat "$CHAT_ID" --arg text "$MESSAGE" '{chat_id: $chat, text: $text, parse_mode: "HTML", link_preview_options: { is_disabled: true }}')"

输入与输出

见下方输入与输出表格。

风险提示

• 账号名称必须由调用方显式指定，禁止子代理自动选择或遍历配置
• 子代理的announcement路由回主会话，主会话应回复NO_REPLY避免重复发送
• Bot令牌存储于本地配置文件，需确保文件权限安全
• 网络依赖api.telegram.org，国内环境需考虑连通性

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/tmchow/telegram-compose/SKILL.md
来源类型：GitHub仓库