Classroom / 2. The Mental Model

The Workspace

The Home Folder

Your agent lives in a folder on your disk, typically ~/clawd.

Anatomy of a Workspace

  • AGENTS.md: Operating Instructions. (e.g., "Always speak like a pirate.")
  • SOUL.md: Personality. The core identity.
  • MEMORY.md: Long-term Facts. Where it writes things to remember.
  • memory/: Daily Logs. Chronological history.

Pro Tip

Edit AGENTS.md directly to change your bot's behavior instantly. No restart required.

Knowledge Check

Which file should you edit to change the bot's behavior instructions?