核心功能
Gateway Guardian 是专为 OpenClaw 网关设计的三层防护守护系统,通过 systemd 服务编排实现生产级可靠性保障。
核心机制
| 层级 | 功能 | 实现方式 |
|:---|:---|:---|
| **第一层** | 配置实时监控 | `inotifywait` 监听 `openclaw.json` 变更,异常时自动回滚备份 |
| **第二层** | 崩溃自恢复 | `OnFailure` 钩子触发 recovery 服务,自动重启网关 |
| **第三层** | 分级告警 | 支持飞书/ Telegram/ Discord 三通道,区分 DM 私聊与团队群通知 |
显著优点
- 零配置智能安装:AI 自动检测当前对话平台,无需手动填写通道参数
- 多语言自适应:根据用户输入语言自动设置
zh/en通知文案 - 配置安全兜底:每次变更前自动备份至
~/.openclaw/config-backups/,保留时间戳版本 - 非侵入式集成:通过 systemd drop-in 扩展,不修改原始网关服务单元
- 团队协同友好:可选配置团队通知群,故障恢复后自动广播
潜在局限与风险
| 局限/风险 | 说明 |
|:---|:---|
| **Linux 独占** | 依赖 `systemd --user`,macOS/Windows 不兼容 |
| **依赖外网下载** | 脚本从 GitHub raw 域名拉取,网络隔离环境需手动部署 |
| **sudo 权限卡点** | `inotify-tools` 安装需 root,无权限时需用户介入 |
| **配置明文存储** | `guardian.conf` 含通知目标 ID,虽设计为不提交 Git,但本地权限依赖用户 umask |
| **单点恢复逻辑** | 仅处理服务级崩溃,底层网络/硬件故障不在守护范围 |
适合人群
- 生产环境运维者:需要 7×24 网关稳定运行的团队
- 多实例管理者:同时维护多个 OpenClaw 部署的工程师
- 告警敏感型用户:要求故障即时感知、恢复自动确认的场景
安全建议
- 定期检查
~/.openclaw/config-backups/磁盘占用,避免无限增长 - 团队群 ID 配置前确认群权限,防止敏感信息外泄至外部群组
- 卸载时按需清理备份,避免残留配置泄露历史部署信息