How memory works, what files to create, and copy-paste prompts to train your AI without burning tokens.
It has no idea who you are, what you do, or what you worked on yesterday.
Without a memory system, you'll spend the first 10 minutes of every conversation re-explaining your business — burning tokens and your patience.
OpenClaw solves this with a workspace folder — a set of files your AI reads automatically at the start of every conversation. Think of it as a briefing packet your AI gets before every meeting.
Not everything needs to be read every session. Organize your memory into three tiers:
Read automatically every single session. Keep these lean.
Checked when needed. Small and current.
Only pulled when specifically needed.
| If it's... | Put it in... | Why |
|---|---|---|
| Your name, role, how to reach you | USER.md | Needed every session |
| Your business description | USER.md | Core context |
| How you want the AI to behave | SOUL.md | Personality, tone, rules |
| Live server IPs, deploy commands | TOOLS.md | Active infra only |
| A decision you made and why | MEMORY.md | Distilled, not raw |
| What's broken or in progress RIGHT NOW | knowledge-index.json | Changes frequently |
| Raw notes from today's session | memory/YYYY-MM-DD.md | Append-only log |
| Completed project history | memory/projects.md | Archive, searchable |
| Team member bios, vendor details | memory/people.md | Only needed sometimes |
| Hard lessons learned | memory/learnings.md | Promoted from logs |
Use these prompts to build your memory files from scratch. Paste them into your AI chat and answer the questions — your AI will create the files for you.
This creates the core file your AI reads every session — who you are, your business, and how you like to work.
This shapes how your AI talks to you — tone, style, and behavior rules.
Tells your AI about your live systems so it never asks "what server are you on?" again.
Gets important decisions and hard-won lessons into long-term memory right away.
Run this once a month to keep your memory files lean and accurate.
Begin every conversation with: "Check memory for [topic]" before asking your question. This triggers a targeted search instead of re-explaining everything.
Every character in your bootstrap files costs tokens on every session. A 1,000-char bloated section = wasted tokens every single day.
Move old content to memory/projects.md or memory/people.md instead of deleting. Your AI can still find it via search — it just won't load it every session.
Before ending a long session, ask your AI: "Write a CONTINUATION.md with our current state." Next session it picks up exactly where you left off.
knowledge-index.json is your AI's fast-access cheat sheet — small, always current, loaded every session. Put "what's broken right now" there, not in MEMORY.md.
Files like HEARTBEAT.md or setup guides shouldn't be in your root workspace folder — they load every session for no reason. Move them to a system/ subfolder.
If it wasn't written down, it didn't happen.
Your AI wakes up fresh every session. Every decision, every preference, every hard-won lesson — if it's not in a file, it's gone.