Auto-sync: 2026-04-17 08:35

wiki/sources/万字讲透OpenClaw-Workspace深度解析-2026-03-21.md

@@ -0,0 +1,54 @@
+---
+title: "万字讲透OpenClaw🦞从"能用"到"真好用"的分水岭：Workspace 深度解析"
+type: source
+tags: [OpenClaw, Agent, Workspace, AGENTS.md, SOUL.md]
+date: 2026-03-21
+---
+
+## Source File
+- [[raw/Agent/万字讲透OpenClaw-Workspace深度解析-2026-03-21.md]]
+
+## Summary
+- 核心主题：OpenClaw workspace 文件体系深度解析
+- 问题域：AI Agent 个性化配置与长期记忆
+- 方法/机制：workspace 目录结构、各文件职责（AGENTS.md、SOUL.md、USER.md、IDENTITY.md、TOOLS.md、BOOTSTRAP.md、memory/）
+- 结论/价值：workspace 是让 Agent 从"能工作"变成"好用"的关键，通过固化用户偏好、Agent 性格和长期记忆实现个性化
+
+## Key Claims
+- workspace 是 OpenClaw 中决定 Agent 如何工作的核心文件体系
+- AGENTS.md 是岗位说明书，SOUL.md 是性格档案，两者分工明确不应混写
+- USER.md 作用是固化用户偏好，减少重复交代
+- TOOLS.md 规范工具使用，减少误操作
+- BOOTSTRAP.md 是一次性引导，完成初始化后应删除
+- memory/ 目录是 Agent 的长期记忆机制
+
+## Key Quotes
+> "workspace 是 Agent 的'工作台'（决定怎么工作），agentDir 是 openclaw.json 里的一个配置字段（指向存放运行状态的目录），sessions 是'工作日志'（记对话历史）。三者职责不同，不要混为一谈。"
+> "一个没有 SOUL.md 的 Agent，每次对话都像第一次见面——它不记得自己是谁，说话没有固定风格，遇到同样的问题今天这么说、明天那么说。"
+> "300-500 字的 AGENTS.md，比 2000 字的更有效。"
+> "SOUL.md 是新来的助理的个人简历，USER.md 是 HR 给这位助理写的'关于你的上司，你需要提前知道的事'。"
+
+## Key Concepts
+- [[Workspace]]：OpenClaw 中 Agent 的工作台目录，包含行为规则、性格设定、用户偏好等配置文件
+- [[AGENTS.md]]：Agent 的行为规则与多 Agent 协调文件，相当于岗位说明书
+- [[SOUL.md]]：Agent 的叙事性格设定文件，相当于人物小传
+- [[USER.md]]：用户画像与偏好固化文件
+- [[IDENTITY.md]]：Agent 的结构化身份元数据
+- [[TOOLS.md]]：工具权限声明与使用规范
+- [[BOOTSTRAP.md]]：首次启动引导文件，一次性使用后应删除
+- [[Memory 目录]]：Agent 的长期记忆机制，按日期滚动存储
+
+## Key Entities
+- [[OpenClaw]]：AI Agent 管理工具，支持 workspace 个性化配置
+- [[DracoVibeCoding]]：本文作者，公众号「Draco正在VibeCoding」
+
+## Connections
+- [[OpenClaw]] ← contains ← [[Workspace]]
+- [[Workspace]] ← manages ← [[AGENTS.md]]
+- [[Workspace]] ← manages ← [[SOUL.md]]
+- [[Workspace]] ← manages ← [[USER.md]]
+- [[SOUL.md]] ← complements ← [[IDENTITY.md]]
+- [[BOOTSTRAP.md]] ← initializes ← [[IDENTITY.md]], [[USER.md]], [[SOUL.md]]
+
+## Contradictions
+- （暂无）