---
title: Memory
description: How PhysiClaw remembers across sessions — a small set of plain-Markdown files under ~/.physiclaw/memory.
---

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

<FileTree>
- ~/.physiclaw/memory/
  - USER.md
  - memory.md
  - 2026-06-22.md
  - …
</FileTree>

| File | Holds | Who writes it |
| --- | --- | --- |
| `USER.md` | who you are, your preferences, the messaging apps you use | you |
| `memory.md` | things you've asked the agent to remember | the agent |
| `YYYY-MM-DD.md` | that day's activity log, append-only | the agent |

## 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

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.

:::tip[Message]
Remember I'm allergic to peanuts — always check before ordering food.
:::
