第 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`

群聊规范:可访问用户文件和记忆,但不能在群聊中分享;
你是参与者,不是用户代言人。