4.4 KiB
4.4 KiB
title, type, tags, sources, last_updated
| title | type | tags | sources | last_updated | |||||
|---|---|---|---|---|---|---|---|---|---|
| 万字讲透OpenClaw Workspace深度解析 | source |
|
2026-03-21 |
Source File
Summary（用中文描述）
- 核心主题：OpenClaw 的 workspace 目录体系——让 Agent 从"能用"进化到"真好用"的关键文件架构
- 问题域：Agent 个性化配置、长期记忆机制、多 Agent 协作时的行为一致性
- 方法/机制：通过 workspace 目录下的多个 Markdown 文件（AGENTS.md/SOUL.md/USER.md/IDENTITY.md/TOOLS.md/MEMORY.md 等）分别管理职责、性格、用户偏好、身份元数据、工具规范和长期记忆
- 结论/价值：workspace 文件配合好后，Agent 不再是每次都要重新 onboarding 的陌生人，而是一个真正懂你、记得你、靠谱的长期搭档
Key Claims（用中文描述）
- OpenClaw 使用者存在一条隐形分界线：一边每次都要重新交代背景，另一边的 Agent 已知道用户是谁、该怎么说话——这条分界线就是 workspace
- workspace 管的是"Agent 平时怎么干活"（文件内容），openclaw.json 管的是"系统怎么把 Agent 跑起来"（配置参数），两者职责不同
- AGENTS.md 是岗位说明书（做什么、怎么做、边界在哪），SOUL.md 是性格档案（是谁、什么风格、怎么思考），两者不应混写
- 300-500 字的 AGENTS.md 比 2000 字的更有效——边界比能力描述更重要，LLM 默认会"发挥创意"需要约束
- SOUL.md 定义 Agent 性格，USER.md 定义用户偏好，两者放在一起相当于在 Agent 脑子里预装了"人机关系的基本共识"
- TOOLS.md 的核心价值是明确"什么时候不该用"比"什么时候该用"更重要，减少工具误用和权限越界
- 真正算数的长期记忆是 workspace 里那些 Markdown 文件，不是看不见的黑盒数据库——memory/ 目录让 Agent 真正拥有跨会话记忆
Key Quotes
"workspace 是 Agent 的工作台（决定怎么工作），agentDir 是 openclaw.json 里的配置字段（指向存放运行状态的目录），sessions 是工作日志（记对话历史）。三者职责不同，不要混为一谈。" — workspace 全貌区分 "AGENTS.md 不是越长越好——300-500 字的 AGENTS.md，比 2000 字的更有效。" — 经验法则 "一个没有 SOUL.md 的 Agent，每次对话都像第一次见面——它不记得自己是谁，说话没有固定风格。" — SOUL.md 必要性 "对 Agent 来说，真正算数的长期记忆，是 workspace 里那些 Markdown 文件，不是什么看不见摸不着的黑盒数据库。" — 记忆机制核心洞察
Key Concepts
- Workspace：Agent 的工作台目录（~/.openclaw/workspace/），包含 AGENTS.md、SOUL.md、USER.md 等配置文件，决定 Agent 怎么工作
- AGENTS.md：Agent 的工作说明书，定义职责、边界、多 Agent 协作流程；300-500 字最优
- SOUL.md：Agent 的性格档案，叙事性角色设定文档（与 IDENTITY.md 的结构化元数据分工明确）
- USER.md：用户画像与偏好固化，减少每次对话的重复交代
- IDENTITY.md：Agent 结构化身份元数据（Name/Creature/Vibe/Emoji/Avatar），与 SOUL.md 叙事分工
- TOOLS.md：工具权限声明与使用规范，明确"什么时候不该用"比"什么时候该用"更重要
- BOOTSTRAP.md：一次性出厂引导，完成初始化后应删除
- HEARTBEAT.md：会话节奏/状态提示的默认模板之一
- MEMORY.md：长期知识总表，与 memory/ 日期滚动目录共同构成 Agent 的持久记忆层
- Agent-Memory：OpenClaw 通过 builtin 或 qmd 方案，将重要信息写入 memory/ 或 MEMORY.md，下次对话通过 memory_search/memory_get 检索注入上下文
Key Entities
- OpenClaw：本文的核心研究对象，multi-agent 框架，workspace 体系是其从"能用"到"真好用"的分水岭
- DracoVibeCoding：公众号"Draco正在VibeCoding"作者，本文原创作者
Connections
- OpenClaw ← uses ← Workspace
- Workspace ← composed of ← AGENTS.md, SOUL.md, USER.md, IDENTITY.md, TOOLS.md, MEMORY.md
- AGENTS.md ← informs ← Agent-Specialization
- Agent-Memory ← built on ← Workspace + MEMORY.md + memory/目录
Contradictions
- 无已知冲突