SuperAPI AI 工具集

myclaw-guardian

部署与运维

查看项目

更新于 10-16 06:23

技能介绍

用途:为 OpenClaw Gateway 提供独立看门狗,维持其长期运行并在故障时自动修复。

主要能力:每 30 秒检查一次 Gateway 健康状态(GUARDIAN_CHECK_INTERVAL,默认 30);失败时运行 openclaw doctor --fix,最多 3 次(GUARDIAN_MAX_REPAIR,默认 3);若仍不可用,则通过 git reset --hard 回滚到最近稳定提交并重启 Gateway;每日自动对工作区做 git 提交快照;可选 Discord webhook 告警(DISCORD_WEBHOOK_URL)。

环境变量(均为可选,默认值开箱可用):GUARDIAN_WORKSPACE(默认 $HOME/.openclaw/workspace,须为 git 仓库)、GUARDIAN_LOG(默认 /tmp/openclaw-guardian.log)、GUARDIAN_CHECK_INTERVAL(默认 30)、GUARDIAN_MAX_REPAIR(默认 3)、GUARDIAN_COOLDOWN(默认 300,全部修复失败后的冷却时间)、OPENCLAW_CMD(默认 openclaw)、DISCORD_WEBHOOK_URL(默认未设置)。

依赖工具:git(工作区回滚与每日快照)、pgrep / pkill(进程检测)、curl(仅设置 DISCORD_WEBHOOK_URL 时用于告警)、openclaw CLI。

安装方式:可让 OpenClaw agent 执行“Help me install openclaw-guardian to harden my gateway”,或手动操作:先在 ~/.openclaw/workspace 执行 git init && git add -A && git commit -m "initial",再 cp scripts/guardian.sh ~/.openclaw/guardian.sh 并 chmod +x ~/.openclaw/guardian.sh,最后用 nohup ~/.openclaw/guardian.sh >> /tmp/openclaw-guardian.log 2>&1 & 启动。需使用仓库级 git 配置而非 --global。容器重启后自动启动可在 ~/.openclaw/start-gateway.sh 末尾 exec 前加入 pkill -f "guardian.sh" 与 nohup 启动命令。

适用场景与限制:适用于需要长期在线、希望自动修复与回滚的 OpenClaw Gateway 部署;工作区必须是 git 仓库,否则回滚与快照不可用;具体收费、平台与效果资料未提供。完整文档见 https://github.com/LeoYeAI/openclaw-guardian。