核心用法
Gateway Guardian 是一款专为 OpenClaw 网关设计的轻量级守护进程工具。用户只需运行 ./guardian.sh 即可启动监控,配合 nohup 命令可实现后台常驻运行。该脚本通过周期性检测网关进程状态,在检测到崩溃时自动执行重启操作。
显著优点
1. 极简部署:纯 Bash 脚本实现,无需额外依赖,开箱即用
2. 跨平台兼容:原生支持 macOS 和 Linux 系统
3. 灵活可配:支持自定义检测间隔(默认30秒)、最大重启次数阈值(默认5次)及日志路径
4. 事件追踪:自动记录重启事件,便于故障排查
5. 资源轻量:守护进程本身开销极低,适合边缘设备部署
潜在缺点与局限性
- 功能单一:仅针对 OpenClaw 网关设计,通用性受限
- 缺乏高级告警:仅支持基础日志记录,无邮件/短信/Webhook 等主动通知机制
- 无健康检查深度:仅检测进程存在性,不验证服务实际可用性(如端口响应、业务逻辑)
- 依赖外部工具:需预装 OpenClaw,未集成安装流程
- 重启策略简单:达到最大重启次数后仅"alerting",具体行为未明确说明
适合人群
- 个人开发者或小型团队运维 OpenClaw 网关实例
- 需要快速搭建基础保活机制的场景
- macOS/Linux 环境下的轻量级服务器管理
常规风险
- 无限重启循环:若网关因配置错误持续崩溃,可能在短时间内触发频繁重启
- 日志膨胀:长期运行下若未配置日志轮转,可能导致磁盘空间占用增长
- 权限问题:自动重启可能涉及系统服务权限,不当配置可能引发安全风险
- 单点依赖:单一守护进程若自身异常退出,将失去保护作用