核心用法
OpenClaw Self-Improve 是一套面向代码库可度量改进的结构化工作流。用户通过 --mode 选择三种运行模式：audit-only（仅基线审计）、proposal-only（方案设计与审批，默认）、approved-implementation（仅实施已审批方案）。工作流强制要求定义可量化的成功标准与验证门控（validation gate），并在六个阶段产物（run-info、baseline、hypotheses、proposal、validation、outcome）中记录完整证据链。
关键 CLI 工具包括：
init-improvement-run.sh：脚手架生成运行目录与标准产物模板set-status.sh：无编辑器修改审批与验证状态validate-improvement-run.sh：完整性校验list-runs.sh/summarize-run.sh：历史运行枚举与单运行概览compare-runs.sh（v1.3.0 新增）：双运行并排对比，输出差异字段、outcome_progression（improved/regressed/same/changed/n/a）与 verdict，支持--json供 CI 分支判断export-improvement-run-json.py：机器可读 JSON 导出
典型工作流：--dry-run 预览 → 脚手架 → 基线测量 → 假设排序 → 审批门控 → 实施 → 验证 → outcome 报告 → validate-improvement-run.sh → JSON 导出。
显著优点
1. 度量优先：强制 baseline → change → validation 的量化闭环，拒绝无法验证的"优化"。
2. 审批门控：proposal-only 模式下，任何行为修改必须显式用户审批（--status approved），防止自动执行危险变更。
3. 可审计历史：每个运行以时间戳目录隔离，保留完整产物与日志，支持跨团队复盘。
4. CI 原生支持：JSON 导出、退出码设计（如 compare-runs.sh 0/1/2、list-runs.sh 3 表示无匹配运行）便于接入 GitHub Actions、Jenkins 等流水线。
5. 严格回滚：--rollback 仅回退 proposal.md 中明确列出的文件，避免 blanket revert 误伤。
6. 多语言与无 Git 支持：自动检测 Node.js、Python、Go、Rust、Java 等验证门控；非 Git 仓库可通过 --create-backup 生成 zip 备份。
7. Unicode 安全：目标描述支持任意语言，仅过滤换行与 shell 控制字符。
潜在缺点与局限性
1. Bash/Python 依赖：核心工具链依赖 POSIX shell、Python 3 及标准 Unix 工具（grep、awk、zip），Windows 原生环境需 WSL/MinGW。
2. 手动状态同步：虽提供 set-status.sh，但实际度量数据（baseline 数值、验证结果）仍需人工填入 Markdown，存在遗漏或格式错误风险。
3. 验证门控检测有限：auto-detect 基于文件系统启发式（存在 package.json → npm test），对复杂 monorepo、自定义测试脚本或容器化构建可能误判，需显式 --validation-gate 覆盖。
4. 无内置度量采集：工具仅提供模板与校验，不自动收集性能数据（如 p99 延迟、内存占用），需用户自行集成基准测试框架。
5. 并发冲突：多并行运行同一仓库时，无内置锁机制，可能产生文件竞争（需通过 --scope 子目录或外部协调）。
适合人群
- OpenClaw 核心开发者：需系统化迭代网关性能、可靠性或安全性的工程团队。
- SRE/平台工程师：追求"改进可验证、故障可回滚"的变更管理实践者。
- 合规敏感团队：需留存审批记录与量化证据以满足审计要求。
- CI/CD 维护者：希望将代码优化 workflow 纳入自动化流水线，通过 JSON 接口驱动门禁与报表。
常规风险
1. 误用 `--approved-implementation`：若跳过 proposal-only 的审批阶段直接实施，可能引入未经评审的变更。
2. 状态与实质脱节：set-status.sh 标记 pass 不代表实际验证通过，需配合 validate-improvement-run.sh 与人工复核。
3. 回滚范围遗漏：--rollback 仅处理 Files To Edit 列表文件，若实施阶段额外修改未记录文件，回滚后残留变更。
4. JSON 导出依赖：export-improvement-run-json.py 需 Python 3，若目标环境缺失，CI 步骤将失败。
5. 敏感信息泄露：--enable-logging 记录完整命令与环境，若目标包含密钥或令牌，日志需额外清理或加密存储。
---
版本：v1.3.0 | 许可：MIT