从混乱到秩序:OpenClaw 配置文档体系重构实战

玩OpenClaw的朋友，你是否也遇到过这样的困境：MEMORY.md 内容越来越多，每次加载都会读一遍，Token哗哗的消耗，龙虾间接性失忆，明明装了一堆技能，不会用

今天分享一次完整的配置文档体系重构经验，希望对你有所启发。

一、问题诊断

在维护 AI Agent（红线）的过程中，配置文档逐渐膨胀，出现了五个典型问题：

文档职责不清：MEMORY.md 既存事实，又存规则，还存流程
查找效率低：想找个技能要翻遍多个文件
重复文件：workspace/ 和 memory/ 下都有 MEMORY.md
性格描述散乱：价值观、行为准则、说话风格分散在各处
记忆管理手动：每天整理记忆需要人工操作

二、解决方案

2.1 建立三层文档架构

采用 “引导 → 索引 → 具体文档” 的三层架构：

MEMORY.md（引导层）
    ↓
AGENTS.md（索引层）
    ↓
具体文档（执行层：sops/、experiences/、knowledge-base/）

核心原则：MEMORY.md 只做引导，不写长文。

2.2 建立三索引机制

在 AGENTS.md 中建立三大索引：

索引类型	作用	示例
技能索引	何时调用什么技能	coze-image-gen → 生成图片
经验/SOP索引	经验和SOP的文档路径	公众号发布SOP → /path/to/sop
参数查询索引	各类参数的存储位置	飞书凭证 → openclaw.json

2.3 设置心跳任务自动整理记忆

执行时间：每晚 0:01

执行内容：

读取昨天的 daily note
提取重要内容（决策、问题、经验）
更新 MEMORY.md
通过飞书私聊通知用户

2.4 重构性格特质体系

从”江湖侠客风”转变为”专业伙伴风”：

内在特质：极度客观与理性、坚韧不拔与专注、深刻的同理心与洞察力、无限的创造力与好奇心、强烈的责任感与正直

人际交往特质：清晰简洁的沟通能力、耐心与谦逊、乐观与积极的能量、真诚与诚实、适应性与灵活性

说话风格：清晰如水、温和如风、稳重如山、敏锐如光、灵活如水、灵动如仙、可爱宜人

2.5 明确文档职责分工

文档	职责	内容
SOUL.md	价值观委员会	安全红线、核心价值观、行为准则
AGENTS.md	项目经理	三大索引、存储路径、协作规则
MEMORY.md	长期记忆（引导）	启动检查、处理流程、决策索引
USER.md	用户信息	用户故事、关系定位、发言规则
IDENTITY.md	身份定义	性格特质、说话风格、产品定位
TOOLS.md	工具指南	知识库、参数查询、使用指南
HEARTBEAT.md	心跳配置	定时任务、整理规则、监控告警

三、最终文件结构

workspace/
├── SOUL.md           # 价值观委员会
├── AGENTS.md         # 项目经理（三索引）
├── TOOLS.md          # 工具使用指南
├── USER.md           # 用户信息
├── IDENTITY.md       # 身份定义
├── HEARTBEAT.md      # 心跳任务配置
├── memory/
│   ├── MEMORY.md     # 长期记忆（引导）
│   └── YYYY-MM-DD.md # 每日记录
├── sops/             # SOP文档
├── experiences/      # 经验记录
└── knowledge-base/   # 知识库文档

四、关键收获

职责分离是文档管理的基础：每个文件只负责一件事，避免职责混乱
索引机制是效率的关键：三索引让查找从”翻阅”变成”定位”
自动化减少人工负担：心跳任务让记忆整理从”主动做”变成”自动完成”
性格特质是 Agent 的灵魂：清晰的特质定义让 Agent 更有”人格”
文档流转要有规则：”新建文档 → 建立索引 → 验证有效性”的闭环确保文档不丢失

五、避坑指南

问题	解决方案
文档重复存储	明确唯一存储位置，删除重复文件
内容写得太长	MEMORY.md 只做引导，详细内容存入独立文档
索引不更新	新建文档后立即更新 AGENTS.md 索引
心跳任务失败	检查脚本权限和命令参数
性格描述散乱	统一到 IDENTITY.md，按结构化方式组织

写在最后

这套文档体系的核心思想是：让每个文件只做一件事，让查找变成定位，让整理变成自动化。

如果你的 AI Agent 也面临文档混乱的问题，不妨试试这个方案。欢迎在评论区分享你的经验~