---
name: vala_git_workspace_backup
description: 自动将OpenClaw workspace内容定期备份到Git仓库，自动过滤敏感信息，无硬编码凭证
---

# vala_git_workspace_backup Skill
## 功能说明
自动将OpenClaw workspace内容定期备份到Git仓库，自动过滤敏感信息，无硬编码凭证。
## 特性
- ✅ 全流程自动化，无需手动提前创建Git仓库
- ✅ 支持多数字员工共用同一个Git账号，按数字员工名称区分仓库
- ✅ 自动排除密钥、密码等敏感文件（secrets.md、.env、*.key等）
- ✅ 内置公司Git服务（git.valavala.com）支持，无需额外配置地址
- ✅ 支持自定义定时备份时间
- ✅ 敏感信息通过参数传入，不存储在skill代码中
- ✅ 自动生成备份日志，便于排查问题
## 完整执行流程
1. 检查传入的Git Token是否有效
2. 自动检查对应Git仓库是否存在，不存在则调用API自动创建
3. 初始化本地Git仓库（如果未初始化）
4. 配置.gitignore敏感文件过滤规则
5. 配置Git用户信息和远程仓库地址
6. 首次提交并推送所有非敏感文件
7. 创建备份执行脚本和日志目录
8. 添加定时任务到系统crontab，按指定时间自动执行备份
## 配置参数
| 参数名 | 类型 | 必填 | 说明 |
|--------|------|------|------|
| agent_name | string | 是 | 数字员工唯一名称（如xiaoyan/xiaoxi/xiaokui等），用于生成唯一仓库名 |
| git_token | string | 是 | Git仓库访问Token（所有数字员工共用同一个Git账号的Token） |
| git_username | string | 是 | Git用户名（所有数字员工共用同一个Git账号） |
| git_email | string | 是 | Git提交邮箱 |
| git_repo_url | string | 否 | Git仓库HTTPS地址（格式：https://域名/所有者/仓库名.git），默认使用公司git.valavala.com服务，自动生成仓库地址：https://git.valavala.com/{git_username}/ai_member_{agent_name}.git |
| cron_schedule | string | 否 | 定时任务cron表达式，默认值：`30 8 * * *`（每天早上8:30） |
## 使用方法
### 1. 初始化配置
传入上述参数执行skill的setup操作，自动完成Git初始化、远程仓库配置和定时任务设置。
### 2. 手动触发备份
执行`./scripts/backup.sh`可立即触发一次手动备份。
## 日志路径
备份日志存放于：`./logs/git_backup.log`
