【Bug已解决】openclaw: git integration failed / Cannot detect repository — OpenClaw Git 集成失败解决方案1. 问题描述OpenClaw 无法检测或集成 Git 仓库# Git 仓库未检测 $ openclaw 分析代码 Warning: Not a git repository Git features disabled. # 或 Git 命令失败 $ openclaw --auto-approve 提交代码 Error: git command failed fatal: not a git repository (or any of the parent directories) # 或 Git 配置缺失 $ openclaw 查看 git log Error: git config not found user.name and user.email not set. # 或在子目录无法检测 $ cd src openclaw git status Error: Cannot find .git directory这个问题在以下场景中特别常见不在 Git 仓库中在子目录启动Git 未安装Git 配置缺失.git 目录损坏权限不足2. 原因分析原因分类表原因分类具体表现占比不在仓库无 .git约 35%子目录启动找不到约 25%Git 未安装command not found约 15%配置缺失user.name约 15%.git 损坏corrupt约 5%权限不足EACCES约 5%3. 解决方案方案一初始化 Git 仓库最推荐# 步骤 1在项目根目录初始化 cd /project git init # 步骤 2配置 Git git config user.name Your Name git config user.email youremail.com # 步骤 3初始提交 git add -A git commit -m Initial commit # 步骤 4验证 openclaw git status方案二在根目录启动# 步骤 1切换到项目根目录 cd /project openclaw task # 步骤 2不要在子目录启动 # 错误: cd /project/src openclaw # 正确: cd /project openclaw # 步骤 3检查 .git ls -la /project/.git # 步骤 4验证 openclaw --debug 21 | grep -i git方案三安装 Git# 步骤 1检查 Git 是否安装 git --version # 步骤 2macOS brew install git # 步骤 3Ubuntu/Debian sudo apt install git # 步骤 4验证 git --version openclaw git status方案四配置 Git# 步骤 1检查配置 git config user.name git config user.email # 步骤 2如果为空设置 git config --global user.name Your Name git config --global user.email youremail.com # 步骤 3或项目级配置 git config user.name Your Name git config user.email youremail.com # 步骤 4验证 git config --list openclaw git log方案五修复 .git 目录# 步骤 1检查 .git 目录 ls -la .git/ # 步骤 2如果损坏 git fsck # 步骤 3如果严重损坏重新初始化 rm -rf .git git init git remote add origin url git fetch origin git reset --hard origin/main # 步骤 4验证 git status openclaw git status方案六使用 --working-dir# 步骤 1指定工作目录 openclaw --working-dir /project task # 步骤 2确保 /project 是 Git 仓库 ls /project/.git # 步骤 3验证 openclaw --working-dir /project git status # 步骤 4在子目录中使用 cd /project/src openclaw --working-dir /project task4. 各方案对比总结方案适用场景推荐指数难度方案一初始化无仓库⭐⭐⭐⭐⭐低方案二根目录子目录⭐⭐⭐⭐⭐低方案三安装 Git未安装⭐⭐⭐⭐⭐低方案四配置缺配置⭐⭐⭐⭐⭐低方案五修复 .git损坏⭐⭐⭐中方案六--working-dir指定⭐⭐⭐⭐⭐低5. 常见问题 FAQ5.1 如何检查是否在 Git 仓库git status # 或 ls .git5.2 如何初始化 Git 仓库git init git config user.name Name git config user.email email git add -A git commit -m Initial5.3 为什么在子目录找不到OpenClaw 在当前目录查找.git子目录可能找不到。在根目录启动。5.4 Git 未安装brew install git # macOS sudo apt install git # Linux5.5 Git 配置缺失git config --global user.name Name git config --global user.email email5.6 .git 损坏git fsck # 检查 # 或重新初始化5.7 如何指定工作目录openclaw --working-dir /project task5.8 Git 全局配置和项目配置全局:git config --global项目:git config不带 --global5.9 OpenClaw 需要什么 Git 功能读取 git log、git diff、git status 等信息来理解项目。5.10 排查清单速查表□ 1. git init 初始化仓库 □ 2. git config user.name/email □ 3. cd /project 根目录启动 □ 4. ls .git 检查 □ 5. git --version 检查安装 □ 6. brew install git / apt install git □ 7. git fsck 检查损坏 □ 8. openclaw --working-dir /project □ 9. git add commit 初始提交 □ 10. openclaw --debug | grep git 验证6. 总结根本原因Git 集成失败最常见原因是不在仓库35%和子目录启动25%最佳实践在项目根目录git init初始化仓库配置 Git设置user.name和user.email初始提交根目录启动cd /project openclaw task确保检测到 Git最佳实践建议使用openclaw --working-dir /project指定工作目录故障排查流程图flowchart TD A[Git 集成失败] -- B[git --version 检查] B -- C{Git 安装?} C --|否| D[brew/apt install git] C --|是| E[ls .git 检查] D -- E E -- F{在仓库中?} F --|否| G[git init] F --|是| H[在根目录启动] G -- I[git config user.name/email] I -- j[git add commit] j -- H H -- K[cd /project openclaw] K -- L{成功?} L --|是| M[✅ 问题解决] L --|否| N[检查配置] N -- O[git config user.name] O -- P{配置存在?} P --|否| Q[git config --global] P --|是| R[检查 .git 损坏] Q -- K R -- S[git fsck] S -- T{损坏?} T --|是| U[重新初始化] T --|否| V[使用 --working-dir] U -- G V -- W[openclaw --working-dir /project] W -- K K -- X{成功?} X --|是| M X --|否| Y[检查权限] Y -- Z[sudo chown -R $(whoami) .git] Z -- K M -- AA[长期: 根目录 git init 配置] AA -- AB[✅ 长期方案]