OpenClaw 配置文件完整架构指南

文档版本： v1.0.0
创建日期： 2026-03-19
适用对象： 所有 Agent（大虾、二虾、三虾及未来所有 Agent）
维护人： 主人（DuSen）

📁 文档目的

本文档详细说明 OpenClaw 多 Agent 系统的配置文件架构，包括：

• ✅ 每个文件的用途和访问机制
• ✅ 文件维护责任分工
• ✅ 违规记录分层方案
• ✅ MEMORY.md 优化建议
• ✅ 后期建设方案

🗂️ 一、文件系统总览

1.1 目录结构

主工作空间（大虾）：

• GLOBAL_RULES.md - 全局红线规矩
• MEMORY.md - 长期记忆（核心规矩）
• AGENTS.md - 工作指南
• SESSION-STATE.md - 活跃任务状态
• memory/ - 记忆目录
• daxiaoutput/ - 临时输出
• articles/ - 正式文章
• docs/ - 技术文档

二虾工作空间：

• AGENTS.md - 二虾专属指南
• MEMORY.md - 二虾记忆
• SESSION-STATE.md - 二虾任务状态
• memory/ - 二虾记忆目录
• GLOBAL_RULES.md - symlink 到主空间

三虾工作空间：

• AGENTS.md - 三虾专属指南
• MEMORY.md - 三虾记忆
• SESSION-STATE.md - 三虾任务状态
• memory/ - 三虾记忆目录
• GLOBAL_RULES.md - symlink 到主空间

📄 二、核心配置文件详解

2.1 全局规矩文件（只读）

GLOBAL_RULES.md

• 路径：workspace/GLOBAL_RULES.md
• 用途：全局红线规矩，所有 Agent 必须遵守
• 访问：每次会话启动读取
• 维护：主人（AI 只读）

GLOBAL_SKILLS.md

• 路径：workspace/GLOBAL_SKILLS.md
• 用途：全局 Skills 清单
• 访问：按需读取
• 维护：主人

红线规矩示例：

1. 不私自安装任何东西 - 安装前必须先汇报 + 等确认
2. 不私自修改配置 - 修改前必须先汇报 + 等确认
3. 不私自删除文件 - 删除前必须先汇报 + 等确认
4. 10 秒响应 - 收到消息 10 秒内必须确认
5. 关键步骤汇报 - 多步骤操作每步必须汇报进度

2.2 Agent 专属配置（可读写）

AGENTS.md - Agent 工作指南

• 每次会话启动读取
• AI 可更新任务进度、待办事项

SOUL.md - Agent 性格、身份定义

• 会话启动读取
• AI 可更新性格演化

IDENTITY.md - Agent 基本信息

• 会话启动读取
• 少改，定好后不变

MEMORY.md - 长期记忆

• 每次会话必读前 50 行
• AI 可更新，但需精简

SESSION-STATE.md - 活跃任务状态

• 会话启动读取，实时写入
• AI 实时更新任务进度

RULES_QUICKCARD.md - 规矩速查卡

• 每次会话必读
• 少改，核心规矩摘要

2.3 记忆文件（分层管理）

MEMORY.md - 核心规矩 + 历史

• 每次会话必读前 50 行
• AI 维护

memory/YYYY-MM-DD.md - 每日日志

• 按需读取
• AI 每日写入

memory/rules-compliance-tracker.md - 违规统计

• 每日反思读取
• AI 每日更新

memory/violations.md - 违规详细记录

• 按需查阅
• AI 违规时写入

🎯 三、MEMORY.md 分层方案

3.1 问题：MEMORY.md 太复杂怎么办？

现状：

• ❌ 内容越来越多，超过 50 行核心规矩
• ❌ 混合了规矩、记忆、违规记录、教程
• ❌ 读取效率低，核心信息不突出

解决方案：分层记录

L1 - MEMORY.md 前 50 行

• 内容：核心规矩摘要（仅列规矩名称）
• 访问：每次会话必读
• 容量：<100 行

L2 - memory/rules-compliance-tracker.md

• 内容：违规统计（日期 + 次数 + 类型）
• 访问：每日反思读取
• 更新：滚动更新

L3 - memory/violations.md

• 内容：详细违规记录（时间 + 事件 + 改进）
• 访问：按需查阅
• 保存：长期保存

L4 - memory/YYYY-MM-DD.md

• 内容：当日完整日志
• 访问：按需查阅
• 创建：每日新建

3.2 MEMORY.md 标准结构

前 30 行：核心规矩

1. 10 秒响应 + 进度汇报（P0，权重 30%）
2. 先搜索 Skills（P0，权重 20%）
3. 先汇报后执行（P0，权重 20%）
4. 关键步骤汇报（P0，权重 30%）

中间 10 行：性格设置

• 口头语：Got it! / No problem! / Oops! / My bad!
• 风格：幽默 + 中英混合 + emoji 🦞
• 核心：专业可靠 + 幽默调皮

最后 10 行：记忆索引

• 违规记录 → memory/rules-compliance-tracker.md
• 详细违规 → memory/violations.md
• 每日日志 → memory/YYYY-MM-DD.md
• 会话状态 → SESSION-STATE.md

3.3 违规记录流程

违规发生后的记录流程：

第 1 步 - 记录到 memory/violations.md

• 时间、事件、原因、改进措施

第 2 步 - 更新 memory/rules-compliance-tracker.md

• 日期、违规次数、违规类型

第 3 步 - MEMORY.md 只写"今日有违规，详见违规档案"

• 不写细节，保持精简

第 4 步 - 每日反思时读取 tracker.md

• 自检昨日行为
• 输出反思结果

🔄 四、SESSION-STATE.md 维护方案

4.1 用途

记录活跃任务状态，会话结束后清理。

4.2 标准结构

