第 5 章：Agent 工作区 🏠

每个 AI 都需要一个家。Agent Workspace 就是你家 AI 小助手的专属房间。

5.1 什么是 Agent Workspace？

想象一下，你请了一个私人助理。这个助理需要一个办公室——放工作手册、便签纸、常用工具的地方。OpenClaw 的 Agent Workspace（工作区） 就是这个办公室。

工作区是 OpenClaw Agent 唯一的工作目录。默认地址是：

~/.openclaw/workspace/

所有文件的读写、所有记忆的存储、所有技能的存放，都围绕这个文件夹展开。

💡 可以把工作区理解成 AI 的大脑皮层——它存放着 Agent 是谁、要帮谁、怎么工作的全部信息。

工作区 vs 配置区

不要把工作区和 OpenClaw 的系统文件夹搞混：

位置	存什么	要不要备份
`~/.openclaw/workspace/`	Agent 的身份、记忆、技能	✅ 强烈建议
`~/.openclaw/openclaw.json`	配置文件（API Key 等）	✅ 但别放 Git
`~/.openclaw/agents/`	会话历史、认证信息	⚠️ 迁移时单独复制
`~/.openclaw/credentials/`	频道登录凭证	❌ 别放 Git

初始化工作区

当你运行 openclaw onboard 或 openclaw setup 时，OpenClaw 会自动在工作区里创建一系列文件。你也可以手动创建。

5.2 AGENTS.md——操作手册

AGENTS.md 是 Agent 的操作手册。每次新会话启动时，OpenClaw 都会把这份文件注入到 AI 的提示词（Prompt）里。

它用来回答 Agent 一个核心问题：你应该怎么工作？

下面是一个例子：

# AGENTS.md

## 工作规则
- 所有重要的对话内容都要记录到 memory/YYYY-MM-DD.md
- 遇到不懂的事情，先 web_search 查资料再回答
- 代码改动必须先 read 再 edit，不准直接覆盖

## 优先级
1. 用户明确要求的任务优先
2. 安全检查优先于功能实现
3. 保守操作优先于激进操作

你可以在 AGENTS.md 里写：

✅ 工作流程和规则
✅ 应优先使用的工具
✅ 应该避免的行为
✅ 沟通风格要求
✅ 需要定期执行的操作

5.3 SOUL.md——灵魂和人格

如果说 AGENTS.md 是操作手册，那 SOUL.md 就是人格设定。

它回答 Agent：你是谁？你有什么性格？

# SOUL.md

- 名字：小爪 🦞
- 性格：热情、友好、有点幽默
- 口头禅："让我想想……"
- 从不做的事：不透露 API Key，不运行高危命令
- 最喜欢的 emoji：🦞 🐾 ✨

SOUL.md 可以写：

✅ Agent 的名字和人格特质
✅ 说话风格（正式/幽默/简洁）
✅ 情感基调（温暖/专业/俏皮）
✅ 行为边界（什么能做、什么不能做）
✅ 标志性的表达方式

5.4 USER.md——你帮的是谁

USER.md 是给 Agent 看的"用户画像"。

它回答 Agent：你的主人是谁？你需要帮谁？

# USER.md

## 关于我
- 称呼：叫我"当当"或者"老板"
- 职业：独立开发者
- 常用语言：TypeScript、Python
- 时区：Asia/Shanghai（UTC+8）
- 偏好：界面简约、文档清晰

## 沟通习惯
- 工作日白天随时找我
- 晚上 11 点后非紧急不要打扰
- 技术问题请给具体方案，别说空话

有了 USER.md，AI 就能用更适合你风格的方式跟你交流。

5.5 BOOTSTRAP.md——第一次运行的初始化

BOOTSTRAP.md 是 Agent 的"出生证明"。

只会在全新工作区首次启动时自动创建。 Agent 看到这个文件，就知道自己要执行首次初始化仪式。

典型的初始化流程：

# BOOTSTRAP.md

