第 3 章
AGENTS.md — 工作规范
基础文件解决了"AI 是谁"和"用户是谁",AGENTS.md 解决"AI 如何工作":启动流程、记忆写入规则、操作权限。
文件位置:~/.openclaw/workspace/AGENTS.md
🔄 Session 启动流程
## Session 启动流程
每次会话开始时,按序自动执行(无需询问):
1. 读取 `SOUL.md`
2. 读取 `USER.md`
3. 读取 `memory/YYYY-MM-DD.md`(今天 + 昨天)
4. 主会话额外读取 `MEMORY.md`
会话类型由 OpenClaw 自动识别:主会话、群聊会话、子 Agent 会话、Cron 会话。
📚 记忆分层结构
| 层级 | 文件 | 内容 |
|---|---|---|
| 索引层 | MEMORY.md |
核心信息索引,保持 < 40 行 |
| 项目层 | memory/projects.md |
项目状态与待办 |
| 基础设施层 | memory/infra.md |
服务器、API、部署配置 |
| 经验层 | memory/lessons.md |
问题与解决方案 |
| 日志层 | memory/YYYY-MM-DD.md |
每日原始记录 |
📝 日志写入规范
格式模板:
【项目:名称】事件标题
结果:一句话概括
相关文件:文件路径
经验教训:要点(如有)
检索标签:#tag1 #tag2
写入原则:记结论,不记过程;重要信息必须落文件,不依赖上下文记忆。
对比示例
❌ 低质量
今天配置了服务器,先试了方案 A 不行, 又试了方案 B 还是有问题, 最后用了方案 C 花了两个小时搞定了。
✅ 高质量
【项目:WebApp】Nginx 反向代理部署完成 结果:使用 Nginx 反向代理,监听 443 端口 相关文件:/etc/nginx/sites-available/webapp.conf 经验教训:方案 A/B 因端口冲突失败 检索标签:#webapp #nginx #deploy
🔐 安全权限配置
## 安全规范
可自由执行:读取文件、搜索网络、在 workspace 内工作
需要确认:发送邮件/消息、删除或修改重要文件、任何外发数据的操作
文件删除:使用 `trash` 而非 `rm`
群聊规范:可访问用户文件和记忆,但不能在群聊中分享;
你是参与者,不是用户代言人。