openclaw-config-guardian 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 OpenClaw Config Guardian Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,198 @@
+<div align="center">
+
+<img width="120" src="https://img.shields.io/badge/🛡️-Config_Guardian-blue?style=for-the-badge" alt="Config Guardian" />
+
+# OpenClaw Config Guardian
+
+**Auto backup & one-click rollback for OpenClaw configuration.**
+
+[![npm version](https://img.shields.io/npm/v/@openclaw/config-guardian.svg)](https://www.npmjs.com/package/@openclaw/config-guardian)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Node.js](https://img.shields.io/badge/Node.js->=18-339933?logo=node.js&logoColor=white)](https://nodejs.org/)
+
+</div>
+
+---
+
+## ✨ Features
+
+| Feature | Description |
+|---------|-------------|
+| 🔄 **Auto Backup** | Automatic daily backups at 2:00 AM (only when OpenClaw is healthy) |
+| 🌐 **Web UI** | Beautiful web interface to manage backups |
+| ⚡ **One-Click Rollback** | Restore to any backup point instantly |
+| 🏥 **Health Check** | Verifies OpenClaw status before backup |
+| 🧹 **Auto Cleanup** | Keeps only the latest N backups automatically |
+| 🖥️ **CLI Support** | Full command-line interface |
+
+---
+
+## 🚀 Quick Start
+
+### Option 1: npx (No Installation)
+
+```bash
+# Check status
+npx @openclaw/config-guardian status
+
+# Create backup
+npx @openclaw/config-guardian backup
+
+# Start Web UI
+npx @openclaw/config-guardian webui
+```
+
+### Option 2: Global Install
+
+```bash
+# Install globally
+npm install -g @openclaw/config-guardian
+
+# Use shorthand
+ocg status
+ocg backup
+ocg webui
+```
+
+### Option 3: One-Line Install Script
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/openclaw/config-guardian/main/scripts/install.sh | bash
+```
+
+---
+
+## 📖 Usage
+
+### CLI Commands
+
+```bash
+# View status
+openclaw-config-guardian status
+
+# Create backup immediately
+openclaw-config-guardian backup
+
+# List all backups
+openclaw-config-guardian list
+
+# Restore to specific backup
+openclaw-config-guardian restore backup-2024-01-01T00-00-00-000Z
+
+# Delete a backup
+openclaw-config-guardian delete backup-2024-01-01T00-00-00-000Z
+
+# Start Web UI
+openclaw-config-guardian webui
+
+# Show help
+openclaw-config-guardian help
+```
+
+### Web UI
+
+Start the Web UI and open http://localhost:3456:
+
+```bash
+openclaw-config-guardian webui
+```
+
+Features:
+- Toggle auto backup on/off
+- View system status
+- Create backups with one click
+- Restore to any backup point
+- Delete old backups
+
+---
+
+## ⚙️ Configuration
+
+Edit `~/.openclaw/extensions/openclaw-config-guardian/config.json`:
+
+```json
+{
+  "autoBackup": true,
+  "maxBackups": 10,
+  "webUIPort": 3456,
+  "backupItems": [
+    "config.json",
+    "gateway.json",
+    "agents.json",
+    "skills.json",
+    "memory",
+    "workspace"
+  ]
+}
+```
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `autoBackup` | Enable automatic daily backups | `true` |
+| `maxBackups` | Maximum backups to keep | `10` |
+| `webUIPort` | Port for Web UI | `3456` |
+| `backupItems` | Files/directories to backup | See above |
+
+---
+
+## 📦 What's Backed Up
+
+By default, the following are backed up:
+
+- `config.json` - Main configuration
+- `gateway.json` - Gateway configuration
+- `agents.json` - Agents configuration
+- `skills.json` - Skills configuration
+- `memory/` - Memory files
+- `workspace/` - Workspace files
+
+---
+
+## 🔒 Safety Features
+
+- **Emergency Backup**: Before rollback, current config is backed up
+- **Health Check**: Only backs up when OpenClaw is running normally
+- **Auto Cleanup**: Old backups are automatically deleted
+- **Safe Restore**: Stops Gateway before restore, restarts after
+
+---
+
+## 🛠️ Development
+
+```bash
+# Clone the repo
+git clone https://github.com/openclaw/config-guardian.git
+cd config-guardian
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Local install
+npm install -g .
+
+# Or use local script
+bash scripts/install.sh --local
+```
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+---
+
+## 📄 License
+
+MIT License - see [LICENSE](LICENSE) file for details.
+
+---
+
+<div align="center">
+
+Made with ❤️ for the OpenClaw community
+
+</div>

package/bin/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import('../dist/cli.js');

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,136 @@
+import { getConfig, createBackup, listBackups, restoreBackup, deleteBackup, checkOpenClawHealth } from './core.js';
+function printUsage() {
+    console.log(`
+🛡️  OpenClaw Config Guardian
+=============================
+
+Usage: openclaw-config-guardian <command> [options]
+
+Commands:
+  install              Install the plugin
+  uninstall            Uninstall the plugin
+  status               Show current status
+  backup               Create a backup immediately
+  restore <backup-id>  Restore to a specific backup
+  delete <backup-id>   Delete a specific backup
+  list                 List all backups
+  webui [port]         Start Web UI (default port: 3456)
+  config               Show current configuration
+  help                 Show this help message
+
+Examples:
+  openclaw-config-guardian backup
+  openclaw-config-guardian restore backup-2024-01-01T00-00-00-000Z
+  openclaw-config-guardian webui 8080
+`);
+}
+function showStatus() {
+    const config = getConfig();
+    const backups = listBackups();
+    console.log('\n📊 Config Guardian 状态');
+    console.log('======================');
+    console.log('自动备份:', config.autoBackup ? '✅ 开启' : '❌ 关闭');
+    console.log('最大备份数:', config.maxBackups);
+    console.log('Web UI 端口:', config.webUIPort);
+    console.log('上次备份:', config.lastBackup || '无');
+    console.log('备份数量:', backups.length);
+    console.log('OpenClaw 状态:', checkOpenClawHealth() ? '🟢 运行中' : '🔴 未运行');
+    if (backups.length > 0) {
+        console.log('\n最近备份:');
+        backups.slice(0, 5).forEach(b => {
+            console.log(`  • ${b.id} (${new Date(b.timestamp).toLocaleString()})`);
+        });
+    }
+    console.log();
+}
+function showConfig() {
+    const config = getConfig();
+    console.log('\n⚙️  当前配置');
+    console.log('=============');
+    console.log(JSON.stringify(config, null, 2));
+    console.log();
+}
+function showList() {
+    const backups = listBackups();
+    if (backups.length === 0) {
+        console.log('\n📭 暂无备份\n');
+        return;
+    }
+    console.log('\n📦 备份列表');
+    console.log('===========');
+    backups.forEach((b, i) => {
+        console.log(`${i + 1}. ${b.id}`);
+        console.log(`   时间: ${new Date(b.timestamp).toLocaleString()}`);
+        console.log(`   项目: ${b.items.join(', ')}`);
+        console.log();
+    });
+}
+async function main() {
+    const args = process.argv.slice(2);
+    const command = args[0];
+    switch (command) {
+        case 'install':
+            console.log('✅ 插件已安装！');
+            console.log('🌐 启动 Web UI: openclaw-config-guardian webui');
+            console.log('📊 查看状态: openclaw-config-guardian status');
+            break;
+        case 'uninstall':
+            console.log('🗑️  插件已卸载');
+            break;
+        case 'status':
+            showStatus();
+            break;
+        case 'config':
+            showConfig();
+            break;
+        case 'backup':
+            console.log('💾 执行手动备份...');
+            const result = createBackup();
+            if (!result.success) {
+                process.exit(1);
+            }
+            break;
+        case 'restore':
+            const backupId = args[1];
+            if (!backupId) {
+                console.error('❌ 请指定备份 ID');
+                console.log('用法: openclaw-config-guardian restore <backup-id>');
+                showList();
+                process.exit(1);
+            }
+            restoreBackup(backupId);
+            break;
+        case 'delete':
+            const deleteId = args[1];
+            if (!deleteId) {
+                console.error('❌ 请指定备份 ID');
+                console.log('用法: openclaw-config-guardian delete <backup-id>');
+                process.exit(1);
+            }
+            const deleteResult = deleteBackup(deleteId);
+            if (!deleteResult.success) {
+                console.error('❌ 删除失败:', deleteResult.error);
+                process.exit(1);
+            }
+            break;
+        case 'list':
+            showList();
+            break;
+        case 'webui':
+            const port = args[1] ? parseInt(args[1]) : undefined;
+            const { startWebUI } = await import('./webui.js');
+            startWebUI(port);
+            break;
+        case 'help':
+        case '--help':
+        case '-h':
+        default:
+            printUsage();
+            break;
+    }
+}
+main().catch(err => {
+    console.error('❌ 错误:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/core.d.ts

@@ -0,0 +1,36 @@
+export interface BackupConfig {
+    autoBackup: boolean;
+    maxBackups: number;
+    webUIPort: number;
+    backupItems: string[];
+    lastBackup?: string;
+}
+export interface BackupMeta {
+    timestamp: string;
+    version: string;
+    items: string[];
+}
+export interface BackupInfo {
+    id: string;
+    timestamp: string;
+    items: string[];
+}
+export declare function getConfig(): BackupConfig;
+export declare function saveConfig(config: BackupConfig): void;
+export declare function checkOpenClawHealth(): boolean;
+export declare function createBackup(): {
+    success: boolean;
+    backupId?: string;
+    error?: string;
+};
+export declare function cleanupOldBackups(maxBackups?: number): void;
+export declare function listBackups(): BackupInfo[];
+export declare function restoreBackup(backupId: string): {
+    success: boolean;
+    error?: string;
+};
+export declare function deleteBackup(backupId: string): {
+    success: boolean;
+    error?: string;
+};
+//# sourceMappingURL=core.d.ts.map

package/dist/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,wBAAgB,SAAS,IAAI,YAAY,CAYxC;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CAGrD;AAED,wBAAgB,mBAAmB,IAAI,OAAO,CAO7C;AAED,wBAAgB,YAAY,IAAI;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAgEtF;AAED,wBAAgB,iBAAiB,CAAC,UAAU,GAAE,MAAW,GAAG,IAAI,CAkB/D;AAED,wBAAgB,WAAW,IAAI,UAAU,EAAE,CAoB1C;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CA6EpF;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAenF"}

package/dist/core.js

@@ -0,0 +1,228 @@
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const PLUGIN_DIR = path.join(process.env.HOME || process.env.USERPROFILE || '', '.openclaw', 'extensions', 'openclaw-config-guardian');
+const CONFIG_FILE = path.join(PLUGIN_DIR, 'config.json');
+const BACKUPS_DIR = path.join(PLUGIN_DIR, 'backups');
+const OPENCLAW_DIR = path.join(process.env.HOME || process.env.USERPROFILE || '', '.openclaw');
+// 默认配置
+const DEFAULT_BACKUP_ITEMS = [
+    'config.json',
+    'gateway.json',
+    'agents.json',
+    'skills.json',
+    'memory',
+    'workspace'
+];
+export function getConfig() {
+    if (!fs.existsSync(CONFIG_FILE)) {
+        const defaultConfig = {
+            autoBackup: true,
+            maxBackups: 10,
+            webUIPort: 3456,
+            backupItems: DEFAULT_BACKUP_ITEMS
+        };
+        saveConfig(defaultConfig);
+        return defaultConfig;
+    }
+    return JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf8'));
+}
+export function saveConfig(config) {
+    fs.mkdirSync(PLUGIN_DIR, { recursive: true });
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+export function checkOpenClawHealth() {
+    try {
+        const result = execSync('openclaw gateway status', { encoding: 'utf8', timeout: 10000 });
+        return result.includes('running') || result.includes('active');
+    }
+    catch {
+        return false;
+    }
+}
+export function createBackup() {
+    const config = getConfig();
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const backupId = `backup-${timestamp}`;
+    const backupDir = path.join(BACKUPS_DIR, backupId);
+    console.log(`[${new Date().toLocaleString()}] 开始备份...`);
+    // 检查 OpenClaw 健康状态
+    if (!checkOpenClawHealth()) {
+        console.log('⚠️  OpenClaw 状态异常，跳过本次备份');
+        return { success: false, error: 'OpenClaw is not running' };
+    }
+    try {
+        fs.mkdirSync(backupDir, { recursive: true });
+        // 备份元数据
+        const meta = {
+            timestamp: new Date().toISOString(),
+            version: '1.0.0',
+            items: []
+        };
+        // 备份各项
+        for (const item of config.backupItems) {
+            const sourcePath = path.join(OPENCLAW_DIR, item);
+            const destPath = path.join(backupDir, item);
+            if (fs.existsSync(sourcePath)) {
+                const stat = fs.statSync(sourcePath);
+                if (stat.isDirectory()) {
+                    fs.cpSync(sourcePath, destPath, { recursive: true });
+                }
+                else {
+                    fs.copyFileSync(sourcePath, destPath);
+                }
+                meta.items.push(item);
+                console.log(`  ✓ ${item}`);
+            }
+            else {
+                console.log(`  ⚠ ${item} (不存在)`);
+            }
+        }
+        // 保存元数据
+        fs.writeFileSync(path.join(backupDir, 'meta.json'), JSON.stringify(meta, null, 2));
+        // 更新配置
+        config.lastBackup = timestamp;
+        saveConfig(config);
+        // 清理旧备份
+        cleanupOldBackups(config.maxBackups);
+        console.log(`✅ 备份完成: ${backupId}`);
+        return { success: true, backupId };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        console.error('❌ 备份失败:', error);
+        // 清理失败的备份
+        if (fs.existsSync(backupDir)) {
+            fs.rmSync(backupDir, { recursive: true });
+        }
+        return { success: false, error };
+    }
+}
+export function cleanupOldBackups(maxBackups = 10) {
+    if (!fs.existsSync(BACKUPS_DIR))
+        return;
+    const backups = fs.readdirSync(BACKUPS_DIR)
+        .filter(d => d.startsWith('backup-'))
+        .map(d => ({
+        name: d,
+        path: path.join(BACKUPS_DIR, d),
+        time: fs.statSync(path.join(BACKUPS_DIR, d)).mtime.getTime()
+    }))
+        .sort((a, b) => b.time - a.time);
+    // 保留最近 N 个
+    const toDelete = backups.slice(maxBackups);
+    for (const backup of toDelete) {
+        fs.rmSync(backup.path, { recursive: true });
+        console.log(`🗑️  清理旧备份: ${backup.name}`);
+    }
+}
+export function listBackups() {
+    if (!fs.existsSync(BACKUPS_DIR)) {
+        return [];
+    }
+    return fs.readdirSync(BACKUPS_DIR)
+        .filter(d => d.startsWith('backup-'))
+        .map(d => {
+        const metaPath = path.join(BACKUPS_DIR, d, 'meta.json');
+        let meta = {};
+        if (fs.existsSync(metaPath)) {
+            meta = JSON.parse(fs.readFileSync(metaPath, 'utf8'));
+        }
+        return {
+            id: d,
+            timestamp: meta.timestamp || d.replace('backup-', ''),
+            items: meta.items || []
+        };
+    })
+        .sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+}
+export function restoreBackup(backupId) {
+    const backupDir = path.join(BACKUPS_DIR, backupId);
+    if (!fs.existsSync(backupDir)) {
+        console.error(`❌ 备份不存在: ${backupId}`);
+        return { success: false, error: `Backup not found: ${backupId}` };
+    }
+    console.log(`🔄 准备回滚到: ${backupId}`);
+    console.log('⚠️  这将覆盖当前配置，请确认...');
+    try {
+        // 先创建当前配置的紧急备份
+        const emergencyBackup = path.join(BACKUPS_DIR, `emergency-${Date.now()}`);
+        fs.mkdirSync(emergencyBackup, { recursive: true });
+        const items = ['config.json', 'gateway.json', 'agents.json', 'skills.json'];
+        for (const item of items) {
+            const sourcePath = path.join(OPENCLAW_DIR, item);
+            if (fs.existsSync(sourcePath)) {
+                fs.copyFileSync(sourcePath, path.join(emergencyBackup, item));
+            }
+        }
+        console.log(`📦 已创建紧急备份: ${path.basename(emergencyBackup)}`);
+        // 停止 gateway
+        console.log('🛑 停止 OpenClaw Gateway...');
+        try {
+            execSync('openclaw gateway stop', { timeout: 30000 });
+        }
+        catch {
+            console.log('  ⚠️  gateway 可能未运行');
+        }
+        // 恢复备份
+        console.log('📂 恢复配置文件中...');
+        const metaPath = path.join(backupDir, 'meta.json');
+        const meta = fs.existsSync(metaPath)
+            ? JSON.parse(fs.readFileSync(metaPath, 'utf8'))
+            : { items: [], timestamp: '', version: '' };
+        for (const item of meta.items || []) {
+            const sourcePath = path.join(backupDir, item);
+            const destPath = path.join(OPENCLAW_DIR, item);
+            if (fs.existsSync(sourcePath)) {
+                // 删除现有文件/目录
+                if (fs.existsSync(destPath)) {
+                    fs.rmSync(destPath, { recursive: true });
+                }
+                // 复制备份
+                const stat = fs.statSync(sourcePath);
+                if (stat.isDirectory()) {
+                    fs.cpSync(sourcePath, destPath, { recursive: true });
+                }
+                else {
+                    fs.copyFileSync(sourcePath, destPath);
+                }
+                console.log(`  ✓ ${item}`);
+            }
+        }
+        // 启动 gateway
+        console.log('🚀 启动 OpenClaw Gateway...');
+        try {
+            execSync('openclaw gateway start', { timeout: 30000 });
+            console.log('✅ Gateway 已启动');
+        }
+        catch {
+            console.error('❌ 启动失败，请手动检查');
+        }
+        console.log('✅ 回滚完成！');
+        return { success: true };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        console.error('❌ 回滚失败:', error);
+        return { success: false, error };
+    }
+}
+export function deleteBackup(backupId) {
+    const backupDir = path.join(BACKUPS_DIR, backupId);
+    if (!fs.existsSync(backupDir)) {
+        return { success: false, error: `Backup not found: ${backupId}` };
+    }
+    try {
+        fs.rmSync(backupDir, { recursive: true });
+        console.log(`🗑️  已删除备份: ${backupId}`);
+        return { success: true };
+    }
+    catch (err) {
+        const error = err instanceof Error ? err.message : String(err);
+        return { success: false, error };
+    }
+}
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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"}

package/dist/daemon.d.ts

@@ -0,0 +1,4 @@
+export declare function startAutoBackup(): void;
+export declare function stopAutoBackup(): void;
+export declare function init(): void;
+//# sourceMappingURL=daemon.d.ts.map

package/dist/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAOA,wBAAgB,eAAe,IAAI,IAAI,CAYtC;AAED,wBAAgB,cAAc,IAAI,IAAI,CAMrC;AAED,wBAAgB,IAAI,IAAI,IAAI,CAmB3B"}

package/dist/daemon.js

@@ -0,0 +1,42 @@
+import fs from 'fs';
+import path from 'path';
+import cron from 'node-cron';
+import { getConfig, createBackup } from './core.js';
+let backupJob = null;
+export function startAutoBackup() {
+    if (backupJob) {
+        backupJob.stop();
+    }
+    // 每24小时执行一次（每天凌晨2点）
+    backupJob = cron.schedule('0 2 * * *', () => {
+        console.log('[定时任务] 执行自动备份...');
+        createBackup();
+    });
+    console.log('✅ 自动备份已启用（每天凌晨2点）');
+}
+export function stopAutoBackup() {
+    if (backupJob) {
+        backupJob.stop();
+        backupJob = null;
+    }
+    console.log('⏹️  自动备份已停止');
+}
+export function init() {
+    const config = getConfig();
+    if (config.autoBackup) {
+        startAutoBackup();
+    }
+    // 监听配置变化
+    const PLUGIN_DIR = path.join(process.env.HOME || process.env.USERPROFILE || '', '.openclaw', 'extensions', 'openclaw-config-guardian');
+    const CONFIG_FILE = path.join(PLUGIN_DIR, 'config.json');
+    fs.watchFile(CONFIG_FILE, () => {
+        const newConfig = getConfig();
+        if (newConfig.autoBackup && !backupJob) {
+            startAutoBackup();
+        }
+        else if (!newConfig.autoBackup && backupJob) {
+            stopAutoBackup();
+        }
+    });
+}
+//# sourceMappingURL=daemon.js.map

package/dist/daemon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.js","sourceRoot":"","sources":["../src/daemon.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAc,YAAY,EAAE,MAAM,WAAW,CAAC;AAEhE,IAAI,SAAS,GAA8B,IAAI,CAAC;AAEhD,MAAM,UAAU,eAAe;IAC7B,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,CAAC,IAAI,EAAE,CAAC;IACnB,CAAC;IAED,oBAAoB;IACpB,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,GAAG,EAAE;QAC1C,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QAChC,YAAY,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;IAEH,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,IAAI,SAAS,EAAE,CAAC;QACd,SAAS,CAAC,IAAI,EAAE,CAAC;QACjB,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,IAAI;IAClB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAE3B,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,eAAe,EAAE,CAAC;IACpB,CAAC;IAED,SAAS;IACT,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,EAAE,WAAW,EAAE,YAAY,EAAE,0BAA0B,CAAC,CAAC;IACvI,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;IAEzD,EAAE,CAAC,SAAS,CAAC,WAAW,EAAE,GAAG,EAAE;QAC7B,MAAM,SAAS,GAAG,SAAS,EAAE,CAAC;QAC9B,IAAI,SAAS,CAAC,UAAU,IAAI,CAAC,SAAS,EAAE,CAAC;YACvC,eAAe,EAAE,CAAC;QACpB,CAAC;aAAM,IAAI,CAAC,SAAS,CAAC,UAAU,IAAI,SAAS,EAAE,CAAC;YAC9C,cAAc,EAAE,CAAC;QACnB,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { init } from './daemon.js';
+export * from './core.js';
+export * from './webui.js';
+export * from './daemon.js';
+declare const _default: {
+    init: typeof init;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGnC,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;;;;AAG5B,wBAAwB"}

package/dist/index.js

@@ -0,0 +1,8 @@
+import { init } from './daemon.js';
+// 导出主要功能
+export * from './core.js';
+export * from './webui.js';
+export * from './daemon.js';
+// 默认导出
+export default { init };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,SAAS;AACT,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAE5B,OAAO;AACP,eAAe,EAAE,IAAI,EAAE,CAAC"}

package/dist/webui.d.ts

@@ -0,0 +1,2 @@
+export declare function startWebUI(port?: number): void;
+//# sourceMappingURL=webui.d.ts.map

package/dist/webui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webui.d.ts","sourceRoot":"","sources":["../src/webui.ts"],"names":[],"mappings":"AA2EA,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ9C"}

package/dist/webui.js

@@ -0,0 +1,77 @@
+import express from 'express';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { getConfig, saveConfig, createBackup, listBackups, restoreBackup, deleteBackup, checkOpenClawHealth } from './core.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+const app = express();
+app.use(express.json());
+// 静态文件服务
+const webuiPath = path.join(__dirname, '..', 'webui');
+app.use(express.static(webuiPath));
+// API 路由
+// 获取配置
+app.get('/api/config', (req, res) => {
+    res.json(getConfig());
+});
+// 更新配置
+app.post('/api/config', (req, res) => {
+    const config = getConfig();
+    if (req.body.autoBackup !== undefined) {
+        config.autoBackup = req.body.autoBackup;
+    }
+    if (req.body.maxBackups !== undefined) {
+        config.maxBackups = req.body.maxBackups;
+    }
+    if (req.body.webUIPort !== undefined) {
+        config.webUIPort = req.body.webUIPort;
+    }
+    if (req.body.backupItems !== undefined) {
+        config.backupItems = req.body.backupItems;
+    }
+    saveConfig(config);
+    res.json({ success: true, config });
+});
+// 获取备份列表
+app.get('/api/backups', (req, res) => {
+    res.json(listBackups());
+});
+// 立即备份
+app.post('/api/backup', async (req, res) => {
+    const result = createBackup();
+    res.json(result);
+});
+// 回滚备份
+app.post('/api/restore/:id', (req, res) => {
+    const backupId = req.params.id;
+    const result = restoreBackup(backupId);
+    res.json(result);
+});
+// 删除备份
+app.delete('/api/backups/:id', (req, res) => {
+    const backupId = req.params.id;
+    const result = deleteBackup(backupId);
+    res.json(result);
+});
+// 获取 OpenClaw 状态
+app.get('/api/status', (req, res) => {
+    res.json({
+        gateway: checkOpenClawHealth() ? 'running' : 'stopped',
+        config: getConfig()
+    });
+});
+// 启动服务器
+export function startWebUI(port) {
+    const config = getConfig();
+    const actualPort = port || config.webUIPort || 3456;
+    app.listen(actualPort, () => {
+        console.log(`🌐 Config Guardian Web UI 已启动`);
+        console.log(`📍 访问地址: http://localhost:${actualPort}`);
+    });
+}
+// 如果是直接运行
+if (import.meta.url === `file://${process.argv[1]}`) {
+    const port = process.argv[2] ? parseInt(process.argv[2]) : undefined;
+    startWebUI(port);
+}
+//# sourceMappingURL=webui.js.map

