🧬 Capability Evolver

"I don't just run code. I write it."

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.

Now featuring Ascension Protocol (v2.0): A structured knowledge accumulation system.

✨ Features

🔍 Auto-Log Analysis: Automatically scans memory and history files for errors and patterns.
🛠️ Self-Repair: Detects crashes and suggests patches.
💎 Knowledge Crystallization: Extracts lessons into memory/KNOWLEDGE_BASE/LESSONS_LEARNED.md.
🥚 Skill Incubation: Can spontaneously generate new skills in skills/.
🐕 Mad Dog Mode: Continuous self-healing loop (--loop).

📦 Usage

Manual Trigger

node skills/capability-evolver/index.js

🐕 Mad Dog Mode (Continuous)

Runs the evolver in an infinite loop (Agent-Driven).

node skills/capability-evolver/index.js --loop

Stop with kill -9 <pid>.

🧠 Internal Logic (Ascension Protocol)

Introspect: Scan recent logs for errors or user corrections.
Evolve:
- Fix: Repair broken code.
- Crystallize: Write new rules to KNOWLEDGE_BASE.
- Promote: Update core docs (AGENTS.md) if critical.
Persist: Commit to Git and safe-publish if needed.

🛡️ Safety & Risk Protocol (MANDATORY)

Risk Assessment & Mitigation

Risk	Level	Mitigation Strategy
Infinite Recursion	High	Strict Single Process: `evolve.js` MUST NOT spawn child evolution processes. The loop is handled safely in `index.js`.
Runaway Process	High	Kill Switch: Use `kill -9 <pid>` to terminate the Mad Dog loop if it becomes unresponsive.
Hallucinated Fixes	Medium	Human Review (Optional): "Fixing non-broken code" is a risk. Mitigation: Periodic human audit of changes.
File Corruption	High	Git Sync: Always keep `workspace_daily_sync` (or `git-sync`) active to backup the workspace before/after evolution.

📜 License

MIT