SuperAPI AI 工具集

openclaw-guardian

部署与运维

查看项目

更新于 11-01 21:29

技能介绍

用途:OpenClaw Guardian 是一个独立运行的 bash 看门狗进程,目标是让 OpenClaw Gateway 保持 7×24 小时存活,在检测到故障时自动执行修复与回滚。

主要能力:

  • 健康监控:每 30 秒检测一次 Gateway 是否宕机。
  • 自动修复:发现宕机后执行 openclaw doctor --fix,最多尝试 3 次。
  • 回滚恢复:若修复后仍不可用,则通过 git reset --hard 回滚到最近的稳定提交,并重启 Gateway。
  • 冷却机制:若所有手段均失败,进入 300 秒冷却,之后恢复监控。
  • 每日快照:每天自动对工作区执行一次 git 快照。
  • 可选告警:支持通过 DISCORD_WEBHOOK_URL 环境变量配置 Discord 通知。

使用方式(按资料给出的步骤):

  1. 初始化 git(回滚所需):进入 ~/.openclaw/workspace,配置 git 用户信息,执行 git init && git add -A && git commit -m "initial"。若仓库已存在可跳过;没有 git 时 doctor --fix 仍可工作,但回滚会被跳过。
  2. 安装脚本:将本技能的 scripts/guardian.sh 复制到 ~/.openclaw/guardian.sh,并 chmod +x 赋予执行权限。
  3. 启动:容器或无 systemd 环境使用 nohup ~/.openclaw/guardian.sh >> /tmp/openclaw-guardian.log 2>&1 &;带 systemd 的 Linux VPS 参见 references/setup.md 中的 Pattern B。
  4. 容器重启自动拉起:在 ~/.openclaw/start-gateway.sh 的最终 exec 行之前加入 pkill -f "guardian.sh" 与 nohup 启动命令。
  5. 可选 Discord 告警:export DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/...",或在 start-gateway.sh 中持久导出。

验证:使用 pgrep -a -f "guardian.sh" 确认进程运行,tail -f /tmp/openclaw-guardian.log 查看实时日志。

配置与限制:所有设置通过环境变量完成,默认值开箱即用,完整变量参考、systemd 配置与架构图见 references/setup.md。Guardian 可与 gw-watchdog.sh 共存以形成多层防护;回滚目标是第二新的非自动提交(跳过 daily-backup、rollback、auto-backup 类提交);日志路径为 /tmp/openclaw-guardian.log。资料未提供更多关于性能、平台兼容性或收费的信息。