Memory

File-Based Memory

Crucible agents use the filesystem as their memory store. This is intentional — it's transparent, inspectable, version-controllable, and survives restarts. No database required.

Memory Layers

• MEMORY.md — Long-term memory. Durable decisions, lessons learned, stable preferences, and reusable knowledge. Only updated when something truly durable changes.
• memory/YYYY-MM-DD.md — Daily notes. Raw logs, temporary notes, and work-in-progress details. The scratchpad for each session.
• ~/.openclaw/knowledge/ — Shared knowledge. Company, product, brand, and strategic context shared across all agents.

Memory Discipline

Agents are trained to check memory before starting work, update daily notes with raw progress, and promote durable lessons into long-term memory when they matter. The key principle: don't put temporary chatter into permanent storage.

Shared Knowledge

Some knowledge needs to be accessible to all agents. Company context, product information, and brand guidelines live in a shared knowledge directory. If an agent discovers something the whole team should know, it proposes an update through Crucinger.