OpenClaw Config Manager Skill
概述
OpenClaw配置管理Skill，提供完整的配置备份、恢复、迁移和版本控制功能。
功能特性
🔄 配置管理
- 智能备份：自动识别和备份关键配置
- 一键恢复：从备份快速恢复系统
- 跨环境迁移：支持不同环境间的配置迁移
- 版本控制：集成Git进行配置版本管理
🔐 安全特性
- 敏感信息脱敏：自动处理API密钥等敏感信息
- 加密存储：支持配置文件的加密存储
- 权限控制：细粒度的访问权限管理
🚀 自动化
- 定时备份：支持定时自动备份
- 变更检测：自动检测配置变更
- 健康检查：配置完整性验证
安装
方式一：从ClawHub安装
clawhub install openclaw-config-manager方式二：手动安装
# 克隆仓库
git clone https://github.com/wisdom-wozoy/openclaw-config-manager.git
# 安装依赖
cd openclaw-config-manager
npm install
# 注册Skill
openclaw skills register ./openclaw-config-manager快速开始
1. 初始化配置仓库
/config git init --url https://github.com/your-username/your-repo2. 首次备份
/config backup --git --message "初始配置备份"3. 在新环境恢复
/config restore --git --url https://github.com/your-username/your-repo命令参考
备份命令
# 备份到Git
/config backup --git --message "备份说明"
# 备份到本地文件
/config backup --output ./backup-$(date +%Y%m%d).tar.gz
# 定时备份
/config backup --schedule "0 2 * * *" # 每天凌晨2点恢复命令
# 从Git恢复
/config restore --git --url https://github.com/username/repo
# 从文件恢复
/config restore --input ./backup.tar.gz
# 恢复特定版本
/config restore --git --commit v1.0.0迁移命令
# 迁移到新服务器
/config migrate --target ssh://user@new-server --env production
# 测试迁移
/config migrate --dry-run --target ssh://user@new-serverGit集成命令
# 初始化Git仓库
/config git init --url <repository-url>
# 推送更新
/config git push --message "更新说明"
# 拉取更新
/config git pull
# 查看历史
/config git log --oneline
# 创建标签
/config git tag --name v1.0.0 --message "版本1.0.0"敏感信息管理
# 加密敏感信息
/config secrets --encrypt --output ./secrets.enc
# 解密敏感信息
/config secrets --decrypt --input ./secrets.enc
# 轮换密钥
/config secrets --rotate配置选项
Skill配置
在 openclaw.json 中添加：
{
"skills": {
"openclaw-config-manager": {
"backup": {
"schedule": "0 2 * * *",
"retention": 30,
"include": ["agents", "workspaces", "config"],
"exclude": ["logs", "temp", "cache"]
},
"git": {
"repository": "https://github.com/username/repo.git",
"branch": "main",
"autoPush": true
},
"security": {
"encryption": "aes-256-gcm",
"keyRotation": 90
}
}
}
}环境变量
# Git认证
export OPENCLAW_GIT_TOKEN="your-github-token"
export OPENCLAW_GIT_SSH_KEY="~/.ssh/id_ed25519"
# 加密密钥
export OPENCLAW_ENCRYPTION_KEY="your-encryption-key"
# 备份存储
export OPENCLAW_BACKUP_PATH="/backups/openclaw"使用场景
场景1：日常备份
# 设置定时备份
/config backup --schedule "0 2 * * *" --git --auto-push
# 手动触发备份
/config backup --now场景2：环境迁移
# 1. 在源环境备份
/config backup --output ./migration.tar.gz
# 2. 传输到目标环境
scp ./migration.tar.gz user@new-server:/tmp/
# 3. 在目标环境恢复
/config restore --input /tmp/migration.tar.gz场景3：团队协作
# 1. 初始化团队仓库
/config git init --url https://github.com/team/openclaw-config
# 2. 添加团队成员
/config git collaborators --add user1@example.com --role admin
/config git collaborators --add user2@example.com --role maintainer
# 3. 设置分支保护
/config git protect --branch main --require-review --require-checks场景4：灾难恢复
# 1. 从最新备份恢复
/config restore --git --latest
# 2. 验证恢复
/config validate --full
# 3. 启动服务
openclaw gateway restart高级功能
增量备份
# 启用增量备份
/config backup --incremental --git
# 查看备份差异
/config diff --commit1 HEAD~1 --commit2 HEAD配置验证
# 验证配置完整性
/config validate --full
# 检查配置语法
/config validate --syntax
# 测试配置功能
/config validate --test监控和告警
# 监控配置变更
/config monitor --watch
# 设置变更告警
/config monitor --alert email --recipient admin@example.com故障排除
常见问题
问题1：Git推送失败
# 检查Git配置
/config git status
# 重新配置认证
/config git auth --token new-token
# 强制推送
/config git push --force问题2：恢复失败
# 查看恢复日志
/config restore --log-level debug
# 尝试分步恢复
/config restore --step-by-step
# 使用备份验证
/config backup --verify问题3：权限问题
# 检查文件权限
/config validate --permissions
# 修复权限
/config fix --permissions
# 以管理员运行
sudo /config restore --input ./backup.tar.gz调试模式
# 启用详细日志
/config backup --verbose --debug
# 查看Skill状态
/config status --detailed开发指南
项目结构
openclaw-config-manager/
├── SKILL.md # Skill说明文档
├── package.json # Skill配置
├── src/
│ ├── commands/ # 命令实现
│ │ ├── backup.js # 备份命令
│ │ ├── restore.js # 恢复命令
│ │ ├── migrate.js # 迁移命令
│ │ └── git.js # Git集成命令
│ ├── utils/ # 工具函数
│ │ ├── config.js # 配置处理
│ │ ├── security.js # 安全处理
│ │ └── validation.js # 验证工具
│ └── templates/ # 模板文件
│ ├── openclaw.json.template
│ └── secrets.env.template
├── scripts/ # 辅助脚本
│ ├── deploy.sh
│ ├── restore.sh
│ └── backup.sh
└── docs/ # 文档
├── README.md
├── QUICKSTART.md
└── API.md扩展开发
// 添加新命令示例
module.exports = {
name: 'custom-command',
description: '自定义命令',
async execute(args, context) {
// 命令逻辑
}
};许可证
MIT License
支持
- 文档：https://github.com/wisdom-wozoy/openclaw-config-manager/docs
- 问题：https://github.com/wisdom-wozoy/openclaw-config-manager/issues
- 讨论：https://github.com/wisdom-wozoy/openclaw-config-manager/discussions
版本历史
v1.0.0 (2026-03-05)
- 初始版本发布
- 基础备份和恢复功能
- Git集成支持
- 敏感信息管理