OpenClaw Rollback System

🛡️ 无敌配置回滚系统

为 OpenClaw Gateway 提供多层防护的配置管理和自动回滚解决方案

🌟 特性

✅ 多层防护 - 主备份 + 镜像 + Golden + 紧急恢复
✅ 自动回滚 - 检测到问题立即恢复
✅ 原子切换 - 要么成功要么失败，无中间状态
✅ 渐进式部署 - 逐个 Gateway 部署，降低风险
✅ 智能清理 - 自动清理旧备份，保留重要版本
✅ 版本管理 - 支持回滚到任意历史版本
✅ 零配置 - 自动检测 OpenClaw 配置
✅ 一键安装 - npm install 即可完成部署

📦 快速开始

安装

# 方式 1: 使用 npm（推荐）
npm install openclaw-rollback-system

# 方式 2: 使用 git
git clone https://github.com/your-username/openclaw-rollback-system.git
cd openclaw-rollback-system
bash src/install.sh

验证安装

# 运行系统测试
~/.openclaw/rollback-system/test-system.sh

# 查看日志
tail -f ~/.openclaw/rollback.log

🚀 使用方法

基本操作

# 1. 原子切换配置
~/.openclaw/rollback-system/atomic-switch.sh \
  ~/.openclaw/openclaw.json \
  /path/to/new-config.json

# 2. 快速验证 Gateway
~/.openclaw/rollback-system/quick-validate.sh \
  18789 \
  openclaw-gateway.service \
  "影之军团"

# 3. 渐进式部署（多个 Gateway）
~/.openclaw/rollback-system/progressive-deploy.sh /path/to/new-configs/

# 4. 紧急恢复
~/.openclaw/emergency/emergency-restore.sh

高级功能

# 查看备份列表
ls -lh ~/.openclaw/config-backups/

# 手动清理旧备份
~/.openclaw/rollback-system/cleanup-backups.sh

# 同步镜像备份
~/.openclaw/rollback-system/sync-mirror-backup.sh

# 验证 Golden 配置
~/.openclaw/rollback-system/protect-golden-config.sh verify

# 标记当前配置为 Golden
~/.openclaw/rollback-system/protect-golden-config.sh mark openclaw.json 20260228-120000

🏗️ 架构设计

五层防护架构

┌─────────────────────────────────────────────────────────────┐
│  Layer 5: AI 增强决策（可选）                                │
│  - 智能分析配置变更影响                                      │
│  - 预测潜在问题                                              │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│  Layer 4: 紧急恢复系统                                       │
│  - Golden 配置（只读保护）                                   │
│  - 镜像备份（不同分区）                                      │
│  - 硬编码最小配置                                            │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│  Layer 3: 自动回滚系统                                       │
│  - 健康监控（60秒周期）                                      │
│  - 问题分级（严重/中度/轻微）                                │
│  - 自动决策回滚                                              │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│  Layer 2: 版本管理系统                                       │
│  - 版本索引（JSON）                                          │
│  - 智能清理（保留策略）                                      │
│  - 快速回滚到任意版本                                        │
└─────────────────────────────────────────────────────────────┘
                              ↓
┌─────────────────────────────────────────────────────────────┐
│  Layer 1: 原子切换 + 快速验证                                │
│  - 原子文件替换（mv）                                        │
│  - 30秒快速验证                                              │
│  - 失败立即回滚                                              │
└─────────────────────────────────────────────────────────────┘

目录结构

~/.openclaw/
├── rollback-system/          # 回滚系统核心
│   ├── atomic-switch.sh
│   ├── quick-validate.sh
│   ├── progressive-deploy.sh
│   ├── cleanup-backups.sh
│   ├── sync-mirror-backup.sh
│   ├── protect-golden-config.sh
│   ├── update-version-index.sh
│   ├── enhanced-health-monitor.sh
│   └── test-system.sh
│
├── golden-config/            # Golden 配置保险库
│   ├── openclaw.json         (444 只读)
│   ├── openclaw-dev.json     (444 只读)
│   └── openclaw-tianshuge.json (444 只读)
│
├── emergency/                # 紧急恢复
│   └── emergency-restore.sh
│
└── config-backups/           # 主备份存储
    └── (自动管理)

/tmp/openclaw-backup-mirror/  # 镜像备份（不同分区）

📊 性能指标

操作	耗时
原子切换	< 1 秒
快速验证	30 秒
单个部署	~40 秒
渐进式部署（3个）	~2 分钟
自动回滚	< 1 分钟
紧急恢复	< 1 分钟

存储占用： < 1 MB

🔧 配置

自动检测

系统会自动检测以下配置：

OpenClaw 安装目录
配置文件位置
API 提供商
Telegram Bot 配置
Gateway 端口
systemd 服务

手动配置（可选）

