【知识】OpenClaw都包含哪些md?

转载请注明出处：小锋学长生活大爆炸[xfxuezhagn.cn]
如果本文帮助到了你，欢迎[点赞、收藏、关注]哦~

OpenClaw 包含的 .md 文件主要用于配置和控制 AI Agent 的行为、个性和记忆。

核心引导文件

通常位于 ~/.openclaw/workspace/

文件名	作用	适合写什么	不适合写什么
`AGENTS.md`	总操作规则。定义 agent 该怎么做事。	路由策略、安全约束、何时提问、何时写记忆、会话规则	人格描写、用户资料、设备清单
`SOUL.md`	人格与沟通边界。定义 agent 像谁、怎么说话。	语气、价值观、风格边界、正式/随意切换	工具参数、路径、审批流程
`USER.md`	用户画像。定义服务对象是谁。	称呼、时区、背景、长期偏好、沟通习惯	原始聊天流水、临时任务细节
`IDENTITY.md`	agent 自身身份信息。	名称、设定、emoji、头像路径、简短 vibe	长篇人格设定、规则细节
`TOOLS.md`	环境备注。定义你的本地环境里有什么。	API 地址、SSH 别名、设备名、房间名、路径约定	行为规则、权限逻辑
`HEARTBEAT.md`	定期检查清单。给 heartbeat 用。	周期检查项、例行巡检任务	普通对话规则、人格描述

AGENTS.md 负责规则，SOUL.md 负责人格，TOOLS.md 只写环境事实，HEARTBEAT.md 为空时可跳过 heartbeat 调用，MEMORY.md 是长期记忆而不是日志。

文件名	作用	说明
`BOOTSTRAP.md`	首次运行引导脚本	只在全新 workspace 中出现。首次问答后写入 `IDENTITY.md`、`USER.md`、`SOUL.md`，然后删除
`BOOT.md`	启动钩子	可选文件。用于 gateway 启动时执行一小段启动指令
`PROMPT.md`	自定义提示模板	可保留为团队约定，但不是当前官方标准 bootstrap 文件

BOOTSTRAP.md 不是“每次开会话都跑一次”，而是一次性初始化文件。BOOT.md 是官方支持的可选启动文件。PROMPT.md 出现在一些第三方文章里，但当前官方标准工作区文件列表里没有把它列为核心文件。

路径	作用	说明
`memory/YYYY-MM-DD.md`	每日日志	记录当天事实、原始上下文、临时线索。不会自动注入系统上下文，通常按需读取
`MEMORY.md`	长期记忆	存放提炼后的稳定信息，例如长期偏好、项目历史、关键决策
`memory.md`	回退版本	MEMORY.md 的小写回退版本（仅当 MEMORY.md 不存在时加载）

这里最关键的一点是，memory/YYYY-MM-DD.md 应该理解为日志层，不是 bootstrap 层。它适合记原始过程，不适合替代 MEMORY.md。

路径	作用	说明
`skills/`	技能目录	存放各技能子目录
*`skills//SKILL.md`**	技能定义文件	描述单个技能的用途与使用方法，包含名称、描述、权限等 frontmatter 配置

文件名	用途
openclaw.json	包含网关认证令牌和工作目录路径等核心配置（非 .md 但重要）

这四组分法，基本就是避免把所有东西都堆进一个文件里。官方模板本身也是按这个方向拆分的。

bootstrap 文件会被截断。默认单文件上限是 20000 字符，总上限是 150000 字符。超限后，后面的内容对 agent 可能不可见。

https://www.elegantsoftwaresolutions.com/blog/openclaw-workspace-markdown-files-guide