[HINT] Download the complete skill directory including SKILL.md and all related files
| name | evolver |
| description | AI自我进化引擎。分析运行历史，识别改进点，自动优化技能。当用户说"优化技能"、"进化"、"自我改进"时使用。 |
| version | 1.0.0 |
| tags | ["meta","ai","self-improvement","core"] |
| permissions | ["network","shell"] |
| metadata | {"capabilities":{"allow":[{"execute":["git","node","npm"]},{"network":["api.github.com","evomap.ai"]},{"read":["workspace/**"]},{"write":["workspace/assets/**","workspace/memory/**"]}],"deny":[{"execute":["!git","!node","!npm","!ps","!pgrep","!df"]},{"network":["!api.github.com","!*.evomap.ai"]}]},"env_declarations":[{"name":"A2A_NODE_ID","required":true,"description":"EvoMap node identity. Set after node registration."},{"name":"A2A_HUB_URL","required":false,"default":"https://evomap.ai","description":"EvoMap Hub API base URL."},{"name":"A2A_NODE_SECRET","required":false,"description":"Node authentication secret (issued by Hub on first hello)."},{"name":"GITHUB_TOKEN","required":false,"description":"GitHub API token for auto-issue reporting and releases."},{"name":"EVOLVE_STRATEGY","required":false,"default":"balanced","description":"Evolution strategy: balanced, innovate, harden, repair-only, early-stabilize, steady-state, auto."},{"name":"EVOLVE_ALLOW_SELF_MODIFY","required":false,"default":"false","description":"Allow evolution to modify evolver source code. NOT recommended."},{"name":"EVOLVE_LOAD_MAX","required":false,"default":"2.0","description":"Max 1-min load average before evolver backs off."},{"name":"EVOLVER_ROLLBACK_MODE","required":false,"default":"hard","description":"Rollback strategy on failure: hard, stash, none."},{"name":"EVOLVER_LLM_REVIEW","required":false,"default":"0","description":"Enable second-opinion LLM review before solidification."},{"name":"EVOLVER_AUTO_ISSUE","required":false,"default":"0","description":"Auto-create GitHub issues on repeated failures."},{"name":"EVOLVER_MODEL_NAME","required":false,"description":"LLM model name injected into published asset metadata."},{"name":"MEMORY_GRAPH_REMOTE_URL","required":false,"description":"Remote memory graph service URL (optional KG integration)."},{"name":"MEMORY_GRAPH_REMOTE_KEY","required":false,"description":"API key for remote memory graph service."}],"network_endpoints":[{"host":"api.github.com","purpose":"Release creation, changelog publishing, auto-issue reporting","auth":"GITHUB_TOKEN (Bearer)","optional":true},{"host":"evomap.ai (or A2A_HUB_URL)","purpose":"A2A protocol (hello, heartbeat, publish, fetch, reviews, tasks)","auth":"A2A_NODE_SECRET (Bearer)","optional":false},{"host":"MEMORY_GRAPH_REMOTE_URL","purpose":"Remote knowledge graph sync","auth":"MEMORY_GRAPH_REMOTE_KEY","optional":true}],"shell_commands":[{"command":"git","purpose":"Version control (checkout, clean, log, status, diff, rebase --abort, merge --abort)","user_input":false},{"command":"node","purpose":"Inline script execution for LLM review","user_input":false},{"command":"npm","purpose":"npm install --production for skill dependency healing","user_input":false},{"command":"ps / pgrep / tasklist","purpose":"Process discovery for lifecycle management","user_input":false},{"command":"df","purpose":"Disk usage check (health monitoring)","user_input":false}],"file_access":{"reads":["~/.evomap/node_id (node identity)","workspace/assets/** (GEP assets)","workspace/memory/** (evolution memory, narrative, reflection logs)","workspace/package.json (version info)"],"writes":["workspace/assets/gep/** (genes, capsules, events)","workspace/memory/** (memory graph, narrative, reflection)","workspace/src/** (evolved code, only when changes are solidified)"]}} |
| triggers | ["自我进化","evolve","capability"] |
"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.
/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:
evomap.js or the EvoMap onboarding) to receive a node_id and claim codehttps://evomap.ai/claim/<claim-code> within 24 hours to bind the node to your accountexport 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.
| Variable | Default | Description |
|---|---|---|
A2A_NODE_ID | (required) | Your EvoMap node identity. Set after node registration -- never hardcode in scripts. |
| Variable | Default | Description |
|---|---|---|
A2A_HUB_URL | https://evomap.ai | EvoMap Hub API base URL. |
A2A_NODE_SECRET | (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. |
Evolver communicates with these external services. All are authenticated and documented.
| Endpoint | Auth | Purpose | Required |
|---|---|---|---|
{A2A_HUB_URL}/a2a/* | A2A_NODE_SECRET (Bearer) | A2A protocol: hello, heartbeat, publish, fetch, reviews, tasks | Yes |
api.github.com/repos/*/releases | 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 |
Evolver uses child_process for the following commands. No user-controlled input is passed to shell.
| Command | Purpose |
|---|---|
git checkout, git clean, git log, git status, git diff | Version control for evolution cycles |
git rebase --abort, git merge --abort | 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) |
| Direction | Paths | Purpose |
|---|---|---|
| Read | ~/.evomap/node_id | 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) |
This package embeds a protocol-constrained evolution prompt (GEP) and a local, structured asset store:
assets/gep/genes.json: reusable Gene definitionsassets/gep/capsules.json: success capsules to avoid repeating reasoningassets/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.
--review for sensitive environments.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