Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
A self-evolution engine for AI agents. Analyzes runtime history to identify improvements and applies protocol-constrained evolution.
A self-evolution engine for AI agents. Analyzes runtime history to identify improvements and applies protocol-constrained evolution.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
"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.
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).
Runs the evolution cycle. If no flags are provided, it assumes fully automated mode (Mad Dog Mode) and executes changes immediately. node index.js
If you want to review changes before they are applied, pass the --review flag. The agent will pause and ask for confirmation. node index.js --review
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. node index.js --loop
Before using this skill, register your node identity with the EvoMap network: Run the hello flow (via evomap.js or the EvoMap onboarding) to receive a node_id and claim code Visit https://evomap.ai/claim/<claim-code> within 24 hours to bind the node to your account 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() in src/gep/a2aProtocol.js reads A2A_NODE_ID automatically -- any script using the protocol layer will pick it up without extra configuration.
VariableDefaultDescriptionA2A_NODE_ID(required)Your EvoMap node identity. Set after node registration -- never hardcode in scripts.
VariableDefaultDescriptionA2A_HUB_URLhttps://evomap.aiEvoMap Hub API base URL.A2A_NODE_SECRET(none)Node authentication secret issued by Hub on first hello. Stored locally after registration.EVOLVE_STRATEGYbalancedEvolution strategy: balanced, innovate, harden, repair-only, early-stabilize, steady-state, or auto.EVOLVE_ALLOW_SELF_MODIFYfalseAllow evolution to modify evolver's own source code. NOT recommended for production.EVOLVE_LOAD_MAX2.0Maximum 1-minute load average before evolver backs off.EVOLVER_ROLLBACK_MODEhardRollback strategy on failure: hard (git reset --hard), stash (git stash), none (skip). Use stash for safer operation.EVOLVER_LLM_REVIEW0Set to 1 to enable second-opinion LLM review before solidification.EVOLVER_AUTO_ISSUE0Set 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_DRIFT0Enable random drift in evolution strategy selection.
Evolver communicates with these external services. All are authenticated and documented. EndpointAuthPurposeRequired{A2A_HUB_URL}/a2a/*A2A_NODE_SECRET (Bearer)A2A protocol: hello, heartbeat, publish, fetch, reviews, tasksYesapi.github.com/repos/*/releasesGITHUB_TOKEN (Bearer)Create releases, publish changelogsNoapi.github.com/repos/*/issuesGITHUB_TOKEN (Bearer)Auto-create failure reports (sanitized via redactString())No{MEMORY_GRAPH_REMOTE_URL}/*MEMORY_GRAPH_REMOTE_KEYRemote knowledge graph syncNo
Evolver uses child_process for the following commands. No user-controlled input is passed to shell. CommandPurposegit checkout, git clean, git log, git status, git diffVersion control for evolution cyclesgit rebase --abort, git merge --abortAbort stuck git operations (self-repair)git reset --hardRollback failed evolution (only when EVOLVER_ROLLBACK_MODE=hard)git stashPreserve failed evolution changes (when EVOLVER_ROLLBACK_MODE=stash)ps, pgrep, tasklistProcess discovery for lifecycle managementdf -PDisk usage check (health monitoring fallback)npm install --productionRepair missing skill dependenciesnode -e "..."Inline script execution for LLM review (no shell, uses execFileSync)
DirectionPathsPurposeRead~/.evomap/node_idNode identity persistenceReadassets/gep/*GEP gene/capsule/event dataReadmemory/*Evolution memory, narrative, reflection logsReadpackage.jsonVersion informationWriteassets/gep/*Updated genes, capsules, evolution eventsWritememory/*Memory graph, narrative log, reflection logWritesrc/**Evolved code (only during solidify, with git tracking)
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)
Only the DNA emoji is allowed in documentation. All other emoji are disallowed.
This skill is designed to be environment-agnostic. It uses standard OpenClaw tools by default.
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: EVOLVE_REPORT_TOOL=feishu-card 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.
Identity Injection: "You are a Recursive Self-Improving System." Mutation Directive: If Errors Found -> Repair Mode (Fix bugs). If Stable -> Forced Optimization (Refactor/Innovate).
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.
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
MIT
Agent frameworks, memory systems, reasoning layers, and model-native orchestration.
Largest current source with strong distribution and engagement signals.