Skip to content
PhysiClaw PhysiClaw Docs
简体中文

Memory

When the agent wakes, it loads the Markdown files under ~/.physiclaw/memory/ to keep its memory continuous across sessions.

  • Directory~/.physiclaw/memory/
    • USER.md
    • memory.md
    • 2026-06-22.md
    • …
FileHoldsWho writes it
USER.mdwho you are, your preferences, the messaging apps you useyou
memory.mdthings you’ve asked the agent to rememberthe agent
YYYY-MM-DD.mdthat day’s activity log, append-onlythe agent

Example

Section titled “Example”

USER.md is optional. It holds info about you, so you don’t have to tell the agent the same things every time.

markdown
## Name
Mike


## Messaging
WhatsApp (handle: mike_g)


## Communication
- Always reply to the message first, then act
- Confirm with me before any payment


## Useful info
Shipping address: 123 Main St, Austin, TX 78701


## Taste
No spicy food; coffee black, no sugar

Tell it to remember

Section titled “Tell it to remember”

You don’t need to edit these memory files by hand. Just tell PhysiClaw what to remember in the conversation, and it will write it to memory.md automatically. Every future session will remember it.