package/dist/webui.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webui.js","sourceRoot":"","sources":["../src/webui.ts"],"names":[],"mappings":"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"}

package/openclaw.plugin.json

@@ -0,0 +1,39 @@
+{
+  "id": "openclaw-config-guardian",
+  "name": "OpenClaw Config Guardian",
+  "description": "Auto backup & one-click rollback for OpenClaw configuration. Protect your configs with scheduled backups and easy restore via Web UI or CLI.",
+  "channels": [],
+  "extensions": [],
+  "skills": ["skills/config-guardian"],
+  "capabilities": {
+    "proactiveMessaging": false,
+    "cronJobs": true
+  },
+  "configSchema": {
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+      "autoBackup": {
+        "type": "boolean",
+        "default": true,
+        "description": "Enable automatic daily backups at 2:00 AM"
+      },
+      "maxBackups": {
+        "type": "number",
+        "default": 10,
+        "description": "Maximum number of backups to keep (old ones auto-deleted)"
+      },
+      "webUIPort": {
+        "type": "number",
+        "default": 3456,
+        "description": "Port for the Web UI"
+      },
+      "backupItems": {
+        "type": "array",
+        "items": { "type": "string" },
+        "default": ["config.json", "gateway.json", "agents.json", "skills.json", "memory", "workspace"],
+        "description": "Files and directories to backup"
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "openclaw-config-guardian",
+  "version": "1.0.0",
+  "description": "OpenClaw Config Guardian - Auto backup & one-click rollback for OpenClaw configuration",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "openclaw-config-guardian": "bin/cli.js",
+    "ocg": "bin/cli.js"
+  },
+  "files": [
+    "dist",
+    "bin",
+    "scripts",
+    "skills",
+    "openclaw.plugin.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "openclaw": {
+    "id": "openclaw-config-guardian",
+    "extensions": [],
+    "skills": [
+      "skills/config-guardian"
+    ]
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepack": "npm run build",
+    "postinstall": "node scripts/postinstall.js",
+    "test": "echo \"No tests yet\""
+  },
+  "keywords": [
+    "openclaw",
+    "openclaw-plugin",
+    "backup",
+    "config",
+    "guardian",
+    "rollback",
+    "restore"
+  ],
+  "author": "dingclaw",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/openclaw/config-guardian.git"
+  },
+  "bugs": {
+    "url": "https://github.com/openclaw/config-guardian/issues"
+  },
+  "homepage": "https://github.com/openclaw/config-guardian#readme",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "express": "^4.18.2",
+    "node-cron": "^3.0.3"
+  },
+  "devDependencies": {
+    "@types/express": "^4.17.21",
+    "@types/node": "^20.0.0",
+    "@types/node-cron": "^3.0.11",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "openclaw": ">=1.0.0"
+  }
+}

