mcpField
S
self-reflection

self-reflection

github.com/sundial-orgAgent workflows670162 installsUpdated 34w ago
Repository

About self-reflection

self-reflection is a skill for agents to record mistakes, lessons, and improvements over time. It uses heartbeat-triggered checks and commands to log, review, and track reflections, with documented OpenClaw setup.

Key features

  1. 01Check whether reflection is due
  2. 02Log lessons and improvement notes
  3. 03Read recent reflections
  4. 04View reflection statistics
  5. 05Configure OpenClaw heartbeat integration

Use cases

  1. 01Review lessons during scheduled agent heartbeats
  2. 02Record a correction after an agent error
  3. 03Inspect recent reflections and activity

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/sundial-org/awesome-openclaw-skills --skill self-reflection

After installing, type/self-reflectionin Claude Code to confirm it loaded.

Bundled filesREADME.mdself-reflection.example.json

Details

From the project README

🪞 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

CommandDescription
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)
statsShow reflection statistics
resetReset 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

Comments

Markdown supported