OpenClaw Agent、Workspace、记忆管理高阶指南

一、 核心架构：灵魂与办公室

在 OpenClaw 中，高效工作的核心在于理解 Agent（智能体） 与 Workspace（工作区） 的解耦关系：

• Agent (灵魂)：定义了 AI 的角色、性格、模型和工具权限（如是否开启 Tavily 联网搜索）。
• Workspace (办公室)：定义了 AI 的物理存储位置，包含长期记忆（MEMORY.md）和对话日志（history/）。

二、 工作区（Workspace）的科学规划

为了避免“上下文污染”（即 AI 把 A 项目的代码写进 B 项目），建议采用 “1+N” 模块化布局：

1. 目录结构推荐

• ~/.openclaw/workspaces/general：处理日常琐事，存放个人基础信息。
• ~/.openclaw/workspaces/project_a：特定项目空间，存放该项目的技术栈、API 文档。

2. 迁移与进入

• 手动进入：启动时指定路径：openclaw --workspace <路径>。
• 自动迁移：可以通过提示词指挥 Agent 将 MEMORY.md 读出并使用 write_file 写入新路径，实现“搬家”。

三、 记忆管理系统：如何让 AI 不健忘

OpenClaw 通过三层结构维持记忆，其中 MEMORY.md 是最关键的“读档位”。

1. MEMORY.md 标准模板

建议在每个工作区根目录维护该文件：

## 👤 用户偏好：中文回复、代码需带注释。## 🚀 当前进度：正在集成支付接口，已完成前端 UI。## 📂 核心事实：数据库端口 5432，使用 Tavily Key: tvly-xxx。## 🛠️ 待办事项：1. 修复登录 Bug；2. 部署到测试环境。

2. 如何保存“当日记忆”

在下班前，对 Agent 发送指令：

“总结今日对话，提取技术决策和进度，并使用 write_file 更新到 MEMORY.md 和 memory/daily/2024-xx-xx.md 中。”

3. 如何读取“以前记忆”

启动后发送引导指令：

“请阅读工作区下的 MEMORY.md，总结我们上次停在哪里，并列出接下来的前三个任务。”

四、 Agent 体系建设

当你不再满足于通用助手，可以创建垂直领域的 Agent 组。

1. 创建新 Agent (JSON 模板)

将以下内容保存至 ~/.openclaw/agents/project_expert.json：

{"id":"project_expert","name":"项目专项执行官","system_prompt":"你是一个接管了特定项目的 Agent。请优先读取工作区 MEMORY.md 了解进度。","tools":["read_file","write_file","web_search"],"model":"gpt-4o"}

2. 功能细分（子 Agent）

一个 Agent 无法物理分裂，但可以通过以下方式实现功能细分：

• 人格切换：在 Prompt 中定义“/code”和“/research”模式。
• 协作模式：让多个专门 Agent（如 Coder, Searcher）进入同一个 Workspace，通过共享 MEMORY.md 进行接力工作。

五、 初始化与重置

如果通用工作区变得混乱，可以通过提示词执行“净空操作”：

1. 清空 MEMORY.md：删除过时的项目背景。
2. 清理日志：删除或归档 logs/ 下的旧 jsonl 文件。
3. 重置会话：告知 AI 开启全新任务。

六、 快速启动速查表