OpenClaw插件：自动剥离Markdown，让AI消息适配纯文本通道

1. 项目概述与核心痛点如果你和我一样经常使用 Claude、ChatGPT 这类大语言模型来辅助日常沟通尤其是在 iMessage、短信这类纯文本Plaintext渠道上那你一定遇到过这个烦人的问题你精心构思了一段回复模型也给出了逻辑清晰、格式漂亮的答案但当你一键发送后对方收到的却是一堆夹杂着**、_、###和的“乱码”。这不仅仅是不美观更关键的是它严重破坏了信息的可读性和专业性尤其是在与客户、同事或不太懂技术的朋友沟通时显得非常不友好。这个问题的根源在于绝大多数现代 LLM 在生成文本时默认都会使用 Markdown 语法来增强表达。Markdown 在支持渲染的平台上如 Slack、Discord、Notion是利器但在 iMessage、普通短信、甚至一些早期版本的 WhatsApp 上它就变成了累赘。手动删除这些符号在快节奏的对话中根本不现实。于是一个能自动“净化”消息格式的工具就成了刚需。openclaw-plugin-markdown-strip正是为了解决这个痛点而生的。它是一个为 OpenClaw 设计的插件其核心功能异常专注在消息发送前自动剥离掉所有 Markdown 格式标记只留下纯净的、人类可读的文本内容。它就像一个尽职的“格式清洁工”守在消息出口确保发往纯文本渠道的每一条信息都干净利落。2. 插件工作原理与设计思路2.1 OpenClaw 的插件钩子机制要理解这个插件如何工作首先得了解 OpenClaw 的插件系统。OpenClaw 作为一个消息聚合与自动化平台其强大之处在于提供了一系列生命周期钩子Hooks允许插件在关键节点介入处理流程。openclaw-plugin-markdown-strip利用的正是message_sending这个钩子。message_sending钩子在消息内容已经最终确定、即将被发送到目标通道Channel前触发。此时插件可以获取到完整的消息对象包括其内容、目标通道ID、发送者等信息。插件对这个消息内容进行修改后OpenClaw 便会将修改后的内容发送出去。这种设计非常巧妙它让格式处理对用户和上游的 AI 模型完全透明。AI 模型可以继续用最擅长的 Markdown 进行思考和输出而用户则能在最终端获得最适合当前通信场景的格式。2.2 策略选择正则表达式替换那么如何“剥离” Markdown 呢项目选择了使用一系列正则表达式进行替换的方法。这是一种经典且高效的文本处理策略尤其适合 Markdown 这种语法相对规则、嵌套复杂度有限的结构。为什么不使用一个完整的 Markdown 解析器例如marked或remark来解析后再提取纯文本呢这涉及到复杂度与性能的权衡。一个完整的解析器能处理更复杂、边缘的情况比如嵌套的链接、复杂的代码块但其开销也更大。对于消息发送这个需要低延迟的环节来说正则表达式方案在绝大多数常见情况下已经足够可靠并且速度极快几乎不会给消息发送带来可感知的延迟。插件的目标很明确处理 99% 的常见 Markdown 语法用最小的开销解决核心痛点。具体实现上插件会按顺序应用多个正则表达式规则。这个顺序很重要需要优先处理那些可能包含其他语法的结构。例如通常会先处理代码块因为代码块内部可能包含星号、下划线等字符如果先处理了加粗和斜体可能会误伤代码块内的内容。同理链接[text](url)的处理也需要在移除其他内联格式之前或之后进行以确保text部分自身的格式被正确清理。3. 安装与配置详解3.1 安装流程插件的安装过程遵循 OpenClaw 插件的标准流程非常简单。你需要确保已经安装了 OpenClaw 命令行工具。openclaw plugins install openclaw-plugin-markdown-strip执行上述命令后openclaw会从官方插件仓库或 npm 源拉取该插件并自动完成安装和注册。你可以通过openclaw plugins list命令来确认插件是否已安装并启用。3.2 配置文件解析与自定义安装后插件默认会生效但仅限于iMessage通道。这是作者的一个合理预设因为 iMessage 是最典型的、广泛使用却不支持 Markdown 渲染的渠道。然而我们的通信场景是多样的配置化是必须的。插件的配置位于 OpenClaw 的全局配置文件~/.openclaw/openclaw.json中。你需要找到plugins.entries部分为markdown-strip添加配置。{ plugins: { entries: { markdown-strip: { enabled: true, // 确保插件启用 config: { channels: [imessage, signal, whatsapp, sms] // 指定需要剥离Markdown的通道 } } } } }配置项解析enabled: 布尔值控制插件开关。设为false可临时禁用格式剥离而不卸载插件。config.channels: 一个字符串数组包含了所有需要应用 Markdown 剥离的通道标识符Channel ID。可用的通道标识符示例imessage: Apple iMessagesignal: Signal 私密通讯whatsapp: WhatsAppsms: 传统短信通过各类网关集成telegram: Telegram注意Telegram 本身支持部分 Markdown但你可能希望在某些对话中强制使用纯文本discord,slack,msteams,mattermost: 这些平台通常支持 Markdown一般不需要添加。除非你有特殊需求比如向一个仅显示纯文本的终端或机器人发送消息。irc: 互联网中继聊天注意配置文件的格式。OpenClaw 的配置文件是 JSON 格式但示例中使用了//注释这实际上是 JSONCJSON with Comments的语法。大多数 JSON 解析器不支持注释。在编辑时你必须确保删除这些注释或者使用支持 JSONC 的编辑器如 VS Code进行编辑并在保存时确认最终文件是合法的 JSON。一个更稳妥的做法是将注释写在文件外部只将纯净的 JSON 写入配置文件。3.3 通道匹配逻辑与注意事项插件在message_sending钩子被触发时会检查当前消息的目标通道 ID 是否存在于你配置的channels列表中。如果存在则执行剥离操作如果不存在则原样放行。这里有一个关键的实践细节通道 ID 的准确性。OpenClaw 中每个集成的通道都有一个唯一的 ID。这个 ID 不一定与通道的常见名称完全一致。最可靠的方式是通过 OpenClaw 的日志或调试信息来查看确切的通道 ID。例如你可以在 OpenClaw 发送一条消息时查看其运行日志找到类似于Sending message to channel: my_imessage_connection的输出。my_imessage_connection就是你需要填入配置的实际 ID。对于像 iMessage 这样的标准集成ID 通常是imessage但对于自定义命名的连接就需要具体查看。4. 剥离规则详解与效果展示插件处理的是 Markdown 的语法符号目标是保留其背后的文本内容。下面这个表格详细说明了各种常见 Markdown 语法经过处理后的结果这能帮助你预判插件的行为。输入 Markdown 语法处理后输出文本处理逻辑说明**加粗文字**或__加粗文字__加粗文字移除首尾的**或__保留中间文字。*斜体文字*或_斜体文字_斜体文字移除首尾的*或_保留中间文字。内联代码内联代码移除首尾的反引号。brpythonbrprint(代码块)brbrprint(代码块)移除代码块开始和结束的行以及可选的语法高亮标识如python保留代码块内的所有内容包括缩进和换行。### 三级标题三级标题移除行首的#字符和紧随的空格。[链接文本](https://example.com)链接文本移除方括号[]和圆括号()部分仅保留方括号内的描述文本。URL 本身被丢弃。图片描述处理方式同链接移除![]()结构保留方括号内的替代文本alt text。 这是一段引用这是一段引用移除行首的符号。对于多行引用每行行首的都会被移除。- 无序列表项无序列表项移除行首的-、*或以及紧随的空格。~~删除线文字~~删除线文字移除首尾的~~。---或***或___空行或移除水平分割线通常被整行移除可能会留下一个空行。1. 有序列表项1. 有序列表项默认保留。因为1.、2.在纯文本中依然是清晰的结构标识可读性好。这是一个\*转义的星号\*这是一个*转义的星号*移除用于转义 Markdown 符号的反斜杠\恢复字符本意。snake_case_var或some_wordsnake_case_var或some_word完全不受影响。插件会小心避免匹配下划线用于单词连接的情况通常通过正则表达式的单词边界\b来实现。实操心得理解“内容保留”的边界从表格可以看出插件执行的是“语法剥离”而非“格式渲染”。这意味着链接的 URL 会丢失这是最重要的一个妥协。如果你发送[点击查看](https://example.com)对方只会看到“点击查看”。如果 URL 信息至关重要你必须手动在文本中补充例如写成点击查看 (https://example.com)。插件不会替你完成这个转换。图片仅保留描述纯文本通道无法显示图片所以只保留 alt text 是合理的。确保你的 AI 在描述图片时生成了有意义的替代文本。代码的语义丢失代码块和内联代码的标记被移除代码本身得以保留但“这是代码”这个语义信息没有了。在上下文中这可能仍然清晰但并非绝对。 这个设计选择体现了插件的定位它不是一个功能完整的 Markdown 到纯文本的转换器而是一个轻量、快速的“清洁工具”解决最显眼的格式污染问题。对于更复杂的需求可能需要更重量级的解决方案。5. 高级使用场景与集成考量5.1 多通道差异化配置你的工作流可能涉及多个通道且对格式的需求不同。除了在channels列表中添加多个通道你还可以通过更精细的配置来管理。例如你可能希望在 iMessage 和 SMS 上完全剥离 Markdown。在 Telegram 上只剥离代码块和标题但保留加粗和斜体因为 Telegram 支持部分 Markdown。在 Slack 上完全不做任何处理。目前的openclaw-plugin-markdown-strip版本通过一个简单的通道名单来全局开关。要实现上述差异化配置理论上需要修改插件逻辑使其支持基于通道的规则集配置。或者一个更简单粗暴但有效的方法是运行两个 OpenClaw 实例或配置为不同的通道集合使用不同的插件配置。虽然不够优雅但在复杂度可控时是可行的。5.2 与 AI 提示词Prompt的协同为了让 AI 生成更适应纯文本通道的内容你可以在发送给 AI 的提示词System Prompt 或 User Prompt中加入指令。例如“请用纯文本格式回复避免使用 Markdown 语法如星号、反引号、井号等。因为回复将直接用于短信发送。”这样做有两个好处减轻插件负担AI 生成的内容本身就更干净插件需要做的替换工作更少理论上更安全出现意外替换的概率更低。内容更优AI 知道最终输出是纯文本后可能会调整其表达方式。例如它可能用“标题”来代替### 标题用“* 重点”来代替**重点**这样的文本在去除符号后可能读起来更自然。然而完全依赖提示词并不总是可靠。不同的 AI 模型对提示词的遵循程度不同且模型在复杂推理中可能会不自觉地使用 Markdown。因此“提示词优化”加上“插件兜底”才是最佳实践。5.3 性能与可靠性考量由于插件在每条消息发送前都会执行正则表达式匹配一个自然的担忧是性能。在实际使用中对于常规长度的消息几百到几千字符这套正则替换的速度是微秒级的完全不会影响消息发送的实时性。其性能开销远小于网络传输延迟或 AI 生成消息的时间。可靠性方面正则表达式处理自然语言存在固有的边界情况风险。例如如果用户在消息中写道“请记住这个模式**不要删除我**的两侧星号是内容的一部分”。插件可能会错误地移除内容中的星号。不过这种在自然语言中精确出现 Markdown 语法模式的情况相对罕见。插件的策略是用一个足够覆盖大多数场景的、相对保守的正则规则集在复杂性和实用性之间取得平衡。对于追求极致可靠性的场景可以考虑使用真正的 Markdown 解析器来提取纯文本但这会引入新的依赖和复杂度。6. 常见问题排查与调试技巧即使配置正确有时也会遇到插件似乎没有生效的情况。下面是一个排查清单可以帮助你快速定位问题。问题现象可能原因排查步骤与解决方案消息发送后仍包含 Markdown 符号。1. 插件未启用。2. 目标通道未在配置列表中。3. 配置文件未正确加载或路径错误。1. 运行openclaw plugins list确认markdown-strip状态为enabled。2. 检查~/.openclaw/openclaw.json中channels数组是否包含了目标通道的准确ID。3. 重启 OpenClaw 服务或应用确保配置重新加载。插件移除了不该移除的内容如单词中间的下划线。正则表达式规则过于激进匹配了非 Markdown 语法。1. 这通常是插件规则本身的 bug。检查是否为最新版本。2. 可以尝试在消息中避免使用与 Markdown 冲突的字符组合或用空格隔开。3. 向插件仓库提交 issue提供触发问题的具体文本样例。链接的 URL 丢失只有文本。这是插件的设计行为只保留链接文本。如果需要保留 URL需修改消息内容格式。例如将[官网](https://site.com)改为官网https://site.com。这通常需要在 AI 提示词中指定或使用其他插件进行预处理。配置更改后不生效。OpenClaw 配置缓存或进程未更新。1. 确保保存了配置文件。2.完全重启OpenClaw 的后台服务或守护进程。仅仅刷新前端界面可能不够。3. 检查 OpenClaw 的日志看启动时是否加载了你的配置文件是否有相关错误。有序列表1. 2. 3.的编号被移除了。插件规则或版本可能已变更或存在配置项控制。1. 查阅插件最新文档确认有序列表的处理逻辑。2. 检查是否有额外的配置选项可以控制列表处理行为。3. 测试一个简单的1. 第一项消息查看输出结果以确认当前行为。调试技巧启用详细日志OpenClaw 通常有日志输出功能。你可以尝试在启动 OpenClaw 时增加日志级别例如--verbose或--debug参数观察插件加载和钩子执行的日志。当消息发送时你可能会看到类似[markdown-strip] Processing message for channel: imessage的记录这能直接证实插件被触发并开始工作。本地开发与测试如果你对插件行为有定制化需求或者想修复遇到的问题项目也支持本地开发。克隆仓库后使用npm test运行测试套件可以验证你的修改是否破坏了现有功能。通过openclaw plugins install -l .在本地建立符号链接就能让 OpenClaw 加载你正在开发的版本方便进行实时测试和调试。