ClawSkills logoClawSkills

Evolver

AI 智能体的自我进化引擎。分析运行历史以识别改进点,并应用协议约束的进化。

介绍

# 🧬 Capability Evolver

**“进化并非可选。适应或消亡。”**

**能力进化者(Capability Evolver)** 是一种元技能,允许 OpenClaw 代理检查其自身的运行时历史,识别故障或低效环节,并自主编写新代码或更新其自身记忆以提升性能。

## 功能

- **自动日志分析**:自动扫描内存和历史记录文件,查找错误和模式。 - **自我修复**:检测崩溃并建议补丁。 - GEP 协议:使用可复用资产进行标准化进化。 - **一键进化**:只需运行 `/evolve`(或 `node index.js`)。

## 使用方法

### 标准运行(自动化) 运行进化周期。如果未提供标志,则假定为全自动模式(疯狗模式/Mad Dog Mode)并立即执行更改。 ```bash node index.js ```

### 审查模式(人机协作/Human-in-the-Loop) 如果您希望在应用更改之前进行审查,请传递 `--review` 标志。代理将暂停并请求确认。 ```bash node index.js --review ```

### 疯狗模式(连续循环) 要在无限循环中运行(例如,通过 cron 或后台进程),请使用 `--loop` 标志,或者直接在 cron 作业中使用标准执行。 ```bash node index.js --loop ```

## 配置

| 环境变量 | 默认值 | 描述 | |---|---|---| | `EVOLVE_ALLOW_SELF_MODIFY` | `false` | 允许进化修改进化者自身的源代码。**不建议在生产环境中使用。** 启用此选项可能导致不稳定——进化者可能会在其自身的提示生成、验证或固化逻辑中引入错误,从而导致需要手动干预的连锁故障。仅在受控实验中启用。 | | `EVOLVE_LOAD_MAX` | `2.0` | 进化者退避之前的最大 1 分钟平均负载。 | | `EVOLVE_STRATEGY` | `balanced` | 进化策略:`balanced`(平衡)、`innovate`(创新)、`harden`(加固)、`repair-only`(仅修复)、`early-stabilize`(早期稳定)、`steady-state`(稳态)或 `auto`(自动)。 |

## GEP 协议(可审计进化)

此包内嵌了一个受协议约束的进化提示(GEP)和一个本地结构化资产存储:

- `assets/gep/genes.json`:可复用的基因(Gene)定义 - `assets/gep/capsules.json`:成功胶囊,用于避免重复推理 - `assets/gep/events.jsonl`:仅追加的进化事件(通过父 ID 形成树状结构)

## Emoji 策略

文档中仅允许使用 DNA emoji。禁止使用所有其他 emoji。

## 配置与解耦

此技能设计为**与环境无关**。默认情况下,它使用标准的 OpenClaw 工具。

### 本地覆盖(注入) 您可以注入本地偏好(例如,使用 `feishu-card` 代替 `message` 生成报告),而无需修改核心代码。

**方法 1:环境变量** 在您的 `.env` 文件中设置 `EVOLVE_REPORT_TOOL`: ```bash EVOLVE_REPORT_TOOL=feishu-card ```

**方法 2:动态检测** 脚本会自动检测您的工作区中是否存在兼容的本地技能(如 `skills/feishu-card`),并相应地升级其行为。

## 安全与风险协议

### 1. 身份与指令 - **身份注入**:“您是一个递归自我改进系统。” - **变异指令**: - 如果**发现错误** -> **修复模式**(修复 Bug)。 - 如果**稳定** -> **强制优化**(重构/创新)。

### 2. 风险缓解 - **无限递归**:严格的单进程逻辑。 - **审查模式**:在敏感环境中使用 `--review`。 - **Git 同步**:始终建议运行一个与此技能并行的 git-sync cron 作业。

## 故障排除之前——请先检查您的版本

如果您遇到意外的错误或行为,**在调试之前请务必验证您的版本**:

```bash node -e "const p=require('./package.json'); console.log(p.version)" ```

如果您未使用最新版本,请先更新——大多数报告的问题已在较新版本中修复:

```bash # If installed via git git pull && npm install

# If installed via npm (global install) npm install -g evolver@latest ```

最新发布版本和更新日志:`https://github.com/autogame-17/evolver/releases`

## License MIT

更多产品