核心功能
OpenClaw 自救套件是一套专为 OpenClaw AI 助手设计的 Shell 脚本运维工具,解决网关崩溃、配置损坏、端口冲突等高频故障场景。
核心脚本能力:
gateway-start.sh— 端口冲突防护启动包装,自动清理锁文件gateway-watchdog.sh— 配置验证 + 自动回滚 + 智能重启(冷却期/次数限制)git-tag.sh— Git 快照与一键回滚,支持quick-rollback紧急恢复safe-config-modify.sh— 原子写入配置,失败自动回滚,流程可恢复security-hardening.sh— 安全基线扫描与加固health-check.sh— 资源/消息活动监控,异常告警log-cleaner.sh— 智能日志轮转与 Session 瘦身notify.sh— 飞书/Telegram/企微/钉钉多通道告警(网关挂了也能发)
部署方式: 支持 clawhub 一键安装、.skill 文件安装或手动部署,macOS 推荐 LaunchAgent(比 crontab 更可靠),Linux 可用 crontab。
显著优点:
- 网关崩溃后独立脚本仍能运行,实现"AI 诊断不了自己"时的外部监控
- 配置修改全程原子操作,失败自动回滚,降低人为失误风险
- 多通道告警不依赖网关进程,确保故障可感知
- 内置重启冷却期(60s)和次数限制(3次),防止无限循环
潜在局限:
- 仅针对 OpenClaw 网关生态,通用性受限
- macOS LaunchAgent 需手动处理沙箱权限场景
- Git 回滚依赖本地仓库完整性,未涉及远程备份
- 告警配置需手动填入 Webhook,无 GUI 引导
适合人群: OpenClaw 重度用户、自托管网关的开发者、对服务稳定性有高要求的运维人员。
常规风险: 脚本以用户权限运行,涉及进程管理和文件写入,需确保 ~/.openclaw 目录权限正确;配置回滚操作会覆盖当前配置,建议在低峰期测试验证;定时任务频繁执行可能产生日志膨胀,需配合 log-cleaner 使用。