实践openclaw-concepts
Managed worktrees · OpenClaw — 给每个Agent任务独立的git分支和工作目录,避免污染源码仓库。
给每个Agent任务独立的git分支和工作目录,避免污染源码仓库。
2026-07-13原文
本文为要点摘要,完整细节以原文为准。
🧭 一图看懂
由原文自动提炼 · 以原文为准点击任一分支,查看这一点的一句话解读
OpenClaw 托管 worktree
每个 Agent 任务拥有独立 git 分支与检出,不污染源码仓库
- 记录在共享状态数据库
- 移除前快照已跟踪与未忽略文件
⚙️ 流程拆解
STEP 1创建 Agent 任务 worktree
STEP 2分配独立分支与检出
STEP 3记录到共享状态数据库
STEP 4执行任务并接受变更
STEP 5移除前快照内容
STEP 6清理并恢复原路径
🔗 涉及的概念与玩家
- OpenClaw产品
- Git方法
- Docker产品
- Podman产品
- Btrfs方法
- APFS方法
- ReFS方法
- worktreeRoot概念
- OpenClaw—管理…→Git
- OpenClaw—使用快照→Btrfs
- OpenClaw—使用克隆→APFS
- OpenClaw—使用块克隆→ReFS
- Docker—支持投影→OpenClaw
- Podman—支持投影→OpenClaw
- 每个工作树位于
<state-dir>/worktrees/<repo-fingerprint>/<name>,分支名为openclaw/<name>,基于请求的 base ref 创建。- 含义:Agent 任务获得隔离的 git 工作区,避免分支冲突和临时目录残留。
- 通过
.worktreeinclude文件(gitignore 模式)将选中的忽略/未跟踪文件复制到新工作树,不会覆盖已有文件。- 含义:允许 Agent 任务携带必要的本地配置(如 .env),同时保持仓库整洁。
- 删除工作树前会创建包含跟踪和非忽略未跟踪文件的快照提交,保留 30 天可恢复;脏工作树或含未推送提交的工作树不会被自动删除。
- 含义:Agent 任务的工作状态可安全回滚,避免意外丢失修改。
🕸 顺着图谱继续读
- openclaw v2026.9.4 — 一次发布暴露了发布链路本身的脆弱点2026-09-11 · 共同涉及 OpenClaw、Docker
- openclaw v2026.7.33 — 安全加固与消息完整性修复,126 个 PR 覆盖网关、插件与渠道。2026-09-18 · 共同涉及 OpenClaw、Git
- hermes-agent v2026.9.21 — 1800 个 PR 打包成稳定 tag,但真正的功能清单要等 v0.22.02026-09-21 · 共同涉及 Docker
- gemini-cli v0.58.0 — 修复沙箱隔离、忽略路径与历史回滚,提升 CLI 稳定性2026-09-01 · 共同涉及 Docker