Evolver - 技能自进化引擎 v3.0.6

Version: 3.0.6 License: GNU General Public License v3.0 (GPL-3.0) Copyright: 2026

Open Source Attribution | 开源许可与归属

1. Inspired by GEP (Genome Evolution Protocol) GEP protocol proposed by EvoMap, this skill uses its concepts and architecture.

2. Independent OpenClaw Implementation Core code (bin/evolve.js) is independently developed for OpenClaw.

⚠️ Security Notes | 安全说明

Memory Directory Scanning This skill scans .md files in the memory/ directory to detect error signals.

Do NOT store sensitive information in memory/ directory, including:

• API keys, tokens, passwords
• Private conversations or personal data
• Financial or health information
• Any credentials or secrets

Protected Files To exclude specific files from scanning, add this line at the top of any .md file:

<!-- evolver-ignore -->

Files starting with # evolver-ignore or containing <!-- evolver-ignore --> will be skipped.

No External Network Calls This skill generates a text-based GEP prompt only. It does NOT make any external API calls, send data to external services, or transmit credentials over the network.

Full license text: see LICENSE.

Quick Start | 快速开始

Install

clawhub install ciri-evolver

Run

# Single evolution scan
node skills/evolver/bin/evolve.js

# Test mode (no file writes)
node skills/evolver/bin/evolve.js --dry-run

Background Daemon

# Start daemon (auto-runs every 4 hours)
node skills/evolver/bin/evolve.js start

# Check status
node skills/evolver/bin/evolve.js status

# Stop
node skills/evolver/bin/evolve.js stop

Core Features | 核心功能

Supported Error Signals | 支持的错误信号

Commands | 命令

Background Running Guide | 后台运行指南

--loop 使用 setInterval 单进程守护，不会调用 shell 或创建子进程， 因此需要用户自行选择以下方式将进程持久化：

方式一：child_process.fork()（独立进程保护）

作用：通过 Node.js fork 创建独立子进程，OpenClaw 崩溃或重启后进程依然存活。

// 创建一个 launcher.js:
const { fork } = require('child_process');
const child = fork('./bin/evolve.js', ['--loop'], {
  detached: true,
  stdio: 'ignore',
});
child.unref();
// 进程在后台独立运行

或直接终端运行：

node -e "const{fork}=require('child_process');const c=fork('./bin/evolve.js',['--loop'],{detached:true,stdio:'ignore'});c.unref();"

方式二：OpenClaw Cron 定时任务

作用：由 OpenClaw 管理定时触发，每次跑完单次扫描就结束， 不占后台进程资源。OpenClaw 关闭时任务自动停止。

在 OpenClaw 面板或 openclaw.json 中配置：

{
  "cron": {
    "evolver": {
      "command": "node /path/to/evolve.js",
      "schedule": "0 */4 * * *",
      "enabled": true,
      "description": "Evolver skill evolution scan every 4 hours"
    }
  }
}

或者在终端直接添加 crontab：

crontab -e
# 添加：0 */4 * * * node /path/to/evolve.js >> /var/log/evolver.log 2>&1

# 查看日志
tail -f /var/log/evolver.log

两种方式对比

Strategies | 策略

File Structure | 文件结构

skills/evolver/
├── SKILL.md              # This file
├── LICENSE              # GPL-3.0 license
├── bin/
│   └── evolve.js        # Core script
└── assets/
    ├── GENES.md         # Gene library (editable)
    ├── CAPSULES.md      # Validated fixes
    └── EVOLUTION_EVENTS.md  # Evolution logs

Example Output | 示例输出

Evolver - Skill Self-Evolution Engine v3.0.6

   Strategy: balanced
   Mode: SINGLE

Signals detected: ModelFallback
Genes: 5 total, 1 matched

================================================================================
           GEP Evolution Prompt
================================================================================

> Evolution ID: EVT-YYYYMMDD-XXXX
> Strategy: balanced (innovate:0.5 optimize:0.3 repair:0.2)

## Detected Signals
  - ModelFallback

## Matched Genes
  ### [20260416-004] repair
  Signals: ModelFallback
  Strategy:
    Fix model routing issues...

## Suggested Actions
  1. [repair] Fix model routing + log fallback chain

## Evolution Event Record
{ "type": "EvolutionEvent", ... }

Evolution event recorded.

Troubleshooting | 故障排除

Q: "No such file or directory"?
A: Run from correct workspace directory or use absolute path.

Q: Background process gone?
A: Check with evolve.js status, restart with evolve.js check.

Q: No signals detected?
A: Check memory/ directory for logs containing error keywords.

Q: No gene match?
A: Edit assets/GENES.md to add new gene templates.

Architecture | 架构说明

Daemon Loop Mode

--loop uses Node.js setInterval in a single process — no child_process.spawn, no exec, no fork. This avoids T1140 (Inline Python code execution) and shell command execution false positives.

Use child_process.fork or OpenClaw cron to persist the process externally.

Process Lifecycle

node evolve.js --loop     → foreground daemon (setInterval, blocks terminal)
node evolve.js start      → foreground daemon (user backgrounds with fork/cron)
node evolve.js stop       → SIGTERM graceful shutdown (via PID file)
node evolve.js check      → health check + restart if stagnant (>8h no run)

Changelog | 版本历史

• v3.0.6: Added <!-- evolver-ignore --> file protection. Added Security Notes section in SKILL.md. GENES.md rewritten to remove external API references (pure code-level fixes only).
• v3.0.4: Reset CAPSULES.md to empty. Cleared Evolution ID in Example Output.
• v3.0.3: Removed runtime data from published package (evolver-state.json, evolver.pid, EVOLUTION_EVENTS.md). Reset to clean initial state.
• v3.0.2: Replaced child_process.spawn daemon with setInterval + nohup. Eliminates T1140 sandbox false positive. --loop is now single-process. Fixed nohup PID capture bug.
• v3.0.1: Fixed header comments, usage docs, version string (v2.0 -> v3.0)
• v3.0.0: Removed fetchSkill and autoIssue functions. Cleaner, safer, no exec/fetch.
• v2.0.3: Code optimizations (regex pre-compilation, path traversal protection)
• v2.0.0: Full feature set (Loop, Review, Lifecycle)
• v1.0.0: Initial release (Signal Detection + Gene Matching)