Master OpenClaw: The 3 Essential Markdown Files to Supercharge Your AI Agent

Overview

OpenClaw (also known as Moltbot or Clawdbot) uses three Markdown files on disk to define the agent’s personality, user context, and long‑term memory. This file‑based architecture is common across many modern AI‑assistant platforms, so mastering it provides a portable skill.

Core Configuration Files

SOUL.md – Personality and Communication Rules

SOUL.md

is read at the start of every conversation and determines how the agent speaks, prioritises replies, and respects behavioural boundaries.

Communication preferences : specify opening greetings, phrasing for research summaries, handling of uncertainty (e.g., always flag unknowns), and any negative constraints such as “do not use parallel sentences”.

External‑service boundaries : define when the agent may act on emails, share documents, or trigger system actions, and the level of user confirmation required for each type of operation.

Leaving the second half of the file blank leaves the agent to fall back on the base model’s default behaviour, which can be unsafe.

USER.md – User Context

USER.md

answers the question “Who am I working for?” and supplies the background that shapes the relevance of the agent’s output.

Include detailed project descriptions, key contacts, time‑zone information, personal priorities, family constraints, and any known obstacles.

Update the file regularly (e.g., 5 minutes each evening) to keep priorities and contacts current.

The file and SOUL.md are mutually dependent: a rich USER.md gives meaning to the personality rules, while an empty USER.md renders SOUL.md decorative.

MEMORY.md – Curated Long‑Term Memory

OpenClaw stores conversation history in two layers:

Daily log : a date‑based file that records key points, decisions, and useful information from each session.

MEMORY.md : a manually curated repository for permanent decisions, project background, and corrective notes.

To avoid token bloat, implement an importance‑scoring filter that only writes high‑value items to MEMORY.md. You can add an entry by telling the agent “add this to my memory.md ”.

Autonomous Execution Systems

Heartbeat

The heartbeat runs at a configurable interval (e.g., every 3 hours). When triggered, the agent:

Loads USER.md to understand what constitutes an urgent item.

Applies the notification rules defined in SOUL.md (e.g., lead‑time, format).

Decides whether to push a message to the user.

Use heartbeat for continuous monitoring of dynamic conditions such as “check for urgent emails” or “track daily Karma score”.

Cron Jobs

Cron jobs execute at exact timestamps (daily, weekly, etc.) and are suited for tasks that require precise scheduling, such as “send a summary report at 09:00 each morning”. Cron should not be used for frequent checks that belong to the heartbeat system.

Common Pitfalls

Partial or mismatched configuration leads to poor performance:

A detailed SOUL.md with an empty MEMORY.md yields a polite but forgetful agent.

A thin USER.md combined with an aggressive heartbeat produces accurate alerts that are irrelevant to the user’s current focus.

Align the three files and the execution systems so that personality, context, memory, and monitoring reinforce each other.

Practical Steps to Set Up OpenClaw

Create SOUL.md and write both halves: communication preferences and external‑service boundaries.

Populate USER.md with comprehensive background information; schedule a brief daily review.

Enable the memory feature, then add an importance‑scoring rule (e.g., score ≥ 0.7) before appending items to MEMORY.md.

Configure the heartbeat interval in the OpenClaw settings and list the tasks to monitor in USER.md.

Define any time‑specific actions as cron jobs using standard cron syntax (e.g., 0 9 * * * for a 9 AM daily run).

References

https://mp.weixin.qq.com/s?__biz=MzAwMDU1MTE1OQ==∣=2653564790&idx=1&sn=db82ae24f044c78358b04dd0c3f0390a

https://mp.weixin.qq.com/s?__biz=MzAwMDU1MTE1OQ==∣=2653564771&idx=1&sn=779ee63c125c242b0f9d6b9b2865d5ce

https://mp.weixin.qq.com/s?__biz=MzAwMDU1MTE1OQ==∣=2653564764&idx=1&sn=6ec70e559161884df148b209b27cfbc4

https://mp.weixin.qq.com/s?__biz=MzAwMDU1MTE1OQ==∣=2653564759&idx=1&sn=0e3029cd7574885564a87408ef11c569

Original tweet: https://x.com/Andrey__HQ/status/2018767494178349484