概念内部机制
Markdown 格式设置
OpenClaw 在渲染渠道特定的输出之前，会将出站 Markdown 转换为共享的中间表示 （IR）。IR 保留纯文本以及样式和链接范围，因此只需解析一次即可供所有渠道使用，且分块绝不会 从范围中间拆开格式。
处理管线
- 将 Markdown 解析为 IR（
markdownToIR）——纯文本加样式范围 （粗体、斜体、删除线、代码、代码块、剧透、块引用、 1-6 级标题）和链接范围。偏移量使用 UTF-16 代码单元，因此 Signal 样式 范围可直接与其 API 对齐。仅当渠道启用表格模式时才会解析表格。 - 对 IR 分块（
chunkMarkdownIR/renderMarkdownIRChunksWithinLimit） ——在渲染前基于 IR 文本进行拆分，因此内联样式和 链接会按块切分，而不会在边界处断裂。 - 按渠道渲染（
renderMarkdownWithMarkers）——样式标记映射 将范围转换为渠道的原生标记。
| 渠道 | 渲染器 | 说明 |
|---|---|---|
| Slack | mrkdwn 标记（*bold*、_italic_、`code`、代码围栏） |
链接变为 <url|label>；解析期间禁用自动链接，以避免重复生成链接 |
| Telegram | HTML 标签（<b>、<i>、<s>、<code>、<pre><code>、<a href>、<tg-spoiler>） |
启用 richMessages 时，还支持富消息表格和标题（<h1>-<h6>） |
| Signal | 纯文本 + text-style 范围 |
当标签与 URL 不同时，链接渲染为 label (url) |
| Discord、WhatsApp、iMessage、Microsoft Teams 和其他渠道 | 纯文本 | 不使用基于 IR 的样式；仍通过 convertMarkdownTables 执行 Markdown 表格转换 |
IR 示例
输入 Markdown： OC_I18N_900000 IR（示意）： OC_I18N_900001
表格处理
markdown.tables 控制渠道如何转换 Markdown 表格，可按
渠道配置，也可选择按账户配置：
| 模式 | 行为 |
|---|---|
code |
在代码块中渲染为对齐的 ASCII 表格（默认回退模式） |
bullets |
将每一行转换为 label: value 项目符号列表项 |
block |
在传输协议支持时保留原生表格，否则回退到 code |
off |
禁用表格解析；原始表格文本保持不变并直接传递 |
各渠道插件的默认值：Signal、WhatsApp 和 Matrix 默认为
bullets；Mattermost 默认为 off；Telegram 默认为 block（除非
账户启用了 richMessages，否则会解析为 code）。任何
未明确设置插件默认值的渠道都会回退到 code。
OC_I18N_900002
分块规则
- 分块限制来自渠道适配器或配置，并应用于 IR 文本，而非 渲染后的输出。
- 围栏代码块会作为一个完整块保留，并带有末尾换行符，以便 渠道正确渲染结束围栏。
- 列表和块引用前缀属于 IR 文本，因此分块绝不会 从前缀中间拆开。
- 内联样式绝不会跨块断开；渲染器会在下一块开头重新开启 尚未结束的样式。
有关各渠道的分块边界和 投递行为，请参阅流式传输和分块。
链接策略
- Slack：
[label](url)-><url|label>；裸 URL 保持原样。 - Telegram：
[label](url)-><a href="url">label</a>（HTML 解析模式）。 - Signal：
[label](url)->label (url)，除非标签已经 与 URL 相同。
剧透
Signal 会解析剧透标记（||spoiler||）并映射为 SPOILER
样式范围，Telegram 则将其映射为 <tg-spoiler>。其他渠道将
||...|| 视为纯文本。
添加或更新渠道格式化程序
- 使用
markdownToIR(...)仅解析一次，并传入适合渠道的 选项（autolink、headingStyle、blockquotePrefix、tableMode）。 - 使用
renderMarkdownWithMarkers(...)和样式标记映射进行渲染（对于 Signal 等传输协议，也可使用自定义样式范围逻辑）。 - 在渲染每个块之前，使用
chunkMarkdownIR(...)或renderMarkdownIRChunksWithinLimit(...)进行分块。 - 接入适配器，使其从出站发送路径调用新的分块器和渲染器。
- 使用格式测试进行测试；如果渠道会分块，还需添加出站投递测试。
常见陷阱
- Slack 尖括号标记（
<@U123>、<#C123>、<https://...>）必须 在转义后保持有效；原始 HTML 仍需安全转义。 - Telegram HTML 要求转义标签之外的文本，以免破坏标记结构。
- Signal 样式范围使用 UTF-16 偏移量，而非码点偏移量。
- 保留围栏代码块末尾的换行符，使结束标记 单独占一行。
相关内容
Was this useful?
