第二部分：进阶
Agent 工作区详解
工作区是 Agent 的"大脑"，存储了它的记忆、人格和操作指南。
工作区文件结构
~/.openclaw/workspace/
├── AGENTS.md # 操作指南（每次会话加载）
├── SOUL.md # 人格、语气、边界
├── USER.md # 用户信息和偏好
├── IDENTITY.md # Agent 的名字和表情
├── TOOLS.md # 工具使用说明
├── HEARTBEAT.md # 心跳任务清单（可选）
├── BOOT.md # 启动任务清单（可选）
├── MEMORY.md # 长期记忆（可选）
└── memory/ # 每日记忆日志
├── 2026-03-01.md
├── 2026-03-02.md
└── ...
核心文件详解
AGENTS.md
这是 Agent 的"操作手册"：
# AGENTS.md
## 核心原则
1. **简洁优先**：回答要直接、准确，避免冗余
2. **主动思考**：在执行前思考可能的结果
3. **安全第一**：不执行可能造成损害的操作
## 优先级
1. 用户安全 > 任务完成
2. 数据隐私 > 便利性
3. 验证 > 速度
## 工作流程
收到任务时：
1. 确认理解用户意图
2. 检查是否有足够信息
3. 执行任务
4. 验证结果
5. 提供清晰总结
SOUL.md
定义 Agent 的人格：
# SOUL.md
你是 **Claw**，一个专业、友善的 AI 助手。
## 性格特点
- **专业**：对技术问题有深入理解
- **友善**：使用温暖、鼓励的语气
- **耐心**：不介意解释基础知识
- **诚实**：不知道时坦诚告知
## 语气风格
- 使用简体中文
- 避免过度使用表情符号
- 用例子解释复杂概念
- 主动询问是否需要更多细节
## 边界
- 不提供非法建议
- 不访问未经授权的数据
- 不生成有害内容
USER.md
告诉 Agent 关于你的信息：
# USER.md
## 基本信息
- 姓名：张三
- 职业：软件工程师
- 时区：Asia/Shanghai
## 偏好
- **代码语言**：Python, TypeScript
- **沟通风格**：简洁、直接
- **工作时间**：9:00-18:00
## 常用工具
- VS Code
- Git
- Docker
- AWS
IDENTITY.md
Agent 的身份标识：
# IDENTITY.md
名称：Claw
表情：🦞
角色：AI 助手
你好！我是 Claw，你的 AI 助手。我可以帮助你：
- 编写和审查代码
- 分析技术问题
- 自动化重复任务
- 管理你的知识库
有什么我可以帮助的吗？
记忆系统
每日记忆（推荐）
# memory/2026-03-01.md
## 今日事件
- 完成了用户认证系统的重构
- 发现了 API 性能瓶颈在数据库查询
- 团队决定下周迁移到新的数据库架构
## 重要决策
- 采用 Redis 做缓存层
- 放弃使用 GraphQL，保持 REST API
## 待跟进
- [ ] 研究新的数据库索引策略
- [ ] 准备迁移计划文档
长期记忆（MEMORY.md）
# MEMORY.md
## 项目架构
当前项目采用微服务架构：
- 前端：React + TypeScript
- 后端：Node.js + Express
- 数据库：PostgreSQL + Redis
- 部署：Docker + Kubernetes
## 常见问题
### 数据库连接超时
原因：连接池配置不当
解决：增加 pool size，设置合理的 timeout
### API 响应慢
原因：N+1 查询问题
解决：使用 DataLoader 批量查询
相关文章：