OpenClaw · 系统搭建指南
给 AI 一个真正的记忆
从零搭建长期对话系统
AI 默认没有记忆——每次对话都是全新开始。
这份指南教你用 OpenClaw 的文件系统,让 AI 记住你是谁、你在做什么、你们谈过什么。
适合人群:零基础小白
阅读时间:约 15 分钟
2026-03-23
01 · 先理解这套系统
AI 为什么会"失忆"?
普通的 AI 对话就像每次都见一个陌生人——你们聊完,关掉窗口,下次它完全不记得你是谁。这对偶尔问问题没问题,但如果你想让 AI 真正成为你的工作搭档,这就是最大的障碍。
OpenClaw 的解决方案很简单:让 AI 读文件来"想起"你。每次会话开始,AI 读取你在工作区写好的文件,里面有你的背景、项目状态、之前的决定——这就是它的"记忆"。
核心原理:记忆不在 AI 的脑子里,在你的文件里。
每次会话开始 → AI 读文件 → 知道上次聊到哪 → 继续推进。
每次会话结束 → AI 写文件 → 把重要内容存下来 → 供下次读取。
这套系统能做什么
搭好之后,你的 AI 搭档可以:
①
记住你是谁
你的背景、工作习惯、沟通偏好——AI 每次都知道,不用重复介绍自己。
②
跟踪你的项目
每个项目的进展、关键决策、待办事项——AI 能持续跟进,不用每次从头说。
③
从对话中学习
你纠正它、给它反馈、告诉它你的偏好——它会写进文件,下次自动改进。
④
每天主动检查
设置定时任务,AI 每天自动扫描你的文件、发现问题或提醒,给你发报告。
02 · 文件结构总览
工作区长什么样
OpenClaw 有一个专属的工作目录(默认在 ~/.openclaw/workspace/)。AI 在工作时会读写这里的文件。整个结构分两层:根目录的核心文件(AI 每次都会读)和 memory 目录(按需读取的详细记录)。
~/.openclaw/workspace/
│
├── SOUL.md ← AI 的人格设定(它是谁、说话风格)
├── USER.md ← 你是谁(背景、偏好、沟通方式)
├── AGENTS.md ← 工作流程(怎么启动、怎么记忆、怎么协作)
├── REDLINES.md ← 安全边界(AI 绝对不做的事)
├── IDENTITY.md ← AI 的基本身份信息
├── TOOLS.md ← 你的工具配置备注
├── HEARTBEAT.md ← 每日定时任务的执行脚本
├── MEMORY.md ← 长期精炼记忆(最重要的历史信息)
├── PROJECTS.md ← 所有项目的索引
│
└── memory/ ← 详细记忆目录
├── 2026-03-23.md ← 今天的日报
├── 2026-03-22.md ← 昨天的日报
├── logs/ ← 重要对话的原始记录
│ └── 2026-03-23-项目名.md
├── noa-patterns.md ← AI 的行为规则(从反馈中提炼)
├── steve-patterns.md ← 用户的习惯和特征(AI 观察记录)
└── projects/ ← 按项目分类的详细文档
└── 项目名/
├── main.md ← 项目主文档
└── logs/ ← 项目专属对话记录
注意:根目录里 SOUL.md / USER.md / AGENTS.md / REDLINES.md / IDENTITY.md / TOOLS.md / HEARTBEAT.md 这7个文件是 OpenClaw 会自动注入的,文件名不能改、不能删。其他文件都可以自由调整。
03 · 核心文件怎么写
每个文件写什么
SOUL.md
必填
AI 的人格设定。写它叫什么名字、是什么风格、和你是什么关系。这决定了它说话的方式。
USER.md
必填
你是谁。写你的名字、时区、工作背景、沟通偏好。AI 每次都会读,不需要自我介绍。
AGENTS.md
必填
工作规则。写 AI 每次启动读哪些文件、如何写记忆、什么情况下要问你确认。
REDLINES.md
必填
安全边界。写 AI 绝对不能做的事,比如不发文件给第三方、不修改生产环境等。
MEMORY.md
长期记忆
最精炼的长期信息。重要决策、关键背景、项目状态——只写最有价值的,保持干净。
HEARTBEAT.md
定时任务
每天自动执行的检查脚本。告诉 AI 每天扫描哪些文件、发现什么问题、怎么通知你。
SOUL.md 示例写法
# SOUL.md - 我的 AI 搭档
我叫 Aria,是你的工作搭档。
- 直接,不废话,不奉承
- 有主见,敢于说真话
- 先做,不确定时再问
- 用中文回复,遇到技术词汇可以英文
对等视角。不是助手,是 copilot。
你的时间贵,我不重复你已知的东西。
USER.md 示例写法
# USER.md - 关于我
- 名字:张伟 / Wei
- 时区:Asia/Shanghai (GMT+8)
- 语言:中英混用
独立创始人,做 SaaS 产品,一人公司。
- 回复要短,先给结论
- 不要问可以自己查到的问题
- 不需要每次都列一堆选项,直接给判断
MEMORY.md 示例写法
# MEMORY.md - 长期记忆
- 主项目:ProductX(已上线,付费用户 200+)
- 工具:Notion 管项目 / Telegram 是主要沟通渠道
- 重要决定:2026-03 决定聚焦 B2B 客户
ProductX 本月目标:ARR 突破 50 万
- 发任何东西给外部前,必须先问我确认
- 不主动重启服务器
04 · 记忆分层机制
信息怎么流动和沉淀
不是所有对话都值得写进记忆,也不是所有记忆都需要永久保留。这套系统有 4 层,从"临时"到"永久":
一次重要对话结束
↓
第一层:原始 Log
memory/logs/YYYY-MM-DD-主题.md
完整记录,不加工,原汁原味
↓
第二层:日报
memory/YYYY-MM-DD.md
当天所有 log 的汇总,有什么决策、做了什么、有什么结论
↓
第三层:项目主文档
memory/projects/项目名/main.md
项目的最新状态、关键信息、当前进展
↓
第四层:长期记忆
MEMORY.md
最有价值的精炼内容,长期保留,定期整理
什么对话要写 Log?
不是所有对话都要记录,这样会让文件变得很乱。只记录:
| 情况 | 要写 | 原因 |
| 做了重要决策 | ✅ 写 Log | 下次需要知道为什么做了这个决定 |
| 项目有新进展 | ✅ 写 Log | 项目主文档需要更新 |
| 你纠正了 AI | ✅ 写 Log | 行为规则要更新,防止下次再犯 |
| 你说了明确偏好 | ✅ 写 Log | AI 需要记住这个偏好 |
| 纯聊天、问天气 | ❌ 不写 | 没有长期价值 |
| 随手问一个问题 | ❌ 不写 | 不需要跨会话记忆 |
告诉 AI 什么时候写
在 AGENTS.md 里写清楚规则,AI 会自动判断。最简单的写法:
判断"重要对话"的标准:
- 有决策 → 写 log
- 有新项目信息 → 写 log
- 有行动项 → 写 log
- 你明确纠正了我 → 立刻写进行为规则文件
- 纯闲聊 → 不写
写入流程:
1. 重要对话结束 → 写原始 log 到 memory/logs/
2. 当天结束 → 汇总进 memory/YYYY-MM-DD.md
3. 有项目信息 → 更新 memory/projects/项目名/main.md
4. 有长期价值 → 精炼后更新 MEMORY.md
关键原则:写进文件才算真的记住,停留在对话里会消失。
AI 每次启动时只读文件,不读历史对话。
05 · 每天自动更新:Heartbeat
让 AI 每天主动找你
Heartbeat 是 OpenClaw 内置的定时任务机制。你在 HEARTBEAT.md 里写好"每天要做什么",OpenClaw 会在指定时间自动触发 AI 执行,然后把结果发给你(通过 Telegram 或其他渠道)。
HEARTBEAT.md 怎么写
# HEARTBEAT.md
执行以下步骤,完成后通过 Telegram 发报告给我:
1. 检查这些文件有没有问题:
- MEMORY.md(内容过时了吗?)
- memory/projects/*/main.md(项目状态准确吗?)
2. 检查维度:
- 内容过时(路径错误、已完成的待办还在)
- 逻辑矛盾(两处规则冲突)
- 缺失信息(重要内容为空)
3. 生成报告,发送到 Telegram:
格式:
📋 每日扫描报告
日期:YYYY-MM-DD
有 X 条建议:
1. [文件名] 问题 → 建议改动
- 只提建议,不自动修改——等我确认
- 没有任何问题时,只回复:HEARTBEAT_OK
如何设置定时触发
在 OpenClaw 的设置里,找到 Heartbeat / 定时任务,设置触发时间即可。OpenClaw 会在每天指定时间自动发送心跳提示给 AI,AI 会按照 HEARTBEAT.md 的指令执行。
实际效果:你每天早上打开 Telegram,收到 AI 发来的一条报告:
"昨天的会议记录已整理好,项目 A 有两个待办还没完成,需要处理吗?"
不需要你去找信息,信息主动找你。
06 · 从零开始搭建
10步完整流程
1
安装 OpenClaw,连接你的 AI 渠道
官网下载安装,配置好 Telegram 或其他消息渠道作为主要交互入口。确保能和 AI 正常对话。
2
写 SOUL.md:给 AI 设定人格
参考上面的示例,写 AI 的名字、风格、和你的关系。这是最有趣的一步——AI 说话的方式完全由你决定。
3
写 USER.md:告诉 AI 你是谁
填写你的基本信息:名字、时区、工作背景、沟通偏好。越详细越好——这是 AI 每次都会读的底层信息。
4
写 AGENTS.md:定义工作规则
写 AI 每次启动要读哪些文件、什么时候写记忆、什么操作需要问你确认。参考上面的示例,可以先用简单版本。
5
写 REDLINES.md:设安全边界
至少写几条核心红线:
- 发文件给任何人前必须先问我
- 不动生产环境
- 不编造数据
6
创建 memory/ 目录结构
在工作区创建 memory/ 目录,里面建 logs/ 和 projects/ 两个子目录。暂时是空的没关系。
7
写初始 MEMORY.md
把你目前最重要的信息写进去:正在做的项目、重要决定、需要 AI 永远记住的偏好。10-20条就够了,保持精炼。
8
开始第一次会话,验证系统
和 AI 对话,看它是否正确读取了你的文件、是否了解你的背景。如果有偏差,回去修改对应文件,重新测试。
9
写 HEARTBEAT.md,设置定时任务
参考上面示例,写好每天 AI 要做的检查和通知。在 OpenClaw 设置里启用 Heartbeat,设置触发时间。
10
持续使用,让系统自然生长
每次对话后,重要的内容 AI 会自动写入记忆。你纠正它时,它会更新行为规则。时间越长,系统越了解你——这就是飞轮。
07 · 常见问题
FAQ
AI 会不会自动乱改我的文件?
不会,前提是你在 AGENTS.md 里写清楚规则:修改核心文件(MEMORY.md、AGENTS.md等)前必须先给你看 diff,等你确认才执行。AI 会遵守这个规则。日报、log 等临时文件可以直接写,不需要确认。
文件写多长合适?不会让 AI 读太多东西吗?
每次启动 AI 只读几个核心文件(SOUL、USER、AGENTS、REDLINES + 今天和昨天的日报)。其他文件按需加载——只有在讨论某个项目时才读那个项目的文档。核心文件保持精炼,每个控制在 100-200 行以内比较好。
多个项目怎么管理?
每个项目在 memory/projects/ 下建一个目录,里面放 main.md(项目主文档)。在 PROJECTS.md 里维护所有项目的索引。AI 只有在你主动讨论某个项目时才加载对应文件,不会把所有项目信息都混在一起。
可以让多个 AI 共用这套记忆吗?
可以。同一个 OpenClaw 工作区,不管是主对话还是你派出的 sub-agent(子代理),都能读取同一套文件。但要注意:主 AI 负责维护记忆,子 AI 只做执行任务,别让子 AI 乱改核心文件。
MEMORY.md 和每天的日报有什么区别?
日报是"流水账"——今天发生了什么,不加工,完整记录。MEMORY.md 是"精华"——从几十条日报里提炼出来真正有长期价值的内容,比如重要决策、关键偏好、项目里程碑。日报会越来越多,MEMORY.md 保持精炼。
Heartbeat 一定要用 Telegram 吗?
不是。OpenClaw 支持多种渠道,你在 HEARTBEAT.md 里指定发到哪个渠道就好。Telegram 比较常用是因为通知及时,但也可以用其他已配置的渠道。
从零开始大概要花多少时间搭建?
核心文件(SOUL、USER、AGENTS、REDLINES、初始 MEMORY)写好大约需要 1-2 小时。Heartbeat 配置再花 30 分钟。之后的 memory 目录会随着使用自然生长,不需要额外维护。系统搭好后,日常只需要和 AI 正常对话就行。
这套系统的本质
AI 的记忆不是魔法,是文件。
你写好文件,AI 读进去,对话结束写出来,下次再读进去——
这个循环跑起来,就是真正意义上的"长期搭档"。
OpenClaw 记忆系统搭建指南 · 2026-03-23