USER MANUAL · PRODUCTIVITY

Memory

Browse, search, and manage persistent memory entries for your OpenClaw agents.

/memory

Overview#

The Memory page lets you browse and manage per-agent memory entries stored in your OpenClaw gateway. Each agent can maintain its own memory files — persistent knowledge that the agent uses across sessions for context, preferences, and learned behavior.

Memory entries are fetched in real-time from the gateway via the agents.files.list and agents.files.get RPC methods. You can search across entries, create new ones, edit existing content, and delete entries you no longer need.

Prerequisites#

Prerequisites
  • At least one connector configured and synced (see Connectors)
  • Agents discovered and running (see Agents)
  • Agents with memory files in their working directory

OpenClaw Configuration#

OpenClaw stores per-agent memory files in the agent’s working directory at ~/.openclaw/agents/{agentId}/. Memory files are typically Markdown (.md) or plain text files that the agent reads and writes during sessions.

Key aspects of OpenClaw memory storage:

  • -MEMORY.md — The primary memory file that most agents use for persistent knowledge and learned preferences
  • -Custom files — Agents can create additional files (notes, data exports, scratch pads) in their working directory
  • -File access is per-agent — each agent can only read and write files within its own directory scope

Expected Results#

After opening the Memory page and selecting an agent, you will see:

  • -Agent selector dropdown listing all synced agents
  • -File list showing all memory entries for the selected agent with name, size, and last modified time
  • -Full-text search bar for filtering entries by content or filename
  • -Inline editor for viewing and modifying memory entry content

Web Operations#

Navigate to the Memory page from the sidebar under Productivity.

Browse Entries

Select an agent from the dropdown to load its memory files. Entries are displayed in a list with filename, size, and last modified timestamp. Click any entry to expand and view its full content in a read-only preview.

Search

Use the search bar to filter memory entries by filename or content keywords. Search results update in real-time as you type. Clear the search field to return to the full list.

Edit Entry

Click the Edit button on any entry to open the inline editor. Make your changes and click Save to persist them back to the OpenClaw gateway. You can also create new entries or delete existing ones using the toolbar actions.

CLI Operations#

List all memory entries for an agent

Terminal
$ ap memory list

Display the content of a specific memory entry

Terminal
$ ap memory show <id>

Mobile Operations#

On mobile, go to the More tab to access Memory. Features include:

  • -Agent selector and memory entry list with pull-to-refresh
  • -Tap any entry to view its content in a detail screen
  • -Read-only viewing optimized for quick reference on the go

FAQ#

Q: I don’t see any memory entries for an agent.
A: Not all agents create memory files. If an agent has never written to its working directory, the file list will be empty. Verify the agent is running and has memory capabilities enabled in its OpenClaw configuration.
Q: Can I create memory entries for an agent that doesn’t have any?
A: Yes. Use the Create button in the Web interface to add a new file to the agent’s working directory. The agent will be able to read this file in its next session.
Q: Are memory edits synced back to OpenClaw immediately?
A: Yes. When you save an edit, ClawButler writes the file back to the OpenClaw gateway via RPC. The change is available to the agent immediately — no restart or re-sync required.
Memory — ClawButler User Manual