Skill v1.1.1

currentAutomated scan100/100

luovicter-collab/openclaw-docs/self-reflection

──Details

PublishedSeptember 27, 2026 at 08:00 PM

Content Hashsha256:718d7f89fd9ac6b2...

Git SHAc70f679da6e6

──Files

Files (1 file, 2.7 KB)

SKILL.md2.7 KBactive

SKILL.md · 100 lines · 2.7 KB

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

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`	已反思但无需记录时使用，重置计时器；与 `log` 区分：有洞察用 log，无新洞察用 reset

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": "~/.openclaw/workspace/memory/self-review.md",
  "state_file": "~/.openclaw/self-review-state.json",
  "max_entries_context": 5
}

Author

Created by hopyky

License

MIT

All versions