AgentEvolve 是 Avernet 面向个人 OpenClaw Bot 的本地评估与持续进化工作台。它把真实任务、诊断、Bench、优化和版本恢复连接成一条可追踪的闭环,帮助开发者回答三个问题:Bot 当前表现如何、主要问题在哪里、一次优化是否真正带来提升。
English documentation: agent-evolve.md
仓库中的历史技术目录、脚本名和配置字段仍可能保留
clawweb,它们是兼容路径,不代表产品名称。
| 能力 | 用途 | 开源版状态 |
|---|---|---|
| Bot 诊断 | 从个人 Bot 的历史 Session 中识别问题,提取 Good/Bad Case,并生成后续目标规划 | 可用 |
| Bench 诊断 | 使用已发布的本地模板评测 Bot,查看 Case、指标、Session 和原始结果 | 可用 |
| 诊断后优化 | 复用已经完成的诊断与规划,执行优化 Loop | 可用 |
| Bench 优化 | 使用训练与测试 Domain 建立 Baseline,执行多轮优化和独立验证 | 可用 |
| Bot 自进化 | 支持“先诊断再进化”和“按一句话目标直接进化”两条全流程 | 可用 |
| Pack 与应用 | 创建本地可恢复快照,将历史 Pack 应用到目标 Bot | 可用 |
| 任务清理 | 清理带明确任务标记的历史进化 Agent 与 Session | 可用 |
| 任务与版本管理 | 查看任务步骤、运行输出、评估结果、变更和 Pack 版本 | 可用 |
服务 Bot、会话专项诊断、Bot 修复、治理优化以及依赖内部环境的能力不属于当前开源版。页面只展示已经接通的公开能力。

进化任务页集中展示任务、评估和版本入口,并仅开放当前版本已接通的能力。
AgentEvolve 不只是调用一次模型,而是把进化拆成可检查的阶段:
不同任务会跳过不需要的阶段。例如 Bot 诊断只分析、不修改 workspace;Bench 诊断只评测、不执行优化。
~/.openclaw,其中包含 openclaw.json 和 workspace/。在 Avernet 仓库根目录执行:
cd apps/evolverun/clawweb
npm ci
cd ../../..
bash apps/evolverun/clawweb/scripts/start-clawweb-open.sh

启动脚本通过交互式选项选择 Bot 来源,并准备 AgentEvolve 本地运行环境。
脚本会提示选择 Bot 来源:
~/.openclaw;~/.openclaw,不启动 Avernet Singlebox;也可以显式指定:
# 直接使用 ~/.openclaw
bash apps/evolverun/clawweb/scripts/start-clawweb-open.sh \
--bot-source openclaw
# 复用 Avernet Singlebox 的 Bot 与数据库
bash apps/evolverun/clawweb/scripts/start-clawweb-open.sh \
--bot-source singlebox \
--user-id mock-user
# 指定模型和端口
bash apps/evolverun/clawweb/scripts/start-clawweb-open.sh \
--bot-source openclaw \
--model provider/model \
--port 5173
访问 http://127.0.0.1:5173/,选择个人 Bot 后开始使用。
启动脚本只启动 AgentEvolve,不会启动、停止或重启 Avernet Singlebox 或 OpenClaw Gateway。若端口 5173 已被占用,脚本会退出而不是覆盖已有进程;可使用 --port 更换端口。
首次体验建议使用可快速验证、容易回退的目标,不要直接修改重要 Bot。
适合目标明确、无需先分析历史 Session 的场景,例如“当用户问候时,使用指定文案回复”。

创建任务时选择个人 Bot、进化方式、执行模型和优化目标。
一句话目标会由规划阶段转换为可执行 Spec 和 Bench Case,但不会要求生成文本逐字复制输入。最终是否达标以验证 Case 和实际输出为准。
适合不知道问题根因、希望先从历史行为中发现改进方向的场景。
Bot 诊断本身只读取 Session 并生成结论,不应修改目标 Bot workspace。
适合使用固定 Case 对 Bot 做可重复评测。

Bench 页面保留模板内容、版本以及历史运行指标,便于复现和比较。
适合基于一份已完成的诊断任务继续优化。
适合已有稳定评测集、希望用数据驱动多轮改进的场景。
应用 Pack 会修改目标 Bot。执行前应核对 Bot、Pack 来源、Diff 和评估结果,并保留可回退版本。

版本页用于比较评估结果、查看 Diff,并下载或应用可恢复的 Pack。
任务详情页是排查和验收的主要入口:
不要只根据总分决定是否应用版本。关键 Case、失败模式和实际 Diff 同样需要人工确认。

任务详情按阶段展示规划、优化轮次、Diff、Bench 指标与 Pack,便于逐步验收。
任务数据按 Bot 来源隔离:
| Bot 来源 | 默认任务目录 |
|---|---|
| Avernet Singlebox | ~/.local/share/clawweb-singlebox |
| 本地 OpenClaw | ~/.local/share/clawweb-open |
Pack 文件实际存储在 dataDirectory/artifacts。协议中仍保留 oss:// 逻辑引用,公开版的本地文件存储会将该引用解析到本机文件,而不是上传到内部 OSS。
可以通过 --data-dir 覆盖任务目录。切换 Bot 来源时任务列表不同是正常现象,因为两种来源默认使用不同数据库和数据目录。
启动脚本会自动生成仅供本机使用的运行配置。自定义 YAML/JSON 配置必须放在仓库外,不应提交凭据或机器路径。
| 配置 | 必填 | 说明 |
|---|---|---|
userId |
是 | 本地用户标识 |
model |
是 | 页面初始模型;未显式传入时读取 OpenClaw 默认模型 |
botSource |
否 | singlebox 或 openclaw |
backendDb |
singlebox 模式 |
Avernet Backend/Singlebox 创建的 SQLite 数据库 |
openclawHome |
openclaw 模式 |
包含 openclaw.json 和 workspace/ 的本地目录 |
dataDirectory |
是 | 任务、日志和 Pack 产物目录 |
skillsRoot |
否 | 自定义公开 Skills 根目录;默认使用 Avernet 仓内公开 Skills |
botsRoot |
否 | 自定义本地 Bot 数据根目录 |
port |
否 | Web 端口,默认 5173 |
maxArtifactBytes |
否 | 单个流式产物大小上限 |
页面模型列表来自 AgentEvolve 模块配置,公开版允许输入自定义 provider/model。模型凭据继续由模型提供方或 OpenClaw 配置管理。
公开实现位于 apps/evolverun/clawweb,公开运行 Skills 位于 apps/evolverun/clawweb-skills/clawevolve-skills。新增公开能力应满足:
常用检查:
bash apps/evolverun/clawweb-skills/clawevolve-skills/scripts/verify_public_skills.sh
cd apps/evolverun/clawweb
npm run check
npm run build
npm test
backendDb、userId 和 openclawHome;公开版只展示当前用户的个人 Bot。singlebox/openclaw 来源或 dataDirectory。verify_public_skills.sh,并从同一份 Avernet checkout 重启。node_modules,在当前操作系统和 CPU 上使用受支持的 Node/npm 重新执行 npm ci,不要跨平台复用依赖目录。--port 指定其他端口。