用于 Telegram 格式化的 Openclaw Skills 帮助 AI 智能体编写符合 Telegram 真实渲染规则的回复，避免损坏的标记，并保持可读性。
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install telegram-formatting
2. 手动安装
将技能文件夹复制到以下位置之一
~/.openclaw/skills/ <project>/skills/ 优先级：工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 telegram-formatting。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
更倾向于下载？
获取包含原生技能文件的ZIP压缩包。
什么是 Telegram 格式化？
用于 Telegram 格式化的 Openclaw Skills 是一份面向开发者的指南，用于撰写在 OpenClaw 中正确渲染的 Telegram 回复。它区分了标准的基于 HTML 的格式化和 Rich messages 模式，以便智能体可以为当前的通道配置选择正确的语法，并避免依赖不受支持的标签或损坏的区块。
其核心价值在于实际的可靠性：对简短的回复使用极简格式，对较长的回复使用结构化的段落和列表，并且仅在当前 OpenClaw 版本验证后才使用真实的 Telegram 支持的区块。Openclaw Skills 强调测试、版本感知和由消息形状驱动的格式化，以确保回复在不同的 Telegram 客户端和 OpenClaw 渲染器更新中保持整洁。
Telegram 格式化 应用场景
- 使用当前模式的正确标记格式化
telegram通道中的回复。 - 决定何时使用纯 HTML 标签，如
<b>、<code>、<blockquote>和链接。 - 当启用
channels.telegram.richMessages时，编写包含标题、表格和块引用的 Telegram 富文本消息。 - 防止由于不支持的结构（如
<details>、清单、拉引和幻灯片/拼图块）导致的损坏输出。 - 保持简短回复不进行格式化，并避免在一行确认中进行不必要的强调。
- 结构化长篇故障排除解答、状态更新或分步说明以提高可读性。
- 在信任先前的格式化测试结果之前，对照当前的 OpenClaw 版本验证行为。
Telegram 格式化 工作原理
- 每次会话使用
openclaw config get channels.telegram.richMessages检查一次 Telegram 的富文本消息设置。 - 在信任任何先前的富文本消息测试结果之前，使用
openclaw --version确认当前的 OpenClaw 版本。 - 如果富文本消息被禁用或未经验证，请使用带有 HTML 解析模式且仅包含支持标签的 Standard mode。
- 如果启用了富文本消息且您的版本与测试版本一致，请在不含图片的消息中使用纯 Markdown 风格的富文本区块，例如标题、表格和块引用。
- 根据消息形状选择格式化：简短回复不格式化，中等回复使用轻量级行内标签，长篇结构化回复使用段落加列表。
- 避免使用不受支持或低价值的结构，并在图片会将整个回复降级为说明文字时发送单独的消息。
- 当 OpenClaw 渲染器行为发生变化时，重新测试并更新技能文件，以确保未来的回复保持准确。
Telegram 格式化 配置指南
- 确保您的 OpenClaw 环境可用且 Telegram 通道已配置。
- 检查是否启用了富文本消息：
openclaw config get channels.telegram.richMessages
- 在依赖任何记录的渲染行为之前，验证您的 OpenClaw 版本：
openclaw --version
- 如果
channels.telegram.richMessages为true，则仅对支持的区块使用富文本消息 Markdown，并且如果您的版本与测试版本不同，请使用临时消息测试关键格式化。 - 如果富文本消息被禁用或不确定，请仅使用带有 HTML 标签的 Standard mode。
- 在添加或更改格式化行为时，在真实的 Telegram 消息中重新测试，并在渲染器表现不同时更新此技能。
不需要额外安装包；此技能是 Openclaw Skills 的使用和渲染规则集，而不是一个独立的库。
Telegram 格式化 数据架构与分类体系
用于 Telegram 格式化的 Openclaw Skills 不会生成复杂的运行时 Schema，但它遵循严格的消息组织模型。
| 区域 | 数据 \/ 元数据 | 目的 |
|---|---|---|
| 会话配置 | channels.telegram.richMessages |
决定是使用 Standard mode 还是 rich messages 模式。 |
| 版本元数据 | openclaw --version |
验证以前测试过的格式化行为是否仍然值得信赖。 |
| 消息模式 | Standard mode, Rich messages mode | 为回复选择正确的渲染策略。 |
| Standard mode 标签 | <b>, <i>, <code>, <pre>, <blockquote>, <a> |
支持的 Telegram 回复 HTML 格式。 |
| Rich mode 区块 | # 标题, Markdown 表格, > quote |
无图片消息中经证明可靠的富文本区块。 |
| 不支持的区块 | <details>, 清单, 拉引, 幻灯片\/拼图 |
标记为不可用或未经验证；在没有重新测试的情况下不应依赖。 |
| 输出限制 | 图片说明回退, 1024 字符说明限制 | 当消息包含图片时重要的传输限制。 |
该技能使用的分类法：
- 内容长度：简短、中等、长且结构化。
- 渲染模式：standard 与 rich。
- 安全状态：支持、损坏、未验证或缺失功能。
- 媒体状态：无图片与附带图片，这会改变可用的格式。
Telegram 格式化 高级特性
- 会话级别的配置探测，以避免盲目假设支持 rich-message。
- 绑定到 OpenClaw 版本的版本感知渲染验证。
- 区分已测试行为与文档化语法的循证格式化指导。
- 图像感知回退处理，以避免意外将整个回复降级为图片说明。
- 用于在无格式、行内强调或结构化区块之间进行选择的消息形状启发式方法。
- 针对可折叠区块、清单、拉引和媒体组的明确不支持功能警告。
- 内置的重新测试\/更新工作流，使 Openclaw Skills 随着渲染器的演进而保持准确。
SKILL.md
加载中
Openclaw 相关技能
Editor in Chief
Editor in Chief 是一个 Openclaw Skills 编辑代理，旨在纠正散文的同时保留作者的笔触、语气和意图。
Cloudflare Drop
Cloudflare Drop 部署小型静态网站至临时 Cloudflare Workers 预览，具有私密领取交付和严格的同意控制。
UnlimitedTTS
UnlimitedTTS 是一个 Openclaw Skills 工作流，用于通过带有 x402 USDC 结算的 MCP 工具生成付费文本转语音音频和 MP3 旁白。
Volcengine TOS 存储自定义域名
用于绑定、验证和排查 Volcengine TOS 存储桶公共自定义域名故障的 Openclaw Skills。
XHS Knowledge Retriever
XHS Knowledge Retriever 是一个 Openclaw Skills 工具，用于查询本地 Xiaohongshu 竞品笔记 RAG 索引，并返回最相关的文本块以供研究和规划。
精选*
