Daily Introspection#

Overview#

Enables autonomous self-improvement for OpenClaw agents: automatically reviews daily conversation logs, identifies mistakes, extracts actionable rules, promotes mature lessons to permanent system rules, and continuously evolves the agent's behavior without manual intervention.

Data Storage#

TypeLocationDescriptionPrivate runtime data + all archived recordsworkspace/.daily-introspection/Private hidden directory (auto-created):

• Temporary cache, run logs, intermediate analysis
• Daily introspection records: introspection-YYYY-MM-DD.md
• Weekly evolution reports: evolution-YYWW.md |

Core Workflow#

1. Daily Run (triggered by cron at 22:00 daily)#

1. Run scripts/daily-introspect.py to collect all sources:

   • Read today's conversation log: memory/YYYY-MM-DD.md
   • Read today's learning/error/feature records: .learnings/*.md
   • Check proactive mechanism files: SESSION-STATE.md, HEARTBEAT.md, working-buffer.md

2. Call LLM to perform self-introspection:

   • Identify incorrect answers, rule violations, and bad patterns
   • Extract concrete improvement suggestions
   • Classify as: one-time mistake / repeat pattern / new rule

3. Write daily record to workspace/.daily-introspection/introspection-YYYY-MM-DD.md (private data directory)

2. Weekly Promotion (triggered by cron on Sunday 20:00)#

1. Aggregate all daily introspections from the week (read from workspace/.daily-introspection/)

2. Identify repeated patterns and validated improvements

3. First, perform all rule promotions immediately:

   • Promote mature rules to target files: AGENTS.md / MEMORY.md / TOOLS.md
   • Verify each promotion by reading the file after writing to confirm successful写入
   • Only after all promotions are verified complete, proceed to next step

4. Generate a weekly evolution report (reflecting that promotions are already done)

5. Send report to user for review

6. Archive the report to workspace/.daily-introspection/ (private data directory)

Mandatory Order: Do promotions → Verify promotions → Generate report → Send report Never: Generate report → Do promotions (this causes missed writes when interrupted)

Scripts#

scripts/daily-introspect.py#

Main entry point for daily self-introspection.

Usage:

bash

python3 scripts/daily-introspect.py [--date YYYY-MM-DD]

If no date specified, uses today.

scripts/weekly-promote.py#

Weekly promotion of lessons to permanent system files.

Usage:

bash

python3 scripts/weekly-promote.py [--week WWYY]

Configuration#

OpenClaw Cron Setup#

Add these two cron entries via OpenClaw CLI:

bash

# Daily introspection at 22:00
openclaw cron add --name "Daily Self-Introspection" --cron "0 22 * * *" --exact --tz "Asia/Shanghai" --session main --system-event "daily-introspection: Daily self-introspection is triggered. Follow the daily-introspection skill process:
1. Run the script $OPENCLAW_WORKSPACE/skills/daily-introspection/scripts/daily-introspect.py to collect all sources
2. Read the collected sources from the script output
3. Perform LLM introspection analysis following these rules:
   - For errors in .learnings/ERRORS.md: if only recorded with corrective action, mark as '✅ Recorded, Rule Added'; only mark as '✅ Corrected' when verified no recurrence for >1 week
   - Do not automatically assume recorded = corrected; reflect actual status accurately
   - Identify any new errors from today's activities, add them to .learnings/ERRORS.md with corrective rules
   - Write the final introspection result to ~/.openclaw/workspace/.daily-introspection/introspection-YYYY-MM-DD.md
4. Report completion status in this session when done"

# Weekly promotion at 20:00 every Sunday
openclaw cron add --name "Weekly Introspection Promotion" --cron "0 20 * * 0" --exact --tz "Asia/Shanghai" --session main --system-event "daily-introspection: Weekly promotion is triggered. Follow the weekly-promotion process:
1. Execute scripts/weekly-promote.py to collect all daily introspections from this week
2. Identify repeated patterns that have not recurred for >1 week
3. **MANDATORY EXECUTION ORDER**:
   - FIRST: Perform all rule promotions one by one → write each mature rule to its target file (AGENTS.md/MEMORY.md/TOOLS.md)
   - AFTER each write: Read the target file back to verify the rule is actually written successfully
   - ONLY after ALL promotions are done and verified: Write the weekly evolution report to ~/.openclaw/workspace/.daily-introspection/evolution-YYWW.md
   - Never reverse this order - do not write the report before promotions are complete
4. Report completion status in this session when done
Rules:
- Only promote rules that have been verified and no recurrence for 1+ week
- Keep new recorded errors/learnings in .learnings/ for further verification
- Do not promote immature rules prematurely

Configuration Notes#

• Daily schedule: 22:00 daily (adjust timezone as needed)
• Weekly schedule: 20:00 every Sunday
• Target: main session for interactive analysis and writing
• Timezone: Use your IANA timezone (e.g. Asia/Shanghai, UTC, America/New_York)