使用手册 · 生产力
记忆
浏览、搜索和管理 OpenClaw Agent 的持久化记忆条目。
/memory概述#
记忆页面让你浏览和管理存储在 OpenClaw 网关中的每个 Agent 的记忆条目。每个 Agent 可以维护自己的记忆文件——这些持久化知识会在会话间保留，用于上下文、偏好和学习到的行为。
记忆条目通过 agents.files.list 和 agents.files.get RPC 方法从网关实时获取。你可以搜索条目、创建新条目、编辑已有内容，以及删除不再需要的条目。
前置条件#
前置条件
- 至少配置并同步了一个连接器（参见「连接器」）
- Agent 已发现并正在运行（参见「Agent」）
- Agent 工作目录中存在记忆文件
OpenClaw 侧配置#
OpenClaw 将每个 Agent 的记忆文件存储在 ~/.openclaw/agents/{agentId}/ 目录下。记忆文件通常是 Markdown（.md）或纯文本文件，Agent 在会话期间会读写这些文件。
OpenClaw 记忆存储的关键方面：
- -MEMORY.md — 大多数 Agent 用于持久化知识和学习偏好的主记忆文件
- -自定义文件 — Agent 可以在工作目录中创建额外文件（笔记、数据导出、草稿等）
- -文件访问按 Agent 隔离 — 每个 Agent 只能读写其自己目录范围内的文件
使用反馈#
打开记忆页面并选择一个 Agent 后，你将看到：
- -Agent 选择下拉菜单，列出所有已同步的 Agent
- -文件列表，显示所选 Agent 的所有记忆条目，包含文件名、大小和最后修改时间
- -全文搜索栏，可按内容或文件名过滤条目
- -内联编辑器，用于查看和修改记忆条目内容
Web 端操作#
从侧边栏“生产力”分组下导航到记忆页面。
浏览条目
从下拉菜单选择一个 Agent 以加载其记忆文件。条目以列表形式显示，包含文件名、大小和最后修改时间。点击任意条目可展开查看其完整内容。
搜索
使用搜索栏按文件名或内容关键词过滤记忆条目。搜索结果随输入实时更新。清空搜索框可返回完整列表。
编辑条目
点击任意条目的“编辑”按钮打开内联编辑器。修改完成后点击“保存”将更改写回 OpenClaw 网关。你还可以使用工具栏操作创建新条目或删除已有条目。
CLI 端操作#
列出某个 Agent 的所有记忆条目
Terminal
$ ap memory list显示某个记忆条目的内容
Terminal
$ ap memory show <id>移动端操作#
在移动端，进入“更多”标签页访问记忆功能。功能包括：
- -Agent 选择器和记忆条目列表，支持下拉刷新
- -点击任意条目可在详情页查看内容
- -为移动端优化的只读浏览，方便随时查阅
常见问题#
Q: 我看不到某个 Agent 的任何记忆条目。
A: 并非所有 Agent 都会创建记忆文件。如果某个 Agent 从未写入其工作目录，文件列表将为空。确认 Agent 正在运行并在 OpenClaw 配置中启用了记忆功能。
Q: 我能为没有记忆的 Agent 创建条目吗？
A: 可以。在 Web 界面中使用“创建”按钮向 Agent 工作目录添加新文件。Agent 在下次会话中就能读取该文件。
Q: 记忆编辑会立即同步回 OpenClaw 吗？
A: 是的。保存编辑时，ClawButler 通过 RPC 将文件写回 OpenClaw 网关。更改立即对 Agent 可用——无需重启或重新同步。