🛡️ OpenClaw Gateway Guardian - 网关守护神

自动监控、保护和重启 OpenClaw 网关服务
防止网关意外停止、崩溃或消失

🎯 核心功能

功能	说明
🔍 实时监控	每 30 秒检查网关状态（端口 + 进程）
🔄 自动重启

网关异常时自动重启，最多 10 次 | | 📱 多渠道通知 | 飞书/Telegram/企业微信告警 | | 📊 健康日志 | 记录所有健康检查数据 | | 🛡️ 进程保护 | 防止多实例运行 | | ⚙️ 灵活配置 | 可自定义检查间隔、重启策略 |

🚀 快速开始

1. 安装依赖

bash
pip install -r requirements.txt

2. 初始化配置

bash
python scripts/gateway_guardian.py init

3. 启动守护进程

bash
python scripts/gateway_guardian.py start

4. 查看状态

bash
python scripts/gateway_guardian.py status

📋 通知渠道

渠道	配置难度	推荐度
飞书	⭐⭐	⭐⭐⭐⭐⭐
Telegram

⭐⭐ | ⭐⭐⭐⭐ | | 企业微信 | ⭐⭐ | ⭐⭐⭐⭐ |

🔧 配置示例

json
{
gateway: {
port: 18789,
checkintervalseconds: 30,
maxrestartattempts: 10,
restartdelayseconds: 5
},
notifications: {
enabled: true,
feishubottoken: xxx,
feishuuserid: ou_xxx
}
}

📱 通知模板

网关异常告警

🛡️ 网关守护神

⚠️ 网关异常告警

网关状态异常
端口状态：❌
进程状态：❌
连续失败：3

正在尝试重启...

网关已恢复

🛡️ 网关守护神

✅ 网关已恢复

网关已成功重启
重启时间：2026-03-12 16:30:45

📊 命令行用法

bash

初始化

python scripts/gateway_guardian.py init

启动

python scripts/gateway_guardian.py start

停止

python scripts/gateway_guardian.py stop

状态

python scripts/gateway_guardian.py status

日志

python scripts/gateway_guardian.py logs

健康报告

python scripts/gateway_guardian.py health

📁 文件结构

openclaw-gateway-guardian/
├── README.md
├── SKILL.md
├── requirements.txt
├── scripts/
│ └── gateway_guardian.py
└── ~/.openclaw_guardian/
├── config.json
├── guardian.log
├── guardian.pid
└── health_log.json

🔍 工作原理

健康检查 (30 秒) → 异常检测 (端口 + 进程) → 自动重启 (最多 10 次)
↓ ↓ ↓
健康日志 告警通知 重启统计

⚠️ 注意事项

1. 1. 不要同时运行多个实例 - 会导致冲突
2. 定期清理日志 - 避免日志文件过大
3. 配置通知渠道 - 否则无法收到告警
4. 检查网关配置 - 守护神只能重启，不能修复配置错误

🔧 故障排除

Q: 守护进程启动失败？

A:

1. 1. 检查是否已有实例：python gatewayguardian.py status
2. 删除 PID 文件：~/.openclawguardian/guardian.pid
3. 查看日志：python gateway_guardian.py logs

Q: 通知不发送？

A:

1. 1. 检查通知配置
2. 检查网络连接
3. 测试通知渠道

Q: 网关频繁重启？

A:

1. 1. 查看健康日志：python gateway_guardian.py health
2. 检查网关日志
3. 修复网关配置问题

📊 性能指标

指标	数值
CPU 占用	< 1%
内存占用

< 50MB | | 检查延迟 | < 1 秒 | | 重启延迟 | 5-10 秒 |

---

版本: 1.0.0 作者: davidme6 许可: MIT 发布日期: 2026-03-12

让网关永远在线，不再担心意外停止！🛡️