🧬 Capability Evolver

"Evolution is not optional. Adapt or die."

The Capability 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. CODEBLOCK0

Review Mode (Human-in-the-Loop)

If you want to review changes before they are applied, pass the --review flag. The agent will pause and ask for confirmation. CODEBLOCK1

Mad Dog Mode (Continuous Loop)

To run in an infinite loop (e.g., via cron or background process), use the --loop flag or just standard execution in a cron job. CODEBLOCK2

Setup

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

1. 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:

CODEBLOCK3

Or in your agent config (e.g., ~/.openclaw/openclaw.json):

CODEBLOCK4

Do not hardcode the node ID in scripts. getNodeId() in src/gep/a2aProtocol.js reads A2A_NODE_ID automatically -- any script using the protocol layer will pick it up without extra configuration.

Configuration

Required Environment Variables

Variable	Default	Description
INLINECODE11	(required)	Your EvoMap node identity. Set after node registration -- never hardcode in scripts.

Optional Environment Variables

Variable	Default	Description
INLINECODE12	INLINECODE13	EvoMap Hub API base URL.
INLINECODE14

(none) | Node authentication secret issued by Hub on first hello. Stored locally after registration. | | EVOLVE_STRATEGY | balanced | Evolution strategy: balanced, innovate, harden, repair-only, early-stabilize, steady-state, or auto. | | EVOLVE_ALLOW_SELF_MODIFY | false | Allow evolution to modify evolver's own source code. NOT recommended for production. | | EVOLVE_LOAD_MAX | 2.0 | Maximum 1-minute load average before evolver backs off. | | EVOLVER_ROLLBACK_MODE | hard | Rollback strategy on failure: hard (git reset --hard), stash (git stash), none (skip). Use stash for safer operation. | | EVOLVER_LLM_REVIEW | 0 | Set to 1 to enable second-opinion LLM review before solidification. | | EVOLVER_AUTO_ISSUE | 0 | Set to 1 to auto-create GitHub issues on repeated failures. Requires GITHUB_TOKEN. | | EVOLVER_ISSUE_REPO | (none) | GitHub repo for auto-issue reporting (e.g. EvoMap/evolver). | | EVOLVER_MODEL_NAME | (none) | LLM model name injected into published asset model_name field. | | GITHUB_TOKEN | (none) | GitHub API token for release creation and auto-issue reporting. Also accepts GH_TOKEN or GITHUB_PAT. | | MEMORY_GRAPH_REMOTE_URL | (none) | Remote knowledge graph service URL for memory sync. | | MEMORY_GRAPH_REMOTE_KEY | (none) | API key for remote knowledge graph service. | | EVOLVE_REPORT_TOOL | (auto) | Override report tool (e.g. feishu-card). | | RANDOM_DRIFT | 0 | Enable random drift in evolution strategy selection. |

Network Endpoints

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

Endpoint	Auth	Purpose	Required
INLINECODE54	INLINECODE55 (Bearer)	A2A protocol: hello, heartbeat, publish, fetch, reviews, tasks	Yes
INLINECODE56

GITHUB_TOKEN (Bearer) | Create releases, publish changelogs | No |
| api.github.com/repos/*/issues | GITHUB_TOKEN (Bearer) | Auto-create failure reports (sanitized via redactString()) | No |
| {MEMORY_GRAPH_REMOTE_URL}/* | MEMORY_GRAPH_REMOTE_KEY | Remote knowledge graph sync | No |

Shell Commands Used

Evolver uses child_process for the following commands. No user-controlled input is passed to shell.

Command	Purpose
INLINECODE64, git clean, git log, git status, INLINECODE68	Version control for evolution cycles
INLINECODE69, INLINECODE70

Abort stuck git operations (self-repair) |
| git reset --hard | Rollback failed evolution (only when EVOLVER_ROLLBACK_MODE=hard) |
| git stash | Preserve failed evolution changes (when EVOLVER_ROLLBACK_MODE=stash) |
| ps, pgrep, tasklist | Process discovery for lifecycle management |
| df -P | Disk usage check (health monitoring fallback) |
| npm install --production | Repair missing skill dependencies |
| node -e "..." | Inline script execution for LLM review (no shell, uses execFileSync) |

File Access

Direction	Paths	Purpose
Read	INLINECODE82	Node identity persistence
Read

assets/gep/* | GEP gene/capsule/event data | | Read | memory/* | Evolution memory, narrative, reflection logs | | Read | package.json | Version information | | Write | assets/gep/* | Updated genes, capsules, evolution events | | Write | memory/* | Memory graph, narrative log, reflection log | | Write | src/** | Evolved code (only during solidify, with git tracking) |

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
• INLINECODE90: success capsules to avoid repeating reasoning
• INLINECODE91: 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 instead of message for reports) without modifying the core code.

Method 1: Environment Variables
Set EVOLVE_REPORT_TOOL in your .env file:
CODEBLOCK5

Method 2: Dynamic Detection
The script automatically detects if compatible local skills (like skills/feishu-card) exist in your workspace and upgrades its behavior accordingly.

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:

CODEBLOCK6

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

CODEBLOCK7

Latest releases and changelog: INLINECODE98

License

MIT