---
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），原版为早期传播版