前言
龙虾上手已经两月了，期间经历了无数次了重装、修复、踩坑、调整等操作，针对龙虾的Workspace目录总结一直没来及记录，今天让龙虾协助我来完善🦞，防止后续 因为新鲜感过了后，再捡起来一脸懵😂
Workspace
在 OpenClaw 的使用中，存在一条隐形的分界线。一边是每次对话都像重新入职的“新手” Agent；另一边是懂你偏好、有稳定性格的“熟手” Agent。这条分界线就是 Workspace。
Workspace 是 Agent 的“工作台”，决定了它如何工作。本文将核心文件拆解为一张职责地图，并总结了配置时的常见误区。
🗺️ Workspace 核心文件职责地图
理解这些文件的分工，是配置好 Agent 的第一步。我们可以将它们类比为现实工作中的不同文档。
| 文件名 | 核心职责 | 形象类比 | 关键说明 |
|---|---|---|---|
BOOTSTRAP.md | 首次启动向导 | 新员工报到手册 | 初始化后通常删除，使命是引导配置。 |
IDENTITY.md | 身份元数据 | 工牌/名片 | 定义名字、Emoji、头像和基本气质。 |
SOUL.md | 叙事性格设定 | 人物小传 | 决定 Agent 是谁、价值观、说话风格。 |
AGENTS.md | 行为规则与职责 | 岗位说明书 | 定义能做什么、边界在哪、多 Agent 协作。 |
USER.md | 用户画像 | 上司简介 | 记录用户的背景、偏好、职业和常用工具。 |
TOOLS.md | 工具使用规范 | 工具手册 | 规定工具的使用原则、优先级和受限操作。 |
HEARTBEAT.md | 会话节奏/状态 | 值班提醒卡 | 控制默认的提示频率和状态检查逻辑。 |
MEMORY.md | 长期知识总表 | 整理后的笔记 | 存放高价值、可复用的长期记忆（非每日）。 |
memory/ | 按日滚动记忆 | 工作笔记本 | 按日期记录的原始对话和上下文记忆。 |
skills/ | 专项技能包 | 操作手册 | 模块化的任务流程（如代码审查、调研）。 |
🧩 核心文件深度解析
1. AGENTS.md：岗位说明书
这是最关键的文件之一，但它不是越长越好。
- 核心作用：定义职责、规则、边界和多 Agent 协作逻辑。
避坑指南：
- 边界 > 能力：明确写出“不该做什么”比“能做什么”更重要，防止 LLM 过度发挥。
- 场景触发：优于通用指令。例如“当用户问技术问题时...”比“始终保持专业”更有效。
- 精简为王：300-500 字通常比 2000 字更有效，重点不要被淹没。
2. SOUL.md：性格档案
这是 Agent 的“灵魂”，让它从“程序”变成“搭子”。
与 AGENTS 的区别：
AGENTS.md是功能性的（怎么做工作）。SOUL.md是人格性的（是谁、怎么思考、怎么面对压力）。
- 关键要素：自我叙事、沟通风格（如：讨厌废话）、价值观（如：诚实第一）、有趣的细节（彩蛋）。
3. USER.md：用户偏好固化
不要每次对话都重复交代背景。
- 作用：将用户的背景（如职业、常用语言）、偏好（如回答风格、代码偏好）和常见任务固化下来。
- 协同效应：
SOUL.md（助理性格）+USER.md（老板性格）= 预装了“人机关系共识”。
4. TOOLS.md：工具规范
- 作用：不仅是工具列表，更是使用规范。明确何时该用、何时禁用（如删除操作需确认）。
与配置文件的区别：
openclaw.json决定能不能用（系统层权限）。TOOLS.md决定该不该用（工作层规范）。
5. 记忆机制 (memory/ 与 MEMORY.md)
OpenClaw 的记忆是基于文件的，而非黑盒数据库。
memory/YYYY-MM-DD.md：每日工作记忆，按天滚动。MEMORY.md：长期知识库，需要定期将高价值信息从每日记忆中提炼进去。- 原则：文字比脑内记忆更可靠。想记住什么，就写进文件里。
⚙️ 多 Agent 场景下的架构
在多 Agent 系统中，Workspace 的设计至关重要：
- 独立性：每个 Agent 应该有独立的 Workspace。研究员和写作者的性格（
SOUL.md）和职责（AGENTS.md）应该完全不同。 - 共享策略：如果多个 Agent 需要共享某些背景信息（如项目背景），建议将其做成公共 Skill 或放在共享目录中，避免重复维护。
🚀 配置六坑避雷指南
- 📜 文件过长：
AGENTS.md越写越长，重点被冲淡。解法：定期剪枝，保留核心。 - 🔀 职责混淆：
SOUL.md和AGENTS.md内容重叠。解法：性格归性格，工作归工作。 - 👯 共用 Workspace：多个 Agent 共用一套配置，导致分工失效。解法：每个 Agent 独立配置。
- 🔗 路径未更新：改了目录但忘了改
openclaw.json。解法：修改后运行openclaw doctor检查。 - 🎣 触发过宽：Skill 的触发条件太模糊，导致上下文膨胀。解法：写具体场景，精准触发。
- 🗑️ 记忆污染：
memory/积累大量过时信息。解法：定期清理，养成“该记就记、过期就删”的习惯。
💡 进阶思维：动态维护
- 活文档：Workspace 文件不是静态的。允许 Agent 在权限范围内更新
USER.md或MEMORY.md，实现“越用越懂你”。 - 版本管理：建议将 Workspace 目录纳入 Git 管理。一旦改坏，能快速回滚到正常状态。
总结：Workspace 里写的每一行，都是在告诉 Agent “我是谁、你是谁、我们一起怎么做事”。工具决定了上限，而 Workspace 决定了你能否触达这个上限。
