Auto-sync: wiki-ingest 3 sources (2026-04-16)

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

@@ -0,0 +1,52 @@
+---
+title: "万字讲透OpenClaw Workspace深度解析（2026-03-21版）"
+type: source
+tags: [OpenClaw, Workspace, Agent, AGENTS.md, SOUL.md, IDENTITY.md]
+date: 2026-03-21
+---
+
+## Source File
+- [[raw/Agent/万字讲透OpenClaw-Workspace深度解析-2026-03-21.md]]
+
+## Summary
+- 核心主题：OpenClaw workspace 7 大核心文件体系的深度解析与最佳实践
+- 问题域：为什么有些 Agent 每次像重新 onboarding，有些 Agent 却记得一切
+- 方法/机制：workspace 文件体系（AGENTS.md/SOUL.md/USER.md/IDENTITY.md/TOOLS.md/BOOTSTRAP.md/memory/）各司其职
+- 结论/价值：这套文件配合好了，Agent 从"能工作"变成"好用了"，成为真正懂你、记得你、靠谱的长期搭档
+
+## Key Claims
+- AGENTS.md 是岗位说明书，SOUL.md 是性格档案，两者分工明确不应混写
+- AGENTS.md 最佳长度为 300-500 字，过长反而冲淡重点
+- SOUL.md 是叙事性角色设定（人物小传），IDENTITY.md 是结构化元数据（名片）
+- TOOLS.md 的核心价值是"什么时候不用"，而非"什么时候用"
+- BOOTSTRAP.md 是一次性引导，完成后必须删除
+- memory/ 是 Agent 真正的长期记忆，对 Agent 来说真正算数的是 Markdown 文件而非黑盒数据库
+- bootstrapMaxChars/boolstrapTotalMaxChars 长度限制会影响 session 启动时带进系统提示词的内容量
+
+## Key Quotes
+> "AGENTS.md 告诉你 Agent 该做什么、不该做什么；SOUL.md 定义 Agent 的性格，让它变得可预期"
+> "BOOTSTRAP.md 的使命是把一个全新的 workspace 引导到可正常使用的状态"
+> "对 Agent 来说，真正算数的长期记忆，是 workspace 里那些 Markdown 文件，不是什么看不见摸不着的黑盒数据库"
+
+## Key Concepts
+- [[Workspace]]：OpenClaw Agent 的工作台，决定 Agent 怎么工作
+- [[AGENTS.md]]：Agent 的岗位职责说明书（功能性）
+- [[SOUL.md]]：Agent 的性格档案（人格性）
+- [[USER.md]]：用户偏好固化，减少重复交代
+- [[IDENTITY.md]]：Agent 结构化身份元数据（名字/emoji/头像）
+- [[TOOLS.md]]：工具权限声明与使用规范，核心是"什么时候不用"
+- [[BOOTSTRAP.md]]：一次性初始化引导，完成后必须删除
+- [[memory/]]：Agent 的长期记忆目录，按日期滚动的 Markdown 文件
+- [[长期记忆]]：Agent 跨会话保留重要信息的能力
+
+## Key Entities
+- [[OpenClaw]]：整个 workspace 文件体系的承载平台
+- [[DracoVibeCoding]]：本文作者，微信公众号 Draco正在VibeCoding
+
+## Connections
+- [[Workspace]] ← contains ← [[AGENTS.md]] + [[SOUL.md]] + [[USER.md]] + [[IDENTITY.md]] + [[TOOLS.md]] + [[BOOTSTRAP.md]] + [[memory/]]
+- [[万字讲透OpenClaw-Workspace深度解析]] ← 早版（内容基本相同）
+- [[BOOTSTRAP.md]] → deleted after initialization → [[SOUL.md]] created
+
+## Contradictions
+- 与[[万字讲透OpenClaw-Workspace深度解析]]：本质同一篇文章的不同版本，此版本为公众号发布版（2026-03-21），原版为早期传播版