name: structured-memory description: Build and maintain a structured memory system for OpenClaw workspaces using layered storage: daily memory as the source of truth, domain/module/entity/tag indexing, critical-facts extraction, and retrieval planning. Use when designing, initializing, updating, or operating a memory system that must scale across work topics such as business, finance, legal, HR, projects, operations, tech, routines, and personal context.

Structured Memory

Version: 1.0.1

Use this skill to initialize and maintain a layered memory system in the OpenClaw workspace.

What it does

• Uses memory/YYYY-MM-DD.md as the source of truth
• Builds rebuildable indexes by date, module, and entity
• Extracts reusable execution-critical facts into critical-facts/
• Rebuilds object-style cards under critical-facts/cards/
• On first initialization, backfills existing memory/*.md history automatically
• Maintains a frozen summary baseline with preview + topic_summaries

Default operating rule

For agents that have this skill installed, structured-memory should not be treated only as an on-demand utility. When the day produced meaningful task progress, decisions, blockers, risks, reusable execution-critical facts, or other meaningful updates to memory/YYYY-MM-DD.md, the agent should treat structured-memory rebuild as part of its default memory maintenance workflow.

Work-cycle maintenance rule

After meaningful updates are written into memory/YYYY-MM-DD.md, the agent should normally rebuild the current day into the structured layer before the work cycle ends. This keeps indexes, modules, entities, critical-facts, and cards aligned with the source-of-truth daily memory.

Core rules

1. Treat memory/YYYY-MM-DD.md as the source of truth.
2. Keep first-level domain fixed and small.
3. Create second-level module files only on demand.
4. Prefer entities for stable objects and free_tags for one-off concepts.
5. Store reusable execution-critical facts under critical-facts/.
6. Never store high-sensitivity secrets in plain text unless the user explicitly requires it.
7. Indexes are rebuildable caches, not the truth.
8. A short daily preview is only for quick glance; it must not replace topic-level summaries for multi-topic days.

Fixed first-level domains

Use these exact domains:

• strategy
• business
• organization
• finance
• legal
• project
• operations
• tech
• routines
• personal
• meta
• misc

When creating modules

Before creating a new module:

1. Check whether an equivalent module already exists.
2. Check whether the concept should instead be an entity.
3. Check whether the concept is too specific and should remain a free tag.
4. Create a module only if it is a reusable topic bucket.

Retrieval order