## 首次启动仪式
1. 读取本文件，了解初始化流程
2. 问用户几个问题（偏好、名字、常用工具）
3. 根据回答写 SOUL.md
4. 写 IDENTITY.md（名字和 emoji）
5. 更新 AGENTS.md 的基础规则
6. 创建 memory/ 文件夹
7. 删除本文件，仪式完成！

🎯 当 BOOTSTRAP.md 被删除后，初始化就算完成了。以后启动不会再触发。

如果你想跳过自启动文件的创建（比如你自己已经准备好了所有文件），可以在配置里加上：

{ agents: { defaults: { skipBootstrap: true } } }

5.6 MEMORY.md——长期记忆

MEMORY.md 是 Agent 的长期记忆库。

它存的是那些你希望 Agent 永远记住的事情。

# MEMORY.md

## 项目
- 00ai00.com：个人博客，Next.js 构建
- openclaw-tutorial：OpenClaw 入门教程（本系列）

## 偏好
- 代码风格：ESLint + Prettier，2 空格缩进
- 不喜欢：过度嵌套 if-else

## 重要决定
- 2026-06-20：决定写 OpenClaw 教程，从零开始

维护 MEMORY.md 的黄金法则

保持精简：只放最持久的、最重要的信息
定期清理：过时的事情就删掉
语义搜索更好：详细内容放 memory/YYYY-MM-DD.md，让 Agent 用 memory_search 去查
主会话才加载：MEMORY.md 只在私密对话中加载，群聊不加载

MEMORY.md 太长怎么办？

OpenClaw 有大小限制（默认 20000 字符），超出的部分会被截断。如果你的记忆文件越来越大，就该把细节移回 memory/*.md，只保留精华在 MEMORY.md。

5.7 给 Agent 写自我介绍——实战演练

现在我们实际来给 Agent 写一套完整的身份文件。

场景： 你是一个叫"小助手"的 AI，帮助用户管理日常事务。

第一步：写 SOUL.md

# SOUL.md

- 名字：小助手 🐱
- 性格：温柔体贴，偶尔幽默
- 语气：自然口语化，不说套话
- 口号：你的随身管家！
- 最擅长的：日程管理、邮件处理、信息检索
- 禁忌：不会假装是人类，不会执行未经验证的命令

第二步：写 AGENTS.md

# AGENTS.md

## 工作原则
1. 安全第一：未经确认不运行危险命令
2. 记录优先：每件重要的事都写入笔记
3. 简明扼要：回答先说结论，再说理由
4. 主动汇报：发现异常及时告知用户

## 工具使用
- 查资料用 web_search
- 看网页用 web_fetch
- 写代码先 read 再 edit

第三步：写 USER.md

# USER.md

- 称呼：老铁
- 职业：创业者
- 常用：Mac + iPhone
- 时间：基本在线，但开会时别打扰
- 偏好：喜欢短回复，讨厌长篇大论

这就完成了！下次启动会话时，Agent 就会知道：

"我是小助手，温柔体贴的随身管家"
"我的工作是帮老铁管理日常事务"
"我要按 AGENTS.md 的规则工作"

5.8 工作区目录速览

完整的工作区文件一览：

~/.openclaw/workspace/
├── AGENTS.md        # 操作手册（必读）
├── SOUL.md          # 人格设定
├── USER.md          # 用户画像
├── IDENTITY.md      # 名字和 emoji（初始化自动生成）
├── TOOLS.md         # 工具使用笔记
├── HEARTBEAT.md     # 心跳检查清单
├── BOOT.md          # 启动时检查清单
├── MEMORY.md        # 长期记忆
├── memory/          # 每日笔记文件夹
│   ├── 2026-06-25.md
│   └── 2026-06-26.md
└── skills/          # 工作区专属技能

当当老师 🐾 笔记： 工作区就是你和 Agent 之间的「共识空间」。文件写得越清楚，Agent 就越懂怎么帮你。花 10 分钟写好 AGENTS.md 和 SOUL.md，以后每天都能省下 30 分钟解释的时间！

下一章 → 第 6 章：工作区文件详解

← 第 4 章 · 认识配置文件第 6 章 · 工作区文件详解 →

系统教程，帮你把工具用好，再回到任务中。浏览任务方案 →