核心用法
Telegram Footer Patch 是一款面向 OpenClaw 用户的平台层修改工具，通过在 Telegram 私聊回复消息末尾自动追加 🧠 Model + 💭 Think + 📊 Context 尾注，解决模型上下文遗忘导致的回复信息不透明问题。
执行流程：
1. 预览：--dry-run 模式展示即将修改的 dist 文件（reply-*.js、compact-*.js、pi-embedded-*.js）
2. 应用补丁：Python 脚本自动探测、备份、注入尾注逻辑
3. 重启网关：必须执行 openclaw gateway restart 使修改生效
4. 回滚：专用 revert 脚本恢复原始文件
显著优点
- 平台层实现：不依赖模型记忆，稳定性高
- 安全机制完善：自动
node --check语法校验、失败自动恢复备份、marker 机制防重复注入 - 升级友好：检测到 marker 丢失时提示重打，兼容 OpenClaw 版本迭代
- 操作可追溯：
.bak.telegram-footer.*备份文件明确可定位
潜在缺点与局限性
- 侵入式修改：直接写入 OpenClaw 安装目录的编译后 JS 文件，属非官方支持方案
- 环境依赖：需 Node.js + Python 3，对纯容器/受限环境不友好
- 强制重启：网关重启为必选项，生产环境需规划维护窗口
- 版本耦合：needle 匹配逻辑可能随 OpenClaw 架构升级失效，需持续维护
适合人群
- 需要向 Telegram 私聊用户透明展示模型调用信息的 OpenClaw 运营者
- 具备基础运维能力、能承担非官方补丁风险的技术用户
- 拥有 staging 环境可用于预验证的团队
常规风险
| 风险项 | 说明 |
|--------|------|
| 文件系统损坏 | 脚本直接修改运行时代码，异常中断可能导致文件不完整 |
| 升级覆盖 | OpenClaw 更新后补丁失效，需手动重打 |
| 权限问题 | 需对 OpenClaw 目录有写权限，多用户/容器场景易出错 |
| 双尾注叠加 | 历史版本残留可能导致重复注入（已处理但需留意） |
建议：始终在隔离环境测试，确认备份机制可用后再部署至生产。