OpenClaw 工作区指南:智能体的家目录里都放了什么
OpenClaw 的智能体不是一个黑盒服务——它的工作记忆全部以文件形式摆在一个工作区目录里(默认在状态目录下的 workspace 文件夹)。把它调教得顺手,从认识这个目录开始。
工作区里的关键文件
- MEMORY.md:长期记忆,持久的事实、偏好与决定,会话开始时注入。
- memory/ 目录:每日笔记(按日期命名的工作层文件),记录当天观察与上下文。
- SOUL.md:人设文件——它的说话方式、性格边界(详见下一页 人设文件)。
- AGENTS.md:常驻指令所在,授予智能体「对既定程序的永久操作权限」(详见 自动化选型)。
- skills/ 目录:你的自定义技能,优先级高于一切托管技能。
引导机制
会话启动时,OpenClaw 把这些引导文件拼进系统提示词,所以你改了文件,下一轮对话立即生效,不需要重启网关。每个文件有预算上限(防止提示词膨胀),MEMORY.md 超预算时磁盘文件不动、只截断注入副本——官方把这当作「该把细节挪去每日笔记」的信号。
多智能体 = 多工作区
每个智能体有自己独立的工作区。想让两个智能体性格、记忆、技能完全不同,就给它们两个工作区;共享的部分(如家庭常识)可以放个人级共享目录。工作区路径与智能体清单在配置的 agents 块下管理。
直接对话就能写记忆
不需要手动编辑所有文件——直接告诉它「记住我偏好用 TypeScript」,它会自己把笔记写进合适的文件。官方还提供从 Codex、Claude Code 导入既有记忆的图形入口,老用户迁移成本很低。
备份价值
整个工作区是纯 Markdown + SQLite 索引,用 git 管理工作区目录是社区流行的做法:记忆可回滚、改动可审计,换机器时也是现成的迁移包。