如果需要自定义配置，可以编辑：

# 编辑配置检测器
vim ~/.openclaw/rollback-system/detect-config.sh

# 编辑安装脚本
vim ~/.openclaw/rollback-system/install.sh

📚 文档

🧪 测试

# 运行完整测试套件
npm test

# 或直接运行测试脚本
~/.openclaw/rollback-system/test-system.sh

🤝 贡献

欢迎贡献！请查看 CONTRIBUTING.md 了解详情。

开发流程

Fork 本仓库
创建特性分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
开启 Pull Request

📝 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🙏 致谢

OpenClaw 社区
所有贡献者

📞 支持

📧 Email: support@example.com
💬 Issues: GitHub Issues
📖 文档: 完整文档

⭐ 如果这个项目对你有帮助，请给个 Star！

Made with ❤️ by OpenClaw Rollback System Contributors

📱 Telegram 交互功能

实时通知 + 交互式按钮

系统提供完整的 Telegram 交互功能，自动从 OpenClaw 配置中检测，无需额外配置！

🎯 核心功能

✅ 实时通知 - 配置变更、部署进度、健康警告
✅ 交互式按钮 - 点击按钮直接操作（应用/拒绝/回滚/重启）
✅ 动态更新 - 按钮根据操作结果自动更新
✅ AI 增强 - 可选的 AI 分析和诊断（如果配置了 AI 模型）
✅ 回调处理 - 自动处理所有按钮点击

📋 消息模板

模板	说明	按钮
配置变更检测	检测到配置变更时	应用/拒绝/AI分析/查看详情
部署进度	渐进式部署实时进度	暂停/停止/重试/回滚/查看日志
健康检查警告	服务异常警告	自动修复/回滚/重启/AI诊断
AI 分析结果	AI 分析配置变更	采纳/忽略/详细分析
回滚确认	回滚前确认	确认/取消/查看差异
操作完成	操作结果通知	查看日志/验证状态/重试

🚀 快速开始

# 1. 确保 OpenClaw 配置了 Telegram
jq .channels.telegram ~/.openclaw/openclaw.json

# 2. 测试 Telegram 通知
bash ~/.openclaw/rollback-system/examples/telegram-examples.sh

# 3. 启动回调处理器（可选，用于按钮交互）
nohup ~/.openclaw/rollback-system/telegram-callback-handler.sh &

📖 详细文档

查看完整的 Telegram 功能文档：

cat ~/.openclaw/rollback-system/docs/TELEGRAM.md

🤖 AI 增强（可选）

如果 OpenClaw 配置了 AI 模型，系统会自动启用 AI 增强功能：

配置分析 - 分析配置变更的风险和影响
健康诊断 - 智能诊断服务健康问题
影响预测 - 预测配置变更的影响
回滚建议 - 推荐最佳回滚策略

💡 使用示例

# 在你的脚本中使用 Telegram 通知
source ~/.openclaw/rollback-system/telegram-bot.sh

# 发送配置变更通知
template_config_change_detected "openclaw.json" "更新了 API 配置"

# 发送部署进度
template_deployment_progress 1 3 "主 Gateway" "deploying"

# 发送健康警告
template_health_warning "主 Gateway" "服务停止" "critical" "服务无响应"

🔒 安全性

✅ 自动从配置中读取 Bot Token
✅ 无硬编码敏感信息
✅ 支持白名单（allowFrom）
✅ 所有功能都是可选的

提示： 如果未配置 Telegram，系统会静默跳过通知功能，不影响核心功能。

Name		Name	Last commit message	Last commit date
Latest commit History 1 Commit
docs		docs
examples		examples
scripts		scripts
src		src
tests		tests
.gitignore		.gitignore
.npmignore		.npmignore
CONTRIBUTING.md		CONTRIBUTING.md
GITHUB_RELEASE_CHECKLIST.md		GITHUB_RELEASE_CHECKLIST.md
LICENSE		LICENSE
PROJECT_SUMMARY.md		PROJECT_SUMMARY.md
README.md		README.md
STRUCTURE.md		STRUCTURE.md
package.json		package.json

Folders and files

Latest commit

History

Repository files navigation

OpenClaw Rollback System

🌟 特性

📦 快速开始

安装

验证安装

🚀 使用方法

基本操作

高级功能

🏗️ 架构设计

五层防护架构

目录结构

📊 性能指标

🔧 配置

自动检测

手动配置（可选）

📚 文档

🧪 测试

🤝 贡献

开发流程

📝 许可证

🙏 致谢

📞 支持

📱 Telegram 交互功能

实时通知 + 交互式按钮

🎯 核心功能

📋 消息模板

🚀 快速开始

📖 详细文档

🤖 AI 增强（可选）

💡 使用示例

🔒 安全性

About

Topics

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases 1

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages