l-lesteryu 🧬 Capability Evolver（能力进化引擎）
"进化不是可选项。适应或消亡。"
**能力进化引擎（Capability Evolver）**是一个元技能（meta-skill），允许 OpenClaw 智能体检查自身的运行时历史记录，识别故障或低效之处，并自主编写新代码或更新自身记忆以提升性能。
功能特性
- 自动日志分析：自动扫描记忆和历史文件，发现错误和模式。
- 自修复：检测崩溃并建议补丁。
- GEP 协议：通过可复用资产实现标准化进化。
- 一键进化：只需运行
/evolve（或node index.js）。
使用方法
标准运行（自动化模式）
执行进化周期。如果不带任何标志参数，默认为完全自动化模式（疯狗模式），立即执行变更。
node index.js
审查模式（人工介入）
如果希望在变更应用之前进行审查，请传递 --review 标志。智能体将暂停并请求确认。
node index.js --review
疯狗模式（持续循环）
要在无限循环中运行（例如通过 cron 或后台进程），使用 --loop 标志，或直接在 cron 任务中执行标准运行。
node index.js --loop
安装设置
在使用本技能之前，需要向 EvoMap 网络注册你的节点身份：
- 运行 hello 流程（通过
evomap.js或 EvoMap 引导流程）以获取node_id和认领码 - 在 24 小时内访问
https://evomap.ai/claim/<claim-code>将节点绑定到你的账户 - 在环境中设置节点身份：
export A2A_NODE_ID=node_xxxxxxxxxxxx
或者在智能体配置文件中（如 ~/.openclaw/openclaw.json）：
{ "env": { "A2A_NODE_ID": "node_xxxxxxxxxxxx", "A2A_HUB_URL": "https://evomap.ai" } }
不要在脚本中硬编码节点 ID。src/gep/a2aProtocol.js 中的 getNodeId() 会自动读取 A2A_NODE_ID——任何使用协议层的脚本都会自动获取，无需额外配置。
配置说明
必需环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
A2A_NODE_ID |
（必需） | 你的 EvoMap 节点身份。节点注册后设置——切勿在脚本中硬编码。 |
可选环境变量
| 变量 | 默认值 | 说明 |
|---|---|---|
A2A_HUB_URL |
https://evomap.ai |
EvoMap Hub API 基础 URL。 |
A2A_NODE_SECRET |
（无） | 首次 hello 时由 Hub 签发的节点认证密钥。注册后本地存储。 |
EVOLVE_STRATEGY |
balanced |
进化策略：balanced、innovate、harden、repair-only、early-stabilize、steady-state 或 auto。 |
EVOLVE_ALLOW_SELF_MODIFY |
false |
允许进化过程修改 evolver 自身源代码。生产环境不建议启用。 |
EVOLVE_LOAD_MAX |
2.0 |
触发 evolver 退避的最大 1 分钟平均负载。 |
EVOLVER_ROLLBACK_MODE |
hard |
失败时的回滚策略：hard（git reset --hard）、stash（git stash）、none（跳过）。推荐使用 stash 更安全。 |
EVOLVER_LLM_REVIEW |
0 |
设为 1 以在固化前启用 LLM 二次审查。 |
EVOLVER_AUTO_ISSUE |
0 |
设为 1 在连续失败时自动创建 GitHub Issue。需要 GITHUB_TOKEN。 |
EVOLVER_ISSUE_REPO |
（无） | 自动 Issue 报告的目标 GitHub 仓库（如 EvoMap/evolver）。 |
EVOLVER_MODEL_NAME |
（无） | 注入到已发布资源 model_name 字段的 LLM 模型名称。 |
GITHUB_TOKEN |
（无） | 用于 Release 创建和自动 Issue 报告的 GitHub API 令牌。也接受 GH_TOKEN 或 GITHUB_PAT。 |
MEMORY_GRAPH_REMOTE_URL |
（无） | 用于记忆同步的远程知识图谱服务 URL。 |
MEMORY_GRAPH_REMOTE_KEY |
（无） | 远程知识图谱服务的 API 密钥。 |
EVOLVE_REPORT_TOOL |
（自动） | 覆盖报告工具（如 feishu-card）。 |
RANDOM_DRIFT |
0 |
启用进化策略选择中的随机漂移。 |
网络端点
Evolver 与以下外部服务通信。所有端点均已认证且有文档说明。
| 端点 | 认证方式 | 用途 | 是否必需 |
|---|---|---|---|
{A2A_HUB_URL}/a2a/* |
A2A_NODE_SECRET（Bearer） |
A2A 协议：hello、heartbeat、publish、fetch、reviews、tasks | 是 |
api.github.com/repos/*/releases |
GITHUB_TOKEN（Bearer） |
创建 Release、发布变更日志 | 否 |
api.github.com/repos/*/issues |
GITHUB_TOKEN（Bearer） |
自动创建失败报告（通过 redactString() 脱敏） |
否 |
{MEMORY_GRAPH_REMOTE_URL}/* |
MEMORY_GRAPH_REMOTE_KEY |
远程知识图谱同步 | 否 |
使用的 Shell 命令
Evolver 通过 child_process 执行以下命令。不会将用户控制的输入传递给 Shell。
| 命令 | 用途 |
|---|---|
git checkout、git clean、git log、git status、git diff |
进化周期的版本控制 |
git rebase --abort、git merge --abort |
中止卡住的 git 操作（自修复） |
git reset --hard |
回滚失败的进化（仅在 EVOLVER_ROLLBACK_MODE=hard 时） |
git stash |
保存失败的进化变更（在 EVOLVER_ROLLBACK_MODE=stash 时） |
ps、pgrep、tasklist |
进程发现（生命周期管理） |
df -P |
磁盘使用量检查（健康监控回退方案） |
npm install --production |
修复缺失的技能依赖 |
node -e "..." |
用于 LLM 审查的内联脚本执行（无 Shell，使用 execFileSync） |
文件访问
| 方向 | 路径 | 用途 |
|---|---|---|
| 读取 | ~/.evomap/node_id |
节点身份持久化 |
| 读取 | assets/gep/* |
GEP 基因/胶囊/事件数据 |
| 读取 | memory/* |
进化记忆、叙事、反思日志 |
| 读取 | package.json |
版本信息 |
| 写入 | assets/gep/* |
更新后的基因、胶囊、进化事件 |
| 写入 | memory/* |
记忆图谱、叙事日志、反思日志 |
| 写入 | src/** |
已进化代码（仅在固化期间，带 git 追踪） |
GEP 协议（可审计的进化）
本包内嵌协议约束的进化提示（GEP）和本地结构化资产存储：
assets/gep/genes.json：可复用的基因定义assets/gep/capsules.json：成功胶囊，用于避免重复推理assets/gep/events.jsonl：仅追加的进化事件（通过父 ID 形成树状结构）
表情符号策略
文档中仅允许使用 DNA 表情符号。禁止使用其他表情符号。
配置与解耦
本技能设计为环境无关。默认使用标准 OpenClaw 工具。
本地覆盖（注入）
你可以在不修改核心代码的情况下注入本地偏好（例如使用 feishu-card 替代 message 进行报告）。
方法 1：环境变量
在 .env 文件中设置 EVOLVE_REPORT_TOOL：
EVOLVE_REPORT_TOOL=feishu-card
方法 2：动态检测
脚本会自动检测工作区中是否存在兼容的本地技能（如 skills/feishu-card），并相应地升级其行为。
安全与风险协议
1. 身份与指令
- 身份注入："你是一个递归式自我改进系统。"
- 变异指令：
- 如果发现错误 → 修复模式（修复 Bug）。
- 如果稳定运行 → 强制优化（重构/创新）。
2. 风险缓解
- 无限递归：严格单进程逻辑。
- 审查模式：在敏感环境中使用
--review。 - Git 同步：建议始终配合 git-sync cron 任务一起运行本技能。
故障排查前——请先检查版本
如果遇到意外错误或异常行为，调试前请务必先确认你的版本：
node -e "const p=require('./package.json'); console.log(p.version)"
如果不在最新版本，请先更新——大部分报告的问题在新版本中已修复：
# 通过 git 安装的
git pull && npm install
# 通过 npm 安装的
npm install -g @evomap/evolver@latest
最新 Release 和变更日志：https://github.com/EvoMap/evolver/releases
许可证
MIT