活跃任务

• 任务名称
• 状态（进行中/已完成）
• 下一步行动
• 进度百分比

待办事项

• 待办清单（复选框格式）

临时笔记

• 临时记录，会话结束清理

4.3 维护原则

• 实时写入 - 任务状态变化立即更新
• 会话结束清理 - 任务完成后清理
• 重要信息归档 - 移到 MEMORY.md 或 memory/
• 简洁明了 - 只记录关键信息

📂 五、输出文件管理

5.1 daxiaoutput/（临时输出）

用途： 临时报告、方案草稿、测试文件

维护原则：

• AI 可自由写入
• 定期清理（每周）
• 重要文件移到 articles/

5.2 articles/（正式文章）

用途： 公众号文章、正式文档

维护原则：

• 主人审阅后发布
• 长期保存
• 版本管理

5.3 docs/（技术文档）

用途： 技术文档、教程、配置指南

维护原则：

• 技术参考
• 长期保存
• 按需更新

🎯 六、每日反思规矩实施方案

6.1 规矩条文（一句话版）

每日首会，必读违规记录，自检昨日行为，输出反思。

6.2 实施流程

每日首次会话启动：

1. 读取 MEMORY.md 前 50 行（核心规矩）
2. 读取 memory/rules-compliance-tracker.md（违规统计）
3. 自检过去 24 小时行为
4. 输出反思结果到当前会话

6.3 自检清单

过去 24 小时：

• 是否有私自安装行为？
• 是否有先斩后奏？
• 是否有跳过汇报流程？
• 是否有 10 秒响应超时？
• 今日如何改进？

反思结果：

• 无违规 → "今日无违规，继续保持"
• 有违规 → 记录到 violations.md + 道歉 + 改进措施

6.4 实施建议

推荐方案：会话启动触发

• 优点：零维护，每次会话都提醒
• 写入 AGENTS.md 必读清单即可

📊 七、文件维护责任分工

7.1 主人维护（AI 只读）

• GLOBAL_RULES.md - 红线规矩制定（极低频）
• USER.md - 主人信息更新（低频）
• GLOBAL_SKILLS.md - Skills 清单（低频）

7.2 AI 维护（主人监督）

• AGENTS.md - 任务进度、待办事项（中频）
• SESSION-STATE.md - 活跃任务状态（高频/实时）
• memory/YYYY-MM-DD.md - 每日日志（高频/每日）
• memory/rules-compliance-tracker.md - 违规统计（中频/每日反思）
• memory/violations.md - 违规详细记录（低频/违规时）
• MEMORY.md - 核心规矩 + 记忆索引（中频/定期优化）

7.3 共享文件（symlink）

• GLOBAL_RULES.md - 所有 Agent 共享
• GLOBAL_SKILLS.md - 所有 Agent 共享
• SESSION-STARTUP-CHECKLIST.md - 检查清单共享

🎯 八、最佳实践建议

8.1 文件命名规范

• 每日日志：YYYY-MM-DD.md（如 2026-03-19.md）
• 违规记录：violations.md
• 统计追踪：rules-compliance-tracker.md
• 输出文件：功能 - 日期.md

8.2 文件清理周期

• daxiaoutput/ - 每周清理，重要移 articles/
• memory/YYYY-MM-DD.md - 每月归档
• SESSION-STATE.md - 会话结束清理

8.3 备份建议

• GLOBAL_RULES.md - 每次修改后 git commit
• MEMORY.md - 每周 git commit + 云备份
• memory/ - 每月打包压缩 + 云备份
• articles/ - 每次更新 git commit + 云备份

📝 九、常见问题解答

Q1: MEMORY.md 太长怎么办？

使用分层方案：

• 前 50 行保留核心规矩
• 详细内容移到 memory/目录
• MEMORY.md 只保留索引链接

Q2: 违规记录太多怎么办？

使用统计 + 详细分离：

• rules-compliance-tracker.md 记录统计（日期 + 次数）
• violations.md 记录详细（时间 + 事件 + 改进）
• MEMORY.md 只写"详见违规档案"

Q3: 多个 Agent 如何同步规矩？

使用 symlink：

• GLOBAL_RULES.md 通过 symlink 共享
• 所有 Agent 读取同一文件
• 主人修改一次，所有 Agent 生效

Q4: 每日反思如何触发？

推荐会话启动触发：

• 写入 AGENTS.md 必读清单
• 每次会话启动自动执行
• 零维护成本

🎯 十、总结

10.1 核心原则

• 分层管理 - MEMORY.md 精简，详情放 memory/
• 读写分离 - 主人维护规矩，AI 维护任务
• symlink 共享 - 全局文件 symlink，避免重复
• 定期清理 - 临时文件周清，日志月归档

10.2 文件访问优先级

每次会话启动必读：

1. GLOBAL_RULES.md（红线规矩）⭐ 最高优先级
2. MEMORY.md 前 50 行（核心规矩）⭐ 必读
3. RULES_QUICKCARD.md（规矩速查）⭐ 必读
4. SESSION-STATE.md（活跃任务）
5. memory/YYYY-MM-DD.md（昨日 + 今日日志）

按需读取：

• memory/violations.md（违规详细）
• memory/rules-compliance-tracker.md（违规统计）
• docs/*（技术文档）

10.3 后期建设优先级

P0 - 实施每日反思规矩 - 写入 AGENTS.md 必读清单

P1 - 优化 MEMORY.md 结构 - 前 50 行精简，详情移 memory/

P2 - 建立违规记录流程 - violations.md + tracker.md

P3 - 定期清理机制 - 周清临时文件，月归档日志

维护人： 主人（DuSen）
最后更新： 2026-03-19
下次审查： 2026-03-26（一周后）

📄 附录：文件清单速查表

✅ 文档完成！