AGENTS.md - OpenClaw 的工作手册
AGENTS.md 是 AI Agent 的"工作手册"——告诉 Agent 这个工作区怎么用、规则是什么。
这个文件是做什么的?
每个 AI Agent 会话都是"失忆"的——它不记得上一轮对话。为了让 Agent 有连续的记忆和一致的行为,需要一套"规则文件"来定义:
我是谁 → SOUL.md / IDENTITY.md
用户是谁 → USER.md
工作规则 → AGENTS.md
就是这个文件
长期记忆 → MEMORY.md
每日记录 → memory/YYYY-MM-DD.md
AGENTS.md 告诉 Agent:每次醒来先读什么、文件怎么存、什么能做什么不能做、群聊怎么发言、心跳任务怎么执行…
AGENTS.md 包含哪些规则?
每日启动流程
每次新会话开始,Agent 必须:
读 SOUL.md — 知道自己是谁
读 USER.md — 知道用户是谁
读 memory/YYYY-MM-DD.md(今天+昨天)— 获取近期上下文
主会话还要读 MEMORY.md — 获取长期记忆
记忆管理
Agent 的记忆分为两类:
| 类型 | 文件 | 用途 |
|---|---|---|
| 每日笔记 | memory/YYYY-MM-DD.md | 原始日志,记录当天发生了什么 |
| 长期记忆 | MEMORY.md | 精华沉淀,重要决策和偏好 |
原则:Text > Brain —— 想记住的必须写进文件,“脑记"会随会话消失。
安全边界
自由做的事:
读文件、探索、整理
搜索网络、查日历
工作区内部操作
需要问的事:
发邮件、发推文、公开发布
任何离开机器的操作
不确定的事
群聊礼仪
Agent 在群聊中要"像人一样”:
该说话时:
被直接 @ 或提问
能提供真正的价值
有幽默/机智的话要说
该闭嘴时:
人类之间的闲聊
已经有人回答了
只能说"嗯嗯"或"好的"
插话会打断节奏
原则:参与,但不主导。质量 > 数量。
心跳任务(Heartbeat)
Agent 会定期被唤醒检查:
邮件 — 有紧急未读吗?
日历 — 接下来 24-48h 有会议吗?
社交 — 有新 @ 吗?
天气 — 用户要出门吗?
原则:有用但不烦人。一天检查几次,做有价值的后台工作,但尊重安静时间。
如何自定义?
AGENTS.md 是一个起点——用户可以根据自己的需求修改:
调整启动流程
添加特定的安全规则
定义自己的文件组织方式
设置心跳检查的频率和内容
核心理念
“Text > Brain” —— 文件比记忆可靠
AI Agent 每次会话都从零开始,唯一能延续的就是文件。AGENTS.md 是 Agent 的"宪法",确保行为一致、记忆连续、边界清晰。
一句话总结:AGENTS.md 让 AI Agent 知道"我是谁、为谁工作、怎么工作、什么能做什么不能做"。
相关文章: