一、底层本质

1. 核心定义

OpenClaw 的 workspace 是存放全部智能体配置资产的核心目录，包含 SOUL.md、AGENTS.md、技能配置、记忆日志、业务流程、自然语言编排脚本等整套数字公司核心资产，是硅基组织的全部源代码与经营档案。 自动实时备份至 Gitee，本质是一套内置轻量化 Git 自动化调度链路：依托智能体引擎内置 Git 客户端、定时 / 事件触发器，监控 workspace 文件变动，自动执行add→commit→push完整 Git 流程，把数字人组织全部配置资产增量同步至远程 Gitee 私有 / 公开仓库，实现资产版本留存、异地备份、多设备同步、历史回滚。

2. 四层底层逻辑拆解

1. 文件监控层 OpenClaw 内核实时监听 workspace 目录下所有文件的新增、修改、删除动作；区分配置文件、记忆日志、缓存临时文件，过滤无需备份的临时垃圾文件，仅捕获业务核心资产变更。
2. Git 自动化封装层 引擎内置 Git 能力，无需手动安装独立 Git 环境，内置账号凭证管理模块，缓存 Gitee 仓库地址、SSH 密钥 / 账号令牌，自动完成身份鉴权，规避每次推送重复登录。
3. 自动提交调度层 双模式触发：①实时触发：文件保存瞬间触发增量提交；②定时兜底：自定义周期定时批量推送，防止单次文件漏同步；自动生成语义化 commit 备注，记录变更时间、变更文件、操作行为。
4. 远程仓库同步层 基于 SSH/HTTPS 两种协议推送至 Gitee 远程仓库，完整保存每一轮数字组织架构调整、岗位新增、流程修改、业务迭代版本；支持任意历史版本一键回滚，相当于给硅基数字公司搭建完整版本管理系统。

3. 核心价值本质

1. 资产安全：本地磁盘损坏、系统重装不会丢失整套数字人组织架构；
2. 版本追溯：每一次自然语言编排调整都留存快照，可回退至任意稳定架构；
3. 多端协同：多设备部署同一套 OpenClaw，拉取 Gitee 仓库即可同步完整数字公司；
4. 资产复用：仓库可作为数字企业模板，快速复制、衍生全新业务智能体组织。

二、完整操作步骤

前置准备

1. 登录 Gitee，新建空白代码仓库，复制仓库 SSH 地址 / HTTPS 地址；
2. 本地设备生成 SSH 密钥（推荐，免密推送），将公钥添加至 Gitee 账号 SSH 公钥配置；
3. 确认 OpenClaw 正常启动，本地存在独立 workspace 工作目录。

步骤 1：进入 OpenClaw 系统配置面板，开启仓库备份插件

1. 打开 OpenClaw 网关 Web 管理端 / 终端控制台；
2. 找到「Workspace 资产备份」插件，启用 Git 自动同步开关；
3. 选择远程仓库平台：Gitee。

步骤 2：配置 Gitee 仓库连接信息（二选一）

方案 A SSH 免密（推荐）

1. 填入 Gitee 仓库 SSH 地址；
2. 配置本地 SSH 私钥文件路径，引擎自动读取完成鉴权；
3. 设置本地 Git 用户名、邮箱（用于 commit 记录标识）。

方案 B HTTPS 令牌模式

1. 填入 Gitee 仓库 HTTPS 地址；
2. 前往 Gitee 个人设置生成私人访问令牌，勾选仓库读写权限；
3. 将令牌填入密码输入框，用户名填写 Gitee 账号名。

步骤 3：配置备份规则（实时 + 兜底定时）

1. 文件监控范围：默认勾选全部 workspace 目录，可手动排除缓存文件夹、临时日志；
2. 触发模式开启「实时变更同步」：workspace 内 md 配置、技能脚本修改保存后自动触发提交；
3. 兜底定时同步：设置 10/30/60 分钟周期批量推送，应对批量大量文件修改场景；
4. 自动提交注释模板：内置模板[AutoBackup] 时间戳 | 变更文件列表，可自定义备注格式。

步骤 4：初始化本地 Git 仓库并首次推送

1. 点击「初始化仓库」按钮：OpenClaw 自动在 workspace 目录执行git init；
2. 自动生成.gitignore过滤临时缓存、运行日志、本地环境配置文件；
3. 执行首次全量 commit，推送全部现有 workspace 资产至 Gitee 远程主分支 main/master。

步骤 5：运行验证与日志查看

1. 修改任意核心配置文件（如 SOUL.md、新增子 Agent），保存文件；
2. 进入备份日志面板，查看自动执行流程：文件捕获→git add→git commit→git push；
3. 打开 Gitee 仓库网页，刷新查看文件同步完成，可查看每一条自动备份提交记录。

步骤 6：拓展配套能力（可选）

1. 分支管理：配置开发分支，区分测试版、正式版数字人组织；
2. 版本回滚：当编排逻辑出错时，在控制台选择 Gitee 历史 commit 版本，一键拉回本地 workspace；
3. 多设备同步：另一台设备 OpenClaw 填写同一 Gitee 仓库地址，拉取远程资产完成全量数字组织复刻。

三、关键补充说明

1. 实时备份并非单文件即时推送，内置短时间防抖机制：短时间连续修改多文件会合并为一次 commit，避免频繁提交产生大量冗余版本；
2. 记忆库大容量文件可配置忽略，仅同步核心编排配置，降低仓库存储占用；
3. 若本地断网，变更会缓存至本地 Git 暂存区，网络恢复后自动批量补推至 Gitee，不会丢失变更记录