package/scripts/install.sh

@@ -0,0 +1,89 @@
+#!/bin/bash
+
+# OpenClaw Config Guardian 一键安装脚本
+# 支持: npm install, npx, curl | bash
+
+set -e
+
+echo "🛡️  OpenClaw Config Guardian 安装器"
+echo "======================================"
+
+# 颜色定义
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+NC='\033[0m' # No Color
+
+# 检查 Node.js
+if ! command -v node &> /dev/null; then
+    echo -e "${RED}❌ 未检测到 Node.js，请先安装 Node.js 18+${NC}"
+    echo "   访问: https://nodejs.org/"
+    exit 1
+fi
+
+NODE_VERSION=$(node --version | cut -d'v' -f2 | cut -d'.' -f1)
+if [ "$NODE_VERSION" -lt 18 ]; then
+    echo -e "${RED}❌ Node.js 版本过低，需要 18+，当前: $(node --version)${NC}"
+    exit 1
+fi
+
+echo -e "${GREEN}✓ Node.js $(node --version)${NC}"
+
+# 检查 npm
+if ! command -v npm &> /dev/null; then
+    echo -e "${RED}❌ 未检测到 npm${NC}"
+    exit 1
+fi
+
+echo -e "${GREEN}✓ npm $(npm --version)${NC}"
+
+# 检查 OpenClaw
+if ! command -v openclaw &> /dev/null; then
+    echo -e "${YELLOW}⚠️  未检测到 OpenClaw CLI${NC}"
+    echo "   插件仍可安装，但部分功能需要 OpenClaw"
+else
+    echo -e "${GREEN}✓ OpenClaw 已安装${NC}"
+fi
+
+echo ""
+echo "📦 正在安装 @openclaw/config-guardian..."
+echo ""
+
+# 安装方式选择
+if [ "$1" == "--local" ] || [ "$1" == "-l" ]; then
+    # 本地开发安装
+    echo "🔧 本地开发模式"
+    npm install -g .
+else
+    # 从 npm 安装
+    npm install -g @openclaw/config-guardian@latest
+fi
+
+echo ""
+echo -e "${GREEN}✅ 安装完成！${NC}"
+echo ""
+echo "使用方法:"
+echo ""
+echo "  命令行:"
+echo "    ocg status          - 查看状态"
+echo "    ocg backup          - 立即备份"
+echo "    ocg restore <id>    - 回滚到指定备份"
+echo "    ocg list            - 列出所有备份"
+echo "    ocg webui           - 启动 Web UI"
+echo "    ocg help            - 显示帮助"
+echo ""
+echo "  npx 方式 (无需全局安装):"
+echo "    npx @openclaw/config-guardian status"
+echo "    npx @openclaw/config-guardian webui"
+echo ""
+echo "🌐 Web UI 默认地址: http://localhost:3456"
+echo ""
+echo "配置文件: ~/.openclaw/extensions/openclaw-config-guardian/config.json"
+echo ""
+
+# 提示启动 Web UI
+read -p "是否立即启动 Web UI? (y/N): " -n 1 -r
+echo
+if [[ $REPLY =~ ^[Yy]$ ]]; then
+    ocg webui
+fi

