什么是Gateway Sentinel
Gateway Sentinel 是一款专为 OpenClaw 网关设计的生产级看门狗工具，旨在确保关键网关进程的高可用性。它通过递进式健康检查机制持续监控网关的运行状态，一旦检测到异常，将自动执行逐级修复策略，从简单的重启到更复杂的系统级恢复操作。该工具不仅具备完善的日志记录功能，还能通过 Telegram 或 Discord 向运维人员发送实时告警通知，极大提升了故障响应的及时性和透明度。其核心设计理念是‘最小干预、最大透明’，所有修复动作均有明确记录，避免因自动化操作导致数据意外丢失。 与传统的进程监控方案不同，Gateway Sentinel 采用双重健康验证机制：首先调用 `openclaw gateway status` 命令作为权威判断依据，若失败则 fallback 到 HTTP 健康端点检测。只有当两种方式均确认网关不可用时，才判定为真正故障。这种分层验证有效降低了误判概率。在修复层面，工具提供三级递进式恢复策略——一级重启、二级医生级修复（自动诊断并尝试修复），以及可选的三级 Git 回滚（仅在用户显式启用且达到最大重试次数后触发）。特别值得注意的是，Git 回滚功能默认关闭，且会在重置前自动 stash 未提交变更，确保工作区修改不会无提示地被丢弃。 此外，Gateway Sentinel 还集成了每日快照功能，每天自动对指定工作目录进行一次 Git 提交，保留项目状态快照。这一特性既便于追踪日常变更，又可作为灾难恢复的参考基准。整个系统支持灵活的配置管理，所有参数均可通过环境变量定制，包括检查间隔、最大修复次数、冷却时间等。同时，工具内置单实例锁机制防止重复运行，并通过日志轮转策略控制磁盘占用。无论是本地开发环境还是生产部署场景，都能通过简单的脚本一键安装为系统服务，实现无人值守的稳定运行。
核心功能特点
- 采用 CLI 命令与 HTTP 健康端点双重验证机制，精准判断网关真实状态
- 实施三级递进式修复策略：重启→医生级修复→可选 Git 回滚（默认禁用）
- 支持 Telegram 和 Discord 双通道告警，未配置时降级为纯日志模式
- 每日自动生成 Git 快照提交，自动忽略 .gitignore 排除文件
- 内置单实例锁防重复启动，日志自动轮转避免磁盘溢出
- 所有修复操作均有详细日志记录，关键变更强制 stash 保护
适用场景
Gateway Sentinel 最适用于需要高可用保障的 OpenClaw 网关生产环境。例如，在金融交易系统中，网关服务的稳定性直接关系到订单处理效率和资金安全，一旦网关崩溃可能导致交易中断甚至经济损失。此时，Sentinel 能立即感知故障并启动修复流程，同时第一时间通知运维团队介入，最大限度缩短停机时间。对于 DevOps 团队而言，该工具显著减少了被动响应的压力，使工程师能将精力集中于业务逻辑优化而非基础服务维护。 在持续集成/持续部署（CI/CD）流水线中，若网关因代码更新引入问题而频繁崩溃，Sentinel 的自动回滚能力可快速恢复至上一稳定版本，避免人工排查延迟。尤其当开发者在本地进行实验性修改时，开启 Git 回滚功能可在网关异常时自动保存当前改动（stash），待问题解决后再恢复，既保证了修复效率又不牺牲开发进度。此外，对于分布式微服务架构中的边缘网关节点，Sentinel 的轻量级设计使其无需额外资源消耗即可独立守护每个实例，形成统一的服务韧性保障体系。 即便在非生产环境中，如测试或预发布阶段，Gateway Sentinel 同样具备实用价值。它能帮助验证网关在不同负载下的健壮性，通过模拟故障场景观察自愈行为，从而提前发现潜在隐患。结合其详尽的日志输出，还可用于性能分析与故障根因定位，为后续优化提供数据支撑。总之，任何依赖 OpenClaw 网关稳定运行的业务场景，无论是追求零宕机还是提升运维自动化水平，都能从 Gateway Sentinel 的设计理念与功能特性中获得实质性收益。