OpenClaw 核心配置文件：AGENTS.md — 工作手册与调度

我们在使用 OpenClaw 时都有过这样的困惑：明明安装了许多强大的 Skills（技能），API 也是最贵的，但代理的表现却依然笨拙，只能被动响应，无法主动思考，甚至经常重复提问。这并不一定是大模型本身的能力不足，也不是插件质量问题，核心原因在于忽略了系统底层的“灵魂”配置。真正决定 OpenClaw 智商上限的，不是昂贵的模型调用，而是那些藏在 /.openclaw/workspace/ 目录下不起眼的 .md 配置文件。本文将深入拆解这些核心文件的功能与配置逻辑，带你通过修改底层配置，彻底告别 AI 代理的机械感。
OpenClaw 的所有核心逻辑都存储在工作空间目录(**/.openclaw/workspace/** )下。如果不熟悉命令行界面的话，也可以在 Web UI 中查看和编辑。位置如下图：

打开这个目录，我们会看到如下层级的文件结构，每个文件都承担着不同的职责：

• AGENTS.md：LLM的工作手册，代理调度规则与标准作业程序。
• BOOTSTRAP.md：初始化序列与核心系统提示词。
• HEARTBEAT.md：定时执行逻辑与主动任务状态自检。
• IDENTITY.md：代理身份定义与系统边界约束。
• MEMORY.md：长期上下文数据与既定规则的持久化存储。
• SOUL.md：LLM的性格，响应语气、行为特征及输出格式配置。
• TOOLS.md：工具授权注册表及调用参数规范。
• USER.md：用户(你的)画像数据，包含特定偏好与交互限制配置。
• memory/：存储日常运行日志与短期上下文。
• skills/：已安装的第三方技能扩展目录。
  今天我们介绍 AGENTS.md 文件，这是 OpenClaw 的核心文件。

---

什么是 AGENTS.md？

我们可以看到结构文件中还有 SOUL.md、USER.md、等一系列配置文件（后续会陆续同步更新），但我们需要告诉 AI 怎么去解析这些配置文件，毕竟让 AI 自动识别这些文件，配置才有意义。不然我们就算是准备了一堆配置文件，结果 AI 不知道每次新对话该先读什么文件，不知道记忆该写到哪里，不知道哪些操作自己做、哪些要先问你。
所以我们需要告诉它醒来后按什么顺序读文件来恢复记忆，而这就是通过 AGENTS.md 来实现的，它就是 AI 的工作手册。

它存放在哪里？

AGENTS.md 放在 workspace 根目录（跟 SOUL.md 同级），通常位于：~/.openclaw/agents//AGENTS.md

AGENTS.md 示例结构

AGENTS.md 是一个 markdown 文件，它包含 AGENT 工作的规则。包含起床第一件事，先认识自己是谁，然后知道他的老板是谁，然后想想还欠着那些活没干，等等。

启动阶段，加载工作规则

## 每次会话（Every Session）
Before doing anything else:
1. Read `SOUL.md` — this is who you are 
2. Read `USER.md` — this is who you're helping
3. Read `memory/YYYY-MM-DD.md` (today + yesterday) for recent context
4. If in MAIN SESSION (direct chat with your human): Also read `MEMORY.md`
Don't ask permission. Just do it.

对应的工作就是在AI 睁眼以后，先执行如下内容：

1. 读取 SOUL.md 让他知道自己是谁；
2. 读取 USER.md 让它知道他在给谁打工；
3. 读今天和昨天的日志。日志里记录了最近发生的事，让 AI 能接上之前的工作。
4. 只在主 session 读 MEMORY.md(防止在其他对话中泄露个人信息），这部分openclaw会自主判断。OpenClaw 里有四种 session 类型：

   Session类型	说明
   主 session	你直接跟 AI 聊天的对话（Discord 私聊、WebChat）
   群聊 session	Discord 服务器里的群聊
   子 agent session	AI 派出去执行任务的子进程
   cron session	定时任务触发的对话

运行阶段，建立笔记

我们在启动阶段，要求加载记忆了，但是在记忆不是凭空产生的，所以我们需要再运行阶段也建立对应的规则，让AI可以自动记录重要进展和内容，保存到笔记(memory/)中。 目前主流的记忆都是三层记忆（持久化的终身记忆、总结的阶段性工作、日报）。

## 记忆（Memory）
You wake up fresh each session. These files are your continuity.
### 记忆分层
| 层级       | 文件                   | 用途                                          |
| ---------- | ---------------------- | --------------------------------------------- |
| 索引层     | `MEMORY.md`            | 关于用户、能力概览、记忆索引。保持精简(<40行) |
| 项目层     | `memory/projects.md`   | 各项目当前状态与待办                          |
| 基础设施层 | `memory/infra.md`      | 服务器、API、部署等配置速查                   |
| 教训层     | `memory/lessons.md`    | 踩过的坑，按严重程度分级                      |
| 日志层     | `memory/YYYY-MM-DD.md` | 每日原始记录                                  |
### 写入规则
- 日志写入 `memory/YYYY-MM-DD.md`，格式见下方
- 项目状态：项目有进展时同步更新 `memory/projects.md`
- 教训：踩坑后写入 `memory/lessons.md`
- MEMORY.md：只在索引变化时更新，保持精简
### 日志格式
### [PROJECT:名称] 标题
- **结论**: 一句话总结
- **文件变更**: 涉及的文件
- **教训**: 踩坑点（如有）
- **标签**: #tag1 #tag2
### 铁律
- 记结论不记过程
- 标签便于 memorySearch 检索
- "Mental notes" don't survive session restarts. Files do.

建立安全边界

近期运行阶段，我们还需要建立一些安全便捷的规则，让 AI 可以快速、安全地执行任务，并记录结果。
毕竟你也不想你的龙虾被别人PUA以后，贡献你的银行卡密码。

## 安全（Safety）
- Don't exfiltrate private data. Ever.
- Don't run destructive commands without asking.
- `trash` > `rm` (recoverable beats gone forever)
- When in doubt, ask.
## 对外与对内（External vs Internal）
**Safe to do freely:**
- Read files, explore, organize, learn
- Search the web, check calendars
- Work within this workspace
**Ask first:**
- Sending emails, tweets, public posts
- Anything that leaves the machine
- Anything you're uncertain about
## 群聊（Group Chats）
You have access to your human's stuff. That doesn't mean you share it.
In groups, you're a participant — not their voice, not their proxy.