package/scripts/postinstall.js

@@ -0,0 +1,60 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const PLUGIN_DIR = path.join(process.env.HOME || process.env.USERPROFILE || '', '.openclaw', 'extensions', 'openclaw-config-guardian');
+
+console.log('🛡️  OpenClaw Config Guardian 安装后配置...');
+
+try {
+  // 创建插件目录
+  fs.mkdirSync(PLUGIN_DIR, { recursive: true });
+  
+  // 创建备份目录
+  fs.mkdirSync(path.join(PLUGIN_DIR, 'backups'), { recursive: true });
+  
+  // 创建默认配置
+  const configPath = path.join(PLUGIN_DIR, 'config.json');
+  if (!fs.existsSync(configPath)) {
+    const defaultConfig = {
+      autoBackup: true,
+      maxBackups: 10,
+      webUIPort: 3456,
+      backupItems: [
+        'config.json',
+        'gateway.json',
+        'agents.json',
+        'skills.json',
+        'memory',
+        'workspace'
+      ]
+    };
+    fs.writeFileSync(configPath, JSON.stringify(defaultConfig, null, 2));
+    console.log('✅ 默认配置已创建');
+  }
+  
+  console.log('');
+  console.log('🎉 安装完成！');
+  console.log('');
+  console.log('快速开始:');
+  console.log('  npx openclaw-config-guardian status    - 查看状态');
+  console.log('  npx openclaw-config-guardian backup    - 立即备份');
+  console.log('  npx openclaw-config-guardian webui     - 启动 Web UI');
+  console.log('');
+  console.log('或使用简写:');
+  console.log('  ocg status');
+  console.log('  ocg backup');
+  console.log('  ocg webui');
+  console.log('');
+  console.log('🌐 Web UI 地址: http://localhost:3456');
+  console.log('');
+} catch (err) {
+  console.error('❌ 配置失败:', err.message);
+  process.exit(1);
+}

