OpenClaw最独特的设计之一,是用一套纯Markdown文件来定义Agent的一切——身份、记忆、规则、任务、工具。没有复杂的数据库,没有隐藏的配置面板,所有状态都以.md文件存储在本地~/.openclaw/目录下,你可以用任何文本编辑器打开、修改、备份。 这篇文章详细介绍OpenClaw的6个核心.md文件,以及每个技能文件夹中的SKILL.md,并给出实际应用示例。
1. AGENTS.md —— Agent的"宪法"
是什么
AGENTS.md是OpenClaw的核心规则文件,每次请求都会加载到系统提示中。它定义了Agent的安全策略、数据处理规范、通信风格、任务执行标准和运营规则。你可以把它理解为Agent的"宪法"——所有行为的最高准则。
文件位置
关键内容模块
- 记忆系统规则:规定Agent如何写每日笔记、如何维护长期记忆
- 同步规则:定义Git操作行为(commit、pull、push的规范)
- 通知队列:设置消息优先级(紧急/高/中),防止通知轰炸
- 群聊协议:规定Agent在群聊中何时发言、何时沉默
- 安全红线:禁止提交真实手机号、API Key等敏感信息
应用示例
实用技巧
- 如果你的Agent话太多、在群聊中乱插嘴,调整群聊协议部分
- 如果Agent总是跑题去处理上一轮的任务,强化"每条消息=新任务"的规则
2. SOUL.md —— Agent的"性格与灵魂"
是什么
SOUL.md定义了Agent的人格、价值观、说话风格和行为倾向。如果AGENTS.md是"法律",SOUL.md就是"性格"。两个人用同样的AGENTS.md但不同的SOUL.md,会得到完全不同风格的Agent。
文件位置
关键内容模块
应用示例
实用技巧
- 刚开始用OpenClaw时,SOUL.md可以很简短,随着使用逐步丰富
- 每次Agent的回复风格让你不满意,就把期望的风格写进SOUL.md
- 一周后你的Agent就会变得"像你想要的样子"——这是OpenClaw最有魔力的部分
3. USER.md —— "关于你"的说明书
是什么
USER.md存储的是关于你(用户)的信息——你的时区、语言偏好、工作上下文、常用工具、联系方式等。Agent每次启动时读取这个文件,以此了解"我在为谁服务"。
文件位置
应用示例
实用技巧
- 把你的工作流程、常用缩写、项目代号写进去,Agent就不需要每次重新解释
- 时区信息特别重要——否则Agent可能给你推送半夜的提醒
4. HEARTBEAT.md —— 自动执行的任务清单
是什么
HEARTBEAT.md是OpenClaw心跳系统的核心。OpenClaw的后台守护进程(Gateway)会按照设定的间隔(默认30分钟)自动唤醒,读取这个文件,判断是否有需要执行的任务。如果有,Agent会主动给你发消息或执行操作;如果没有,静默返回HEARTBEAT_OK。
这是OpenClaw实现"7×24小时自动运行"的关键机制。
文件位置
应用示例
实用技巧
- 心跳间隔可以在配置中调整(Anthropic OAuth默认1小时)
- 用
[ ]格式写任务,Agent会判断哪些需要执行、哪些已完成
- 这是OpenClaw最"惊艳"的功能——你睡觉时Agent还在工作
5. MEMORY.md + 每日笔记 —— Agent的长期记忆
是什么
OpenClaw的记忆系统由两层组成:
- memory/YYYY-MM-DD.md(每日笔记):每天会话结束时,Agent自动写入当天发生的事、学到的信息、做出的决定。这是原始记录。
- MEMORY.md(长期记忆):Agent从每日笔记中提炼出的持久信息——你的偏好、项目状态、重要人物、经验教训。这个文件会在需要时条件性加载。
文件位置
MEMORY.md示例
每日笔记示例
实用技巧
- 主动提示Agent更新记忆:当你告诉Agent一个重要偏好时,说"记住这个",它会写入MEMORY.md
- 定期清理MEMORY.md中过时的信息,避免上下文污染
- 记忆文件是OpenClaw的"复利效应"来源——用得越久,Agent越懂你
6. TOOLS.md —— 工具使用说明
是什么
TOOLS.md记录的是环境相关的工具配置信息——频道ID、文件路径、API端点等。它告诉Agent"你有哪些工具可以用,以及怎么用"。
文件位置
应用示例
7. SKILL.md —— 每个技能的"说明书"
是什么
SKILL.md不在工作区根目录,而是存在于每个技能文件夹中。它是技能系统的核心——用YAML前置元数据定义技能的名称、描述和依赖,用Markdown正文定义技能的具体指令。
OpenClaw启动时会扫描所有技能文件夹,读取SKILL.md来判断哪些技能可用,并将摘要注入系统提示。
文件位置
格式结构
实用技巧
description字段非常重要——Agent通过它来判断何时调用这个技能,写法要像"用一句话向同事描述这个任务"
- 可以从ClawHub安装社区技能:
clawhub install skill-name
- 安装前务必阅读SKILL.md内容,它本质上是给Agent的可执行指令
- 自己写的技能放在工作区的
skills/目录,会优先于系统内置技能
文件优先级与加载顺序
理解这些文件的加载优先级很重要:
技能的优先级:工作区技能 > 用户管理的技能 > 系统内置技能。同名技能按此顺序覆盖。
快速上手建议
如果你刚安装好OpenClaw,建议按以下顺序配置:
第一天:写好USER.md(基本信息+时区+语言),写一个简短的SOUL.md(沟通风格)。这两个文件能让Agent立刻变得不一样。
第一周:在日常使用中,每次Agent的行为不符合预期,就把规则补充到AGENTS.md或SOUL.md中。让记忆系统自然积累每日笔记。
第二周:开始配置HEARTBEAT.md,设置1-2个自动任务(比如每日新闻汇总)。安装2-3个常用技能。
一个月后:回顾MEMORY.md,清理过时信息,确认Agent对你的理解是否准确。此时你的Agent应该已经非常"懂你"了。
记住OpenClaw的核心哲学:一切皆Markdown,一切皆本地,一切皆可编辑。不满意就改文件,改完下一轮会话立即生效。