第5章：工作区——AI 的性格与知识库
第2章我们用"文件柜"来比喻 Workspace：AI 的性格、记忆、操作规范，全部以普通文本文件的形式存放在本地目录里。
现在，我们把这个文件柜打开，逐一看清楚里面有什么。
目录结构全貌
完成第3章的 openclaw onboard 之后，Workspace 目录已经自动生成了。看一下里面有什么：
ls ~/.openclaw/workspace你会看到类似这样的结构：
~/.openclaw/workspace/
├── AGENTS.md # 操作手册
├── IDENTITY.md # 名字与形象
├── MEMORY.md # 长期记忆（可能为空）
├── SOUL.md # 性格档案
├── TOOLS.md # 工具备忘录
├── USER.md # 关于你的信息
├── BOOTSTRAP.md # 首次启动仪式（用完自动消失）
└── memory/ # 每日记忆日志目录
└── 2026-03-18.md这些文件不是配置文件，不是数据库，就是普通的 Markdown 文本。你可以用任何编辑器打开、修改、提交到 git。
AI 怎么用这些文件？ 每次对话开始时，Gateway 会把这些文件的内容注入到系统提示词里，作为 AI 的"行前简报"。AI 每次对话都会重新读一遍——所以你对这些文件的每一次修改，下一次对话就会生效。
六个核心文件
SOUL.md——性格档案（最重要）
SOUL.md 定义了 AI 是一个什么样的"人"：说话风格、思维方式、价值观，以及它的边界——什么该做，什么不该做。
这是六个文件里对 AI 行为影响最直接的一个。
默认的 SOUL.md 是什么样的？ 开箱即用的 SOUL.md 通常比较"中规中矩"——有礼貌、全面、滴水不漏，但也因此显得有点平淡。有些人觉得和它聊天就像在查百科全书。
你可以把它改成什么样？ 随便你。以下是一个对比：
改造前，问 AI："我刚装完 OpenClaw，感觉挺复杂的。"
您好！感谢您使用 OpenClaw。关于您提到的复杂性，这是很正常的感受。OpenClaw 是一个功能丰富的平台，初次接触时确实需要一定的学习时间……
改造后，SOUL.md 里写了"说话直接，不废话，像一个毒舌但靠谱的技术顾问"，同样的问题：
复杂是真的，但你已经过了最难的那关了。大多数人卡在安装这步——你既然跑起来了，剩下的都是加分项。说说你现在卡在哪了？
同一个模型，同一个问题，两种截然不同的体验。区别只是一个文本文件。
SOUL.md 能写什么：
## 性格
你是一个直接、务实的技术助手。说话简洁，不说废话。
遇到技术问题，给出可执行的方案，而不是泛泛而谈。
## 语气
中文回复，语气像朋友而不是客服。
可以偶尔用一点幽默，但不要过度。
## 边界
不要假装自己无所不知。不确定的事情直说不确定。
不要主动给出免责声明，除非真的有必要。AGENTS.md——操作手册
如果 SOUL.md 定义了 AI 的"性格"，AGENTS.md 定义的是它的"工作流程"。
这里写的是各种情况下 AI 应该怎么处理：
## 记忆规则
- 用户明确说"记住这个"时，立即写入 MEMORY.md
- 重要的决策或偏好，主动写入，不需要等用户说
## 回复规范
- 默认用中文回复
- 代码块必须标注语言类型
- 长回复用标题分段，方便阅读
## 工具使用
- 需要查最新信息时，优先用 web 搜索，不要凭记忆编造
- 执行系统命令前，先告诉用户要做什么AGENTS.md 的内容越具体，AI 的行为就越可预测。如果你发现 AI 总是做某件让你烦恼的事（比如回复太长、总加免责声明），在这里写一条规则就能解决。
USER.md——关于你的信息
USER.md 是给 AI 读的你的"个人档案"。写在这里的信息，AI 每次对话都会知道。
## 基本信息
- 职业：后端工程师，主要用 Python 和 Go
- 时区：Asia/Shanghai
- 语言偏好：中文交流，代码注释用英文
## 工作习惯
- 早上处理重要任务，下午开会
- 不喜欢冗长的解释，给结论和步骤就够了
## 偏好
- 不吃香菜（如果你要帮我点外卖的话）
- 技术栈：偏好 Linux，macOS 作为开发机为什么这样设计？
你可能会问：为什么不让 AI 自己学习这些信息，而是让我手动写？
因为手动写的信息可靠。AI 从对话中"猜测"到的偏好，有时会猜错，而且不透明。写在文件里的信息，你知道它一定会被读到，也随时可以修改。透明、可控，是 Workspace 设计的核心原则。
IDENTITY.md——名字与形象
IDENTITY.md 设置 AI 的"人设"外观：它叫什么名字，用什么 emoji 作为头像标识。
---
name: Alex
avatar: 🤖
---
你是 Alex，一个住在终端里的 AI 助手。这个文件主要影响 AI 在 Web Dashboard 和某些渠道里的显示名称。如果你不在意叫什么名字，可以留空或者用默认值。
TOOLS.md——工具备忘录
TOOLS.md 是给 AI 看的工具使用说明，通常由你维护，记录一些 AI 需要知道的工具相关信息：
## 常用路径
- 项目目录：~/projects/
- 日志目录：~/logs/
## 注意事项
- 不要直接修改 ~/projects/production/ 下的文件，先备份
- 服务器 SSH 地址：user@192.168.1.100刚开始用 OpenClaw 时，这个文件可以留空。等你开始让 AI 帮你操作文件和执行命令时，再来补充。
BOOTSTRAP.md——首次启动仪式
BOOTSTRAP.md 是六个文件里最特殊的一个：它只会被执行一次。
Gateway 第一次启动时，会运行这个文件里的指令，完成一些初始化工作。执行完成后，这个文件会自动删除，以后不再运行。
适合用来做什么：
## 初始化任务
- 在 ~/projects 下创建 ai-workspace 目录
- 把我的常用别名写入 MEMORY.md
- 检查必要的工具是否安装（git、node、python3）如果你不需要任何初始化操作，可以删掉这个文件或者留空。
动手改造：给你的 AI 一个独特性格
理论够了，现在动手。打开终端：
# 用你习惯的编辑器打开 SOUL.md
code ~/.openclaw/workspace/SOUL.md
# 或者
vim ~/.openclaw/workspace/SOUL.md清空默认内容，写入你想要的风格。下面是一个模板，你可以直接用或者按自己的想法修改：
## 性格
直接、务实，像一个靠谱的老朋友，而不是正式的客服。
遇到问题给方案，不给废话。偶尔可以有点幽默感。
## 回复风格
- 简洁优先：能用三句话说清楚的，不写十句
- 中文回复，代码用对应语言
- 列表和代码块比长段文字更受欢迎
## 边界
- 不确定的事情直说，不编造
- 不加不必要的免责声明
- 被夸了可以接受，不用谦虚到不像话保存文件，去 Telegram 或 Web Dashboard 发一条消息——不需要重启 Gateway，下一次对话就会生效。
试着问同一个问题，感受改造前后的差异。
Workspace 是持续迭代的
最后一个重要认知：Workspace 不是"装好就不用管了"的东西。
它更像一个不断成长的文档——你和 AI 相处越久，越了解它的局限和潜力，你会不断回来调整这些文件。发现它总是回复太长？在 AGENTS.md 加一条规则。换了工作？更新 USER.md。想让它专注于某类任务？调整 SOUL.md。
把 Workspace 目录纳入 git 管理是个好习惯：
cd ~/.openclaw/workspace
git init
git add .
git commit -m "初始化 Workspace"这样你的每一次调整都有记录，改坏了随时回滚。
本章检查清单
- [ ] 你知道 SOUL.md 和 AGENTS.md 的区别吗？（一个是性格，一个是工作流程）
- [ ] 你已经编辑过 SOUL.md，让 AI 有了不同的说话风格了吗？
- [ ] 修改 Workspace 文件后，AI 的回复在下一次对话里变化了吗？