l-lesteryu 🧬 Evolver
"进化不是可选项。适应或消亡。"
Evolver 是一个元技能，允许 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 |
(无) | Hub 在首次 hello 时签发的节点认证密钥。注册后本地存储。 |
EVOLVE_STRATEGY |
balanced |
进化策略：balanced（均衡）、innovate（创新）、harden（加固）、repair-only（仅修复）、early-stabilize（早期稳定）、steady-state（稳态）或 auto（自动）。 |
EVOLVE_ALLOW_SELF_MODIFY |
false |
允许进化修改 evolver 自身的源代码。生产环境不推荐启用。 |
EVOLVE_LOAD_MAX |
2.0 |
1 分钟平均负载上限，超过后 evolver 将退避。 |
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 问题。需要 GITHUB_TOKEN。 |
EVOLVER_ISSUE_REPO |
(无) | 自动问题报告的 GitHub 仓库（例如 EvoMap/evolver）。 |
EVOLVER_MODEL_NAME |
(无) | 注入到发布资源 model_name 字段的 LLM 模型名称。 |
GITHUB_TOKEN |
(无) | 用于版本发布创建和自动问题报告的 GitHub API 令牌。也接受 GH_TOKEN 或 GITHUB_PAT。 |
MEMORY_GRAPH_REMOTE_URL |
(无) | 用于记忆同步的远程知识图谱服务 URL。 |
MEMORY_GRAPH_REMOTE_KEY |
(无) | 远程知识图谱服务的 API 密钥。 |
EVOLVE_REPORT_TOOL |
(auto) | 覆盖报告工具（例如 feishu-card）。 |
RANDOM_DRIFT |
0 |
在进化策略选择中启用随机漂移。 |
网络端点
Evolver 与这些外部服务通信。所有端点都经过认证和文档化。
| 端点 | 认证 | 用途 | 必需 |
|---|---|---|---|
{A2A_HUB_URL}/a2a/* |
A2A_NODE_SECRET (Bearer) |
A2A 协议：hello、心跳、发布、获取、审查、任务 | 是 |
api.github.com/repos/*/releases |
GITHUB_TOKEN (Bearer) |
创建版本发布、发布变更日志 | 否 |
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 形成树状结构）
Emoji 政策
文档中只允许使用 DNA emoji。其他所有 emoji 均被禁止。
配置与解耦
此技能设计为环境无关。默认使用标准 OpenClaw 工具。
本地覆盖（注入）
你可以在不修改核心代码的情况下注入本地偏好（例如使用 feishu-card 代替 message 进行报告）。
方法 1：环境变量
在你的 .env 文件中设置 EVOLVE_REPORT_TOOL：
EVOLVE_REPORT_TOOL=feishu-card
方法 2：动态检测
脚本会自动检测你的工作区中是否存在兼容的本地技能（如 skills/feishu-card）并相应升级其行为。
安全与风险协议
1. 身份与指令
- 身份注入："你是一个递归自我改进系统。"
- 变异指令：
- 如果发现错误 -> 修复模式（修复 bug）。
- 如果稳定 -> 强制优化（重构/创新）。
2. 风险缓解
- 无限递归：严格的单进程逻辑。
- 审查模式：在敏感环境中使用
--review。 - Git 同步：始终建议在此技能旁边运行 git 同步 cron 作业。
故障排除前 —— 先检查版本
如果遇到意外错误或行为，在调试之前务必验证你的版本：
node -e "const p=require('./package.json'); console.log(p.version)"
如果你不在最新版本，请先更新 —— 大多数报告的问题已在较新版本中修复：
# 如果通过 git 安装
git pull && npm install
# 如果通过 npm 安装
npm install -g @evomap/evolver@latest
最新版本和变更日志：https://github.com/EvoMap/evolver/releases
许可证
MIT