Self-Improve Framework#

A pluggable self-improvement framework for AI agents. Automatically learns from mistakes, corrections, and feedback to continuously improve execution quality.

Description#

Self-Improve enables your agent team to evolve over time:

• Scans agent memory logs for learning signals
• Extracts reusable experience rules
• Proposes improvements to system files (with approval workflow)
• Maintains a 3-tier memory system (HOT/WARM/COLD)

When to Use#

• Automatic (Cron): Runs every 3 days by default
• Manual trigger: When user asks to "run self-improve" or "learn and improve"
• After significant events: User can request immediate run after major corrections

Installation#

bash

clawhub install self-improve

Or with OpenClaw CLI:

bash

openclaw skills install self-improve

Quick Start#

1. Configure Paths#

Edit user-config.yaml:

yaml

storage:
  root: "/path/to/self-improve"
  knowledge_root: "/path/to/learned"
  workspace_root: "/path/to/.openclaw"

owner:
  name: "YourName"
  timezone: "Asia/Shanghai"

2. Run Setup#

bash

node scripts/setup.mjs --config user-config.yaml

3. Approve Cron Task#

Check proposals/PENDING.md for the suggested Cron task.

How It Works#

text

Scan memory logs -> Extract signals -> Classify by theme
       |
Promote/demote rules between memory tiers
       |
Propose outputs:
  -> System file changes (needs approval)
  -> Knowledge base entries
  -> Blog drafts / methodologies

Memory Tiers#

TierLocationPurposeHOTdata/hot.mdFrequently used rulesWARMdata/themes/Theme-based rulesCOLDdata/archive/Archived rules

Dependencies#

• OpenClaw >= 2026.3.0
• Node.js >= 18.0.0

License#

MIT License