Configuration
Memory
Understand local memory, daily notes, and optional cloud memory.
Memory gives agents durable context between sessions.
xCloud supports local markdown memory and optional Supermemory cloud memory.
Local Memory
Local memory lives in the active engine workspace.
~/.openclaw/workspace/memory/
MEMORY.md
daily-notes/The app can open the memory folder directly from Settings > Memory.
What Agents Use Memory For
Agents can use memory for:
- Long-term preferences.
- User profile details.
- Ongoing project facts.
- Daily notes.
- Repeated workflows.
Memory is not a replacement for project files. Keep permanent project requirements in agent files such as PROJECT_BRIEF.md or SOURCE_SPEC.md.
Remote Engines
Memory belongs to the active engine.
If the active engine is a VPS, the memory files live on the VPS. If the active engine is Local, memory files live on your Mac.
Supermemory
Supermemory is optional cloud memory.
To enable it:
- Go to Settings > Memory.
- Open Supermemory.
- Paste the API key.
- Save and test the connection.
Privacy Checklist
Before sharing an agent or exporting a package:
- Review
MEMORY.md. - Review daily notes.
- Remove personal or customer data.
- Confirm the package does not include private files.
Common Problems
| Problem | Fix |
|---|---|
| Memory count is zero | The memory folder may not exist yet |
| Agent forgot something | Ask the agent to write it into memory explicitly |
| Memory exists on Local but not VPS | Switch engines or copy memory to the VPS |
| Supermemory test fails | Check the API key and network access from the active engine |