Introduction
# 🪞 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