53 lines
3.0 KiB
Markdown
53 lines
3.0 KiB
Markdown
---
|
||
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），原版为早期传播版
|