[智能体-641]：OpenClaw Git 仓库初始化时机、触发条件与底层逻辑

Git 仓库初始化本质OpenClaw 在workspace目录下执行git init本质是给整套数字公司资产SOUL.md、AGENTS、技能配置、流程脚本等建立本地版本库只有初始化完成后自动备份、提交推送、版本回滚功能才能生效。初始化不会自动执行必须满足指定触发条件才会运行。二、四大初始化触发时机按执行先后1. 手动主动初始化最常用、推荐在 OpenClaw 后台「资产备份 / Git 同步」配置面板完成 Gitee 仓库地址、鉴权信息SSH 密钥 / 私人令牌填写后点击初始化仓库按钮引擎立刻执行进入 workspace 根目录执行git init自动生成适配 OpenClaw 的.gitignore过滤缓存、运行日志、本地数据库、临时缓存文件绑定远程仓库git remote add origin 你的Gitee仓库地址首次全量提交所有 workspace 内业务配置资产。 适用场景首次配置 Gitee 自动备份、更换新远程仓库。2. 自动检测无本地 Git 库保存备份配置时自动初始化操作流程填写完整 Gitee 仓库信息、开启实时备份、设置同步规则直接点击「保存配置」不手动点初始化按钮OpenClaw 内核扫描 workspace检测目录不存在.git隐藏文件夹后台静默自动执行git init、绑定远程、生成忽略文件无需人工干预。 触发前提备份插件已启用、远程仓库参数填写完整、本地无 Git 版本库。3. 首次触发自动备份文件变更 / 定时兜底同步延时初始化场景配置完备份但未保存、未手动初始化直接修改 workspace 内 SOUL.md/AGENTS.md 等配置文件文件监控捕获文件改动触发自动备份流程前置校验发现 workspace 无本地 Git 仓库自动执行初始化流程完成后再执行 add/commit/push 推送至 Gitee。 特点存在少量延时第一次修改会多一步初始化耗时后续变更直接同步。4. 多设备拉取远程仓库时初始化全新空白设备新设备部署 OpenClaw空白 workspace填写同一 Gitee 仓库地址执行「拉取远程资产」引擎先在空白 workspace 执行git init绑定远程源执行git pull拉取远端全部数字人组织配置完成多设备资产同步本地自动生成 Git 版本库。三、不会触发初始化的几种情况workspace 中已存在.git文件夹曾经初始化过无论重新保存配置、修改文件都不会重复执行git init仅打开备份配置页面未填写完整 Gitee 仓库地址、未开启同步开关仅临时启用备份插件但未填写远程仓库信息仅修改临时缓存文件、被.gitignore过滤的日志 / 数据库文件不会触发备份流程自然不会初始化 Git。四、补充关键细节初始化仅作用于workspace工作目录OpenClaw 程序本体安装目录不会纳入 Git 管理初始化只会执行一次后续更换 Gitee 仓库地址时引擎仅更新 remote 远程地址不再重复 init若初始化失败权限不足、目录只读备份日志会打印报错自动同步功能暂停需手动重新执行初始化按钮。