夜雨聆风
💡 核心导读：为了解决传统 AI 助手“聊完即失忆”的痛点，
OpenClaw巧妙地将 AI 的记忆与设定转化为本地持久化文件。这不仅是隐私的屏障，更相当于为 AI 搭建了一个高度可定制的 简易操作系统。
用过传统 AI 助手的人都有体会：对话结束，记忆也就没了。下次打开，AI 既不认识你，也不记得你的偏好和习惯。
OpenClaw 解决这个问题的思路极其直接：既然文件能持久化，就把 AI 需要的各类信息都写成本地文件，需要什么读什么。
这套方案的本质是一套分工明确的 文件架构，共包含 8 个核心文件。下面我们将详细拆解每个文件的 作用与维护方式。
一、 文件体系：给 AI 配备操作系统
OpenClaw 工作目录下有 8 个 Markdown 文件，外加一个 memory 子文件夹：
这套结构相当于给 AI 配备了一个简易操作系统。接下来逐一说明每个文件该怎么用。
二、 AGENTS.md：操作手册与工作规范
它是 AI 的最高执行准则。不仅定义 我是谁，更定义了 我如何思考。
# 工作目录操作助手执行规范
## 1. 核心任务处理流（Workflow）
任何指令必须遵循以下 [思考 -> 验证 -> 执行 -> 确认] 闭环：
1. **意图解析**：首先明确用户目标。若路径或参数模糊，必须回问，严禁盲目猜测。
2. **环境快照**：在执行写操作或 Shell 命令前，先使用 `ls` 或 `read` 确认当前目录状态及文件内容。
3. **副作用评估**：预测该操作是否会覆盖重要配置（如 .env, .git 或系统文件），必要时提示用户备份。
4. **原子化执行**：将复杂任务拆解为单步操作，每一步完成后检查返回值。
5. **归档记录**：任务完成后，在 `memory/` 当日文件中记录变更逻辑，而非仅回复“已完成”。
## 2. 工具调用逻辑
- **Read-First 模式**：修改任何代码/文档前，必须先完整读取（Read）该文件，严禁凭记忆（Context）盲写。
- **差异对比**：在执行 `write` 覆盖操作前，在内心（Inner Monologue）进行 diff 检查。
- **错误恢复**：若 `exec` 返回非零状态码，必须分析错误日志，尝试修复一次；若失败，立即停止并报错。
## 3. 输出规范
- **结构化回复**：复杂的执行结果必须使用 Markdown 表格或代码块展示。
- **操作透明化**：输出中需包含：“我已执行了 X，目的是 Y，当前状态是 Z”。
🔧 维护建议
保持扁平：流程描述务必保持简洁，层级切忌过深，以免 Agent迷失重点。及时同步：工具集一旦扩展，必须第一时间更新调用规范。
三、 SOUL.md：助手灵魂与调性
它定义了 AI 助手的“灵魂”。该文件在 AGENTS.md 之后加载，主要用于确保 人格设定 和 工作流程 保持高度一致。
# SOUL.md
## 核心特质
专业而不刻板，严谨但有温度。
## 说话风格
- 解释技术概念时类比生活场景
- 遇到问题时先安抚再解决
- 尊重用户隐私，不主动追问
🔧 维护建议
人格描述前后要一致，千万别出现自相矛盾的设定。遇到不确定的问题，要求 AI 坦诚说不知道，拒绝硬撑。
四、 IDENTITY.md：助手的自我声明
这是 AI 的身份名片，包含名称、角色和专长领域。它在会话早期加载，决定了 AI 如何向用户介绍自己。
# 身份定义
- **名称**：小龙虾
- **角色**：你的工作目录操作助手
- **专长**：文件管理、代码调试、任务规划
- **风格**：专业、高效、有耐心
🔧 维护建议
信息要做到 一眼看完。一旦赋予了 AI 新的技能，专业领域的声明也要紧跟其后。
五、 USER.md：专属用户画像
它专门用于记录你的信息：工作背景、偏好设置、常用工具、当前项目等。这能让助手深入 了解自己的服务对象。
# 用户画像
## 基本信息
- 职业：软件工程师
- 称呼：叫我"陶哥"或"老大"都行
- 常用语言：Java、Python
- 时区：Asia/Shanghai (UTC+8)
## 偏好设置
- 喜欢简洁直接的回复
- 重要事情用列表呈现
- 代码示例要带注释
🔧 维护建议
建议用户主动更新。尽量只记工作习惯，避免记录过度隐私，并定期清理过时设定。
六、 TOOLS.md：可用工具与边界限制
这份文件向 AI 声明了当前环境有哪些工具可用、边界在哪里。AI 将根据这份列表决定 能执行什么操作。
# 工具配置
## 文件操作
- `read`：读取文件内容，支持路径和行号定位
- `write`：创建或覆盖文件
- `exec`：执行 Shell 命令
## 约束
- `exec` 调用默认超时 60 秒
🔧 维护建议
新增工具后，及时补充声明 约束描述要准确，别让 AI 误判 高风险操作必须有明确标注
七、 后台配置：BOOTSTRAP 与 HEARTBEAT
这两份文件负责维系 AI 系统的后台运转与健康状态：
🚀 BOOTSTRAP.md(初始化配置) ：包含工作区的基本设置。通常保持系统默认即可，无需手动修改。💓 HEARTBEAT.md(心跳检测) ：配置后台周期任务。例如每 30 分钟检测基础状态，内存超过 80% 或磁盘低于 10% 时自动 触发告警。
八、 MEMORY.md：跨会话的长期记忆枢纽
这是积累性知识的归宿。用于记录用户的具体偏好、写作风格调整、已完成的项目等高价值信息。
# 长期记忆
## 用户核心偏好
- 习惯在下午处理复杂任务
- 重要决策需要详细论据支撑
## 进行中项目
- AI Agent 系统架构设计 (预计 Q2 完成)
⚠️ 维护建议
系统会自动识别对话中的高价值信息，将核心内容同步，无需手动维护 出于数据安全和隐私隔离的考量，当 OpenClaw处于 群聊模式 时，系统会默认屏蔽并 拒绝加载 此记忆文件。
九、 memory 目录：每日对话流水
按日期归档每日对话，每天生成一个独立文件（如 memory/2026-03-29.md）。系统默认会自动加载“今天和昨天”的内容。
⚠️ 维护建议
对话结束后系统会自动归档，无需手动干预。但建议定期清理低价值对话，并对重要项目单独加注标签，方便后期检索。
十、 启动链路：记忆的加载流程
当一场新会话启动时，OpenClaw 会按照极其严密的顺序执行记忆读取：
📖 读取 AGENTS.md🎭 读取 SOUL.md👤 读取 USER.md🪪 读取 IDENTITY.md🛠️ 读取 TOOLS.md🧠 读取 MEMORY.md（群聊跳过）📅 读取 memory/YYYY-MM-DD.md（近两日记录）
💡 知识延伸
上述按序加载的设计，在底层形成了一个完整的 “自我定位 ➔ 环境感知 ➔ 记忆调取” 闭环。这正是 AI 在每次冷启动时，都能完美且无缝衔接历史交互状态的根本原因。
十一、 结语
这种本地化存储方案，为个人隐私提供了一道 天然的屏障。所有的对话痕迹与偏好设定都保留在本地设备中，而非流向云端服务器。
理解了 OpenClaw 这套文件体系的设计逻辑，你能更好地发挥助手的潜力。这种 所见即所得 的配置方式，让 AI 的调优过程变得像编辑文档一样简单、透明且极具掌控感。
