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

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

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

OpenClaw 的所有核心逻辑都存储在工作空间目录(~/.openclaw/workspace/ )下。如果不熟悉命令行界面的话，也可以在 WebUI界面查看和编辑。位置如下图：

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

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/<agent_id>/AGENTS.md

AGENTS.md是什么样的

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

启动阶段，加载工作规则

## Every SessionBefore doing anything else:1. Read `SOUL.md` — this is who you are 2. Read `USER.md` — this is who you're helping3. Read `memory/YYYY-MM-DD.md` (today + yesterday) for recent context4. If in MAIN SESSION (direct chat with your human): Also read `MEMORY.md`Don't ask permission. Just do it.

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

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

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

运行阶段，建立笔记

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

## MemoryYou 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 检索- "Mentalnotes" don'tsurvivesessionrestarts.Filesdo.

建立安全边界

近期运行阶段，我们还需要建立一些安全便捷的规则，让 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 ChatsYou 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.