| name | chronicle |
| description | A system for recording, indexing, and distilling knowledge from agent lifecycle events. Through a three-layer document system (overview -> detailed records -> knowledge distillation), raw conversation events are transformed into reusable experience. |
| origin | openclaw |
| version | 0.2.0.2 |
| compatibility | ["openclaw","claude-code","cursor","windsurf"] |
| allowed-tools | ["Bash","Read","Write","Edit","WebSearch","WebFetch","Agent"] |
| defense_triple_required | false |
| metadata | {"domain":"knowledge","tool_count":4,"guide_count":5,"last_reviewed":"2026-07-26"} |
Skill: Chronicle System
Supplementary Files:
chronicle-template.py — Chronicle detailed record template generator (Python script that automatically generates event record files and creates directory structures)
Summary
Through a three-layer document system (overview -> detailed records -> knowledge distillation), raw conversation events are transformed into reusable experience.
Tools: MEMORY.md, HEARTBEAT.md, TOOLS.md, skills/
Domain: knowledge
Description
A system for recording, indexing, and distilling knowledge from agent lifecycle events. Through a three-layer document system (overview -> detailed records -> knowledge distillation), raw conversation events are transformed into reusable experience.
Distinction from MEMORY.md: Chronicle records "what happened," while MEMORY.md records "what was learned."
Use Cases
- Completing a major security discovery (high-severity vulnerability, data breach)
- Achieving a key milestone (learning plan completion, tool mastery)
- Important environment or configuration changes
- Need to quickly review historical events and handling approaches
- Periodic archiving of expired logs from memory/
Three-Layer Architecture
+------------------------------------------+
| Layer 1: CHRONICLE.md (Overview Index) |
| Timeline + one-line summary + nav links |
+------------------+-----------------------+
|
v
+------------------------------------------+
| Layer 2: chronicle/YYYY-MM/ |
| YYYY-MM-DD-event-name.md (Detail) |
| Background, process, results, outputs, |
| impact |
+------------------+-----------------------+
|
v
+------------------------------------------+
| Layer 3: MEMORY.md (Knowledge Distill) |
| Experience, lessons, capability growth |
+------------------------------------------+
Event Classification
| Type | Icon | Priority | Trigger Condition |
|---|
| Security Discovery | red_circle | P0 Record immediately | High-severity vulnerability, data breach, credential exposure |
| Milestone Achieved | party_popper | P0 Record immediately | Learning plan completed, full tool mastery |
