🪞 Self-Reflection
A skill for continuous self-improvement. The agent tracks mistakes, lessons learned, and improvements over time through regular heartbeat-triggered reflections.
Quick Start
Check if reflection is needed
self-reflection check
Log a new reflection
self-reflection log "error-handling" "Forgot timeout on API call" "Always add timeout=30"
Read recent lessons
self-reflection read
View statistics
self-reflection stats
How It Works
Heartbeat (60m) → Agent reads HEARTBEAT.md → Runs self-reflection check │ ┌─────────┴─────────┐ ▼ ▼ OK ALERT │ │ Continue Reflect │ ┌─────────┴─────────┐ ▼ ▼ read log (past lessons) (new insights)
Commands
Command Description
check [--quiet]
Check if reflection is due (OK or ALERT)
log <tag> <miss> <fix>
Log a new reflection
read [n]
Read last n reflections (default: 5)
stats
Show reflection statistics
reset
Reset the timer
OpenClaw Integration
Enable heartbeat in ~/.openclaw/openclaw.json :
{ "agents": { "defaults": { "heartbeat": { "every": "60m", "activeHours": { "start": "08:00", "end": "22:00" } } } } }
Add to your workspace HEARTBEAT.md :
Self-Reflection Check (required)
Run self-reflection check at each heartbeat.
If ALERT: read past lessons, reflect, then log insights.
Configuration
Create ~/.openclaw/self-reflection.json :
{
"threshold_minutes": 60,
"memory_file": "/workspace/memory/self-review.md",
"state_file": "/.openclaw/self-review-state.json",
"max_entries_context": 5
}
Author
Created by hopyky
License
MIT