3.0 KiB
3.0 KiB
title, type, tags, date
| title | type | tags | date | ||||||
|---|---|---|---|---|---|---|---|---|---|
| 万字讲透OpenClaw Workspace深度解析（2026-03-21版） | source |
|
2026-03-21 |
Source File
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），原版为早期传播版