---
title: "万字讲透OpenClaw Workspace深度解析"
type: source
tags: [OpenClaw, Agent, Workspace, AGENTS.md, SOUL.md]
sources: []
last_updated: 2026-03-21
---

## Source File
- [[Agent/万字讲透OpenClaw-Workspace深度解析-2026-03-21.md]]

## 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
- 无已知冲突