package/skills/config-guardian/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: config-guardian
+description: OpenClaw 配置守护者 - 自动备份与一键回滚。支持定时备份、Web UI 管理、命令行操作。
+metadata: {"openclaw":{"emoji":"🛡️","requires":{"config":["config-guardian"]}}}
+---
+
+# Config Guardian 技能
+
+## 功能
+
+- 🔄 **自动备份**: 每天凌晨 2 点自动备份配置
+- 🌐 **Web UI**: 图形界面管理备份
+- ⚡ **一键回滚**: 快速恢复到任意备份点
+- 🏥 **健康检测**: 备份前自动检查 OpenClaw 状态
+- 🧹 **自动清理**: 保留最近 N 个备份，自动删除旧备份
+
+## 使用方式
+
+### 1. Web UI（推荐）
+
+```bash
+openclaw config-guardian webui
+```
+
+访问 http://localhost:3456
+
+### 2. 命令行
+
+```bash
+# 查看状态
+openclaw config-guardian status
+
+# 立即备份
+openclaw config-guardian backup
+
+# 回滚到指定备份
+openclaw config-guardian restore <backup-id>
+
+# 列出所有备份
+openclaw config-guardian list
+```
+
+### 3. 配置
+
+编辑 `~/.openclaw/config.json`:
+
+```json
+{
+  "config-guardian": {
+    "autoBackup": true,
+    "maxBackups": 10,
+    "webUIPort": 3456,
+    "backupItems": [
+      "config.json",
+      "gateway.json",
+      "agents.json",
+      "skills.json",
+      "memory",
+      "workspace"
+    ]
+  }
+}
+```
+
+## 备份内容
+
+默认备份以下文件和目录：
+- `config.json` - 主配置
+- `gateway.json` - 网关配置
+- `agents.json` - 代理配置
+- `skills.json` - 技能配置
+- `memory/` - 记忆文件
+- `workspace/` - 工作空间
+
+## API 接口
+
+Web UI 提供以下 REST API：
+
+| 接口 | 方法 | 说明 |
+|------|------|------|
+| `/api/config` | GET/POST | 获取/更新配置 |
+| `/api/backups` | GET | 获取备份列表 |
+| `/api/backup` | POST | 立即执行备份 |
+| `/api/restore/:id` | POST | 回滚到指定备份 |
+| `/api/status` | GET | 获取 OpenClaw 状态 |
+
+## 安全说明
+
+- 回滚前会自动创建紧急备份
+- 仅在 OpenClaw 运行正常时执行备份
+- 备份文件存储在本地，不会上传云端