🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Self Reflection
πŸ¦€ ClawHub

Self Reflection

by @hopyky

Continuous self-improvement through structured reflection and memory

Versionv1.1.1
Downloads18,089
Stars⭐ 43
#clawhub
TERMINAL
clawhub install self-reflection

πŸ“– About This Skill

name: self-reflection description: Continuous self-improvement through structured reflection and memory version: 1.1.1 metadata: {"openclaw":{"emoji":"πŸͺž","requires":{"bins":["jq","date"]}}}

πŸͺž 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 | 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

πŸ’‘ Examples

# 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

βš™οΈ 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
}