self-reflection

# 🪞 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 ```bash # 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`: ```json { "agents": { "defaults": { "heartbeat": { "every": "60m", "activeHours": { "start": "08:00", "end": "22:00" } } } } } ``` Add to your workspace `HEARTBEAT.md`: ```markdown ## 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`: ```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](https://github.com/hopyky) ## License MIT