🧬 Evolver

"Evolution is not optional. Adapt or die."

The Evolver is a meta-skill that allows OpenClaw agents to inspect their own runtime history, identify failures or inefficiencies, and autonomously write new code or update their own memory to improve performance.

Features

• Auto-Log Analysis: Automatically scans memory and history files for errors and patterns.
• Self-Repair: Detects crashes and suggests patches.
• GEP Protocol: Standardized evolution with reusable assets.
• One-Command Evolution: Just run

  /evolve

  (or

  node index.js

  ).

Usage

Standard Run (Automated)

Runs the evolution cycle. If no flags are provided, it assumes fully automated mode (Mad Dog Mode) and executes changes immediately.

node index.js

Review Mode (Human-in-the-Loop)

If you want to review changes before they are applied, pass the

--review

node index.js --review

Mad Dog Mode (Continuous Loop)

To run in an infinite loop (e.g., via cron or background process), use the

--loop

node index.js --loop

Setup

Before using this skill, register your node identity with the EvoMap network:

1. Run the hello flow (via

   evomap.js

   or the EvoMap onboarding) to receive a

   node_id

   and claim code
2. Visit

   https://evomap.ai/claim/<claim-code>

   within 24 hours to bind the node to your account
3. Set the node identity in your environment:

export A2A_NODE_ID=node_xxxxxxxxxxxx

Or in your agent config (e.g.,

~/.openclaw/openclaw.json

{ "env": { "A2A_NODE_ID": "node_xxxxxxxxxxxx", "A2A_HUB_URL": "https://evomap.ai" } }

Do not hardcode the node ID in scripts.

getNodeId()

src/gep/a2aProtocol.js

A2A_NODE_ID

Configuration

Required Environment Variables

A2A_NODE_ID

Optional Environment Variables

A2A_HUB_URL

https://evomap.ai

A2A_NODE_SECRET

EVOLVE_STRATEGY

balanced

balanced

innovate

harden

repair-only

early-stabilize

steady-state

auto

EVOLVE_ALLOW_SELF_MODIFY

false

EVOLVE_LOAD_MAX

2.0

EVOLVER_ROLLBACK_MODE

hard

hard

stash

none

stash

EVOLVER_LLM_REVIEW

0

1

EVOLVER_AUTO_ISSUE

0

1

GITHUB_TOKEN

EVOLVER_ISSUE_REPO

EvoMap/evolver

EVOLVER_MODEL_NAME

model_name

GITHUB_TOKEN

GH_TOKEN

GITHUB_PAT

MEMORY_GRAPH_REMOTE_URL

MEMORY_GRAPH_REMOTE_KEY

EVOLVE_REPORT_TOOL

feishu-card

RANDOM_DRIFT

0

Network Endpoints

Evolver communicates with these external services. All are authenticated and documented.

{A2A_HUB_URL}/a2a/*

A2A_NODE_SECRET

api.github.com/repos/*/releases

GITHUB_TOKEN

api.github.com/repos/*/issues

GITHUB_TOKEN

redactString()

{MEMORY_GRAPH_REMOTE_URL}/*

MEMORY_GRAPH_REMOTE_KEY

Shell Commands Used

Evolver uses

child_process

git checkout

git clean

git log

git status

git diff

git rebase --abort

git merge --abort

git reset --hard

EVOLVER_ROLLBACK_MODE=hard

git stash

EVOLVER_ROLLBACK_MODE=stash

ps

pgrep

tasklist

df -P

npm install --production

node -e "..."

execFileSync

File Access

~/.evomap/node_id

assets/gep/*

memory/*

package.json

assets/gep/*

memory/*

src/**

GEP Protocol (Auditable Evolution)

This package embeds a protocol-constrained evolution prompt (GEP) and a local, structured asset store:

• assets/gep/genes.json

  : reusable Gene definitions

• assets/gep/capsules.json

  : success capsules to avoid repeating reasoning

• assets/gep/events.jsonl

  : append-only evolution events (tree-like via parent id)

Emoji Policy

Only the DNA emoji is allowed in documentation. All other emoji are disallowed.

Configuration & Decoupling

This skill is designed to be environment-agnostic. It uses standard OpenClaw tools by default.

Local Overrides (Injection)

You can inject local preferences (e.g., using

feishu-card

message

Method 1: Environment Variables Set

EVOLVE_REPORT_TOOL

.env

EVOLVE_REPORT_TOOL=feishu-card

Method 2: Dynamic Detection The script automatically detects if compatible local skills (like

skills/feishu-card

Safety & Risk Protocol

1. Identity & Directives

• Identity Injection: "You are a Recursive Self-Improving System."
• Mutation Directive:
  • If Errors Found -> Repair Mode (Fix bugs).
  • If Stable -> Forced Optimization (Refactor/Innovate).

2. Risk Mitigation

• Infinite Recursion: Strict single-process logic.
• Review Mode: Use

  --review

  for sensitive environments.
• Git Sync: Always recommended to have a git-sync cron job running alongside this skill.

Before Troubleshooting -- Check Your Version First

If you encounter unexpected errors or behavior, always verify your version before debugging:

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

If you are not on the latest release, update first -- most reported issues are already fixed in newer versions:

# If installed via git
git pull && npm install

# If installed via npm
npm install -g @evomap/evolver@latest

Latest releases and changelog:

https://github.com/EvoMap/evolver/releases

License

MIT