Self-Improve

A pluggable self-improvement framework for AI agents. Automatically learns from mistakes, corrections, and feedback to continuously improve execution quality. Runs every 3 days via Cron, extracts reusable experience rules, and proposes improvements to system files with approval workflow.

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

clawhub install self-improve

Or with OpenClaw CLI:

openclaw skills install self-improve

Quick Start

1. Configure Paths

Edit user-config.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

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

3. Approve Cron Task

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

How It Works

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

Tier	Location	Purpose
HOT	data/hot.md	Frequently used rules
WARM	data/themes/	Theme-based rules
COLD	data/archive/	Archived rules

Dependencies

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

License

MIT License