OpenClaw 智能进阶指南：用底层配置文件重塑 AI 代理 - Agent配置

置顶 | 发表于 | 分类于

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

  • 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 仍然不知道怎么工作：不知道每次新对话该先读什么文件，不知道记忆该写到哪里，不知道哪些操作自己做、哪些要先问你。
因此我们需要告诉它醒来后按什么顺序读文件来恢复记忆，而这就是通过 AGENTS.md 来实现的，它就是 AI 的工作手册。

它存放在哪里？

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

AGENTS.md是什么样的

启动阶段，加载工作规则

1
2
3
4
5
6
7
## 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/)中。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
## 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 可以快速、安全地执行任务，并记录结果。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
## 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.
-------------本文结束感谢您的阅读-------------