核心用法
Telegram Footer Patch 是一个面向 OpenClaw 用户的轻量级运维技能，通过自动修改分发目录中的 JS bundle 文件，为 Telegram 私聊回复追加标准化的平台层尾注：🧠 Model + 💭 Think + 📊 Context。该尾注不依赖模型记忆，确保每次交互的元信息透明可追溯。
使用流程简洁：先通过 --dry-run 预览受影响文件，确认无误后执行 patch 脚本，最后必须重启 OpenClaw Gateway 使变更生效。升级 OpenClaw 后若补丁被覆盖，重新运行脚本即可自动识别并重打。
显著优点
1. 非侵入式架构：仅修改 dist 层面的 bundle 文件，不动源码，降低维护成本。
2. 多重保护机制：自动 node --check 语法校验、失败自动回滚、每次写入前生成 .bak.telegram-footer.* 备份、清理旧版尾注防止叠加。
3. 升级感知：内置 marker 检测，能识别"被升级覆盖"状态并给出明确提示。
4. 零配置：自动探测 reply-*.js、compact-*.js、pi-embedded-*.js 等目标文件，无需手动指定路径。
潜在缺点与局限性
- 文件系统风险：直接写入 OpenClaw 安装目录，若权限配置不当可能引发意外损坏。
- 版本耦合：高度依赖 OpenClaw 的 bundle 命名规则和内部结构，重大版本升级可能导致 needle 失效而报错。
- 重启依赖：必须重启 Gateway 才能生效，对高可用场景不够友好。
- Node.js + Python 3 双依赖：环境要求较基础技能略高。
适合人群
- 需要向 Telegram 用户透明展示模型版本、思维链或上下文窗口的 OpenClaw 运维者
- 具备基础 Linux 运维能力、能接受"patch 式"部署方案的技术用户
- 有 staging 环境可用于验证的谨慎型管理员
常规风险
| 风险点 | 缓解措施 |
|--------|---------|
| 误删或损坏核心文件 | 强制备份机制 + 语法校验失败自动恢复 |
| 权限不足导致写入失败 | 前置 `--dry-run` 暴露问题，建议容器/测试环境先行 |
| 升级后补丁失效 | 脚本自动检测 marker 丢失并提示重打 |
| 双尾注叠加 | 自动清理已知旧版 Telegram 尾注块 |
建议始终遵循"dry-run → staging → production"的部署节奏，避免在生产环境直接首次运行。