核心用法
Telegram Footer Patch 是一款面向 OpenClaw 平台的运维增强脚本，专注于在 Telegram 私聊回复的底层渲染代码中注入标准化尾注信息（🧠 Model + 💭 Think + 📊 Context）。该技能通过直接修改 dist/reply-*.js 文件实现平台层级的信息展示，无需依赖模型的上下文记忆能力。
使用流程简洁直观：通过 patch_reply_footer.py 执行补丁注入（支持 --dry-run 预览模式），随后重启 OpenClaw 网关即可生效。补丁内置多重保护机制——每次写入前自动生成 .bak.telegram-footer.* 备份，执行 node --check 语法校验，失败时自动回滚；若检测到 marker 丢失但存在历史备份，会智能提示升级覆盖场景并支持重打补丁。
显著优点
1. 零模型依赖：尾注在平台层注入，不消耗模型 token，不依赖对话上下文
2. 运维友好：单命令完成补丁/回滚/预览，升级后自动识别并重打
3. 安全冗余：强制语法校验 + 自动备份 + 失败回滚三重保护
4. 防重复注入：通过 marker 识别已补丁状态，避免双尾注叠加
潜在局限
- 文件侵入性：直接修改编译产物
dist/reply-*.js，非官方 Hook 机制 - 版本绑定：依赖特定 reply bundle 的代码结构，needle 失效会导致明确报错
- 单平台限定：仅支持 Telegram 私聊场景，群聊或其他平台未覆盖
- 维护责任：OpenClaw 大版本升级可能改变目标文件结构，需持续关注兼容性
适合人群
- 使用 OpenClaw 搭建 Telegram Bot 的开发者/运维人员
- 需要向终端用户透明展示模型调用元信息（模型名、思考过程、上下文消耗）的场景
- 追求低耦合、轻量级方案，不愿改动核心服务代码的技术团队
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 升级覆盖 | OpenClaw 更新后补丁失效 | 重新执行 patch 脚本，内置 upgrade-aware 提示 |
| 语法损坏 | 补丁注入导致 JS 语法错误 | `node --check` 自动校验，失败自动恢复备份 |
| 双尾注 | 重复执行或旧版本残留 | 自动清理已知旧版尾注块，marker 防重复注入 |
| 权限不足 | 无写入 `dist/` 目录权限 | 以适当权限运行，脚本会明确报错 |
安全等级评估
本技能仅操作本地文件系统，不涉及网络请求、敏感凭证或外部 API 调用。补丁脚本采用白名单式的 marker 匹配与严格的语法校验，具备完善的回滚能力。综合评估为 S 级（高安全性运维工具）。
来源可信度
作为 OpenClaw 生态的第三方运维增强方案，代码逻辑透明可读，无混淆或远程加载行为。标记为 T2 级（社区维护的可靠工具）。