
Open Claw Set Up Files
OpenClaw normally keeps these files in its workspace, usually ~/.openclaw/workspace/.
Core Agent Identity
Environment & Tools
TOOLS.md
Notes about local tools, machines, aliases, device names, and conventions.
~/.openclaw/workspace/TOOLS.mdENVIRONMENT.md
The machine and environment the agent runs on — OS, paths, installed software, and constraints.
~/.openclaw/workspace/ENVIRONMENT.mdDEVICES.md
Devices the agent can see or control — names, addresses, and what each one is for.
~/.openclaw/workspace/DEVICES.mdCOMMANDS.md
Frequently used commands and how to run them correctly.
~/.openclaw/workspace/COMMANDS.mdALIASES.md
Shorthand names and abbreviations the agent should recognize and expand.
~/.openclaw/workspace/ALIASES.mdMemory System
MEMORY.md
Curated long-term memory.
~/.openclaw/workspace/MEMORY.mdMEMORY_RULES.md
Rules for what to remember, what to forget, and how memory files are maintained.
~/.openclaw/workspace/MEMORY_RULES.mdMEMORY_INDEX.md
An index of the memory files so the agent can find the right one fast.
~/.openclaw/workspace/MEMORY_INDEX.mdmemory/YYYY-MM-DD.md
Detailed daily memory files, one per day.
~/.openclaw/workspace/memory/YYYY-MM-DD.mdmemory/YYYY-MM-DD-<slug>.md
Named daily or per-session memory variants.
~/.openclaw/workspace/memory/YYYY-MM-DD-<slug>.mdOperations
HEARTBEAT.md
Checklist or instructions for periodic heartbeat runs.
~/.openclaw/workspace/HEARTBEAT.mdBOOT.md
OptionalOptional checklist run after a gateway restart when the relevant hooks are enabled.
~/.openclaw/workspace/BOOT.mdBOOTSTRAP.md
OptionalOne-time first-run setup ritual; normally removed after setup completes.
~/.openclaw/workspace/BOOTSTRAP.mdSHUTDOWN.md
OptionalChecklist the agent runs through before shutting down or going offline.
~/.openclaw/workspace/SHUTDOWN.mdMAINTENANCE.md
OptionalRecurring maintenance routines — cleanups, log rotation, and periodic health checks.
~/.openclaw/workspace/MAINTENANCE.mdSkills & Capabilities
SKILL.md
The entry file for each OpenClaw skill. OpenClaw searches several skill locations, including workspace, personal, managed, and bundled skill directories.
<skill-directory>/SKILL.mdSKILLS.md
An overview of the skills the agent has installed and when to reach for each one.
~/.openclaw/workspace/SKILLS.mdCAPABILITIES.md
What the agent can and cannot do — its powers, limits, and escalation points.
~/.openclaw/workspace/CAPABILITIES.mdBehavior & Policies
RULES.md
Hard rules the agent must never break, stated plainly and kept short.
~/.openclaw/workspace/RULES.mdGUIDELINES.md
Softer behavioral guidance — defaults and judgment calls rather than hard rules.
~/.openclaw/workspace/GUIDELINES.mdSAFETY.md
Safety boundaries: destructive actions, spending limits, and when to stop and ask.
~/.openclaw/workspace/SAFETY.mdPRIVACY.md
How the agent handles personal data — what stays private and what may be shared.
~/.openclaw/workspace/PRIVACY.mdCOMMUNICATION.md
How, when, and where the agent communicates — channels, tone, and notification rules.
~/.openclaw/workspace/COMMUNICATION.mdProjects & Workflows
PROJECTS.md
Active projects, their goals, and current status at a glance.
~/.openclaw/workspace/PROJECTS.mdTODO.md
The running task list the agent works from and keeps updated.
~/.openclaw/workspace/TODO.mdROADMAP.md
Longer-term plans and milestones beyond the immediate task list.
~/.openclaw/workspace/ROADMAP.mdWORKFLOWS.md
Repeatable multi-step workflows the agent can run end to end.
~/.openclaw/workspace/WORKFLOWS.mdPROCEDURES.md
Step-by-step procedures for recurring situations, written to be followed exactly.
~/.openclaw/workspace/PROCEDURES.mdKnowledge & Reference
KNOWLEDGE.md
A curated knowledge base of facts the agent should treat as ground truth.
~/.openclaw/workspace/KNOWLEDGE.mdREFERENCES.md
Links, documents, and other reference material the agent may need to consult.
~/.openclaw/workspace/REFERENCES.mdGLOSSARY.md
Definitions of project-specific terms, names, and jargon.
~/.openclaw/workspace/GLOSSARY.mdFAQ.md
Answers to questions the agent gets asked (or asks) repeatedly.
~/.openclaw/workspace/FAQ.mdOptional Personality / Fun
DREAMS.md
OptionalOptional human-readable dreaming and memory-review diary.
~/.openclaw/workspace/DREAMS.mdSTORIES.md
OptionalStories and lore the agent has collected or written along the way.
~/.openclaw/workspace/STORIES.mdFAVORITES.md
OptionalThe agent's favorites — things it likes, saved for personality and continuity.
~/.openclaw/workspace/FAVORITES.md