本文目标是让你知道修改哪个文件、何时会生效，以及怎样确认助手读取了正确的内容。
资料核对日期：2026-10-06。 本文依据当前官方文档整理，未在真实用户工作区进行操作实测；旧版本的目录、字段和加载规则可能不同。
1. 先确认正在使用的工作区
在网关所在主机运行：
openclaw --version
openclaw agents list
默认工作区通常为 ~/.openclaw/workspace，但配置、环境变量、profile及多agent设置都可能改变它。以目标agent的实际路径为准，不要仅凭目录名字判断。当前配置支持单agent默认路径 agents.defaults.workspace 和具体agent的 agents.entries.<agentId>.workspace；多agent情况下默认根目录不一定就是每个agent的实际工作区。
先备份要修改的文件，再编辑已确认的路径。控制界面也可通过 Settings → Agents → Files 查看和编辑对应文件。
工作区不是安全沙箱。 它是文件工具的默认工作目录；没有沙箱限制时，绝对路径仍可能访问其他目录。把“不许访问外部文件”写入文字规则，不能替代工具权限和沙箱设置。
2. 分清各文件的职责
| 文件 | 适合保存什么 | 不适合保存什么 |
|---|---|---|
| AGENTS.md | 工作顺序、核验要求、工具使用约定 | 密钥、海量日志 |
| SOUL.md | 语气、风格、交流边界 | 平台认证配置 |
| USER.md | 稳定用户偏好，附日期及当前/已替代状态 | 每次运行的流水记录 |
| MEMORY.md | 持久事实、已确认决定、简短总结 | 原始聊天全文、临时猜测 |
| memory/YYYY-MM-DD.md | 当天观察、处理经过、待复核信息 | 无需长期保存的凭据 |
AGENTS.md和SOUL.md作为工作区上下文加载；MEMORY.md应限于主私聊，不要把私密记忆带入共享群聊。长期记忆文件不是无限上下文：文件过大时，注入模型的副本可能被截断，原文件仍保留。
3. 做一次小范围修改
下面是作者提供的最小写法示例。将它们合并到已有文件，不要抹掉原有规则。
AGENTS.md：
## 操作约定
- 开始前确认目标目录和任务范围。
- 修改前说明依据，修改后记录验证结果。
- 未核实的信息标为待确认，不写成既定事实。
- 涉及对外发布或扩大访问权限时，核对当前授权范围。
SOUL.md：
## 表达方式
用简洁中文解释操作。区分事实、推测和未完成的验证。
遇到错误先给出证据和下一步，不编造成功结果。
MEMORY.md：
## 已确认决定
- 2026-10-06：示例项目的备份先验证恢复，再安排定期运行。
来源：维护者确认。若备份方案改变，复核此条。
示例项目不是你的真实事实。只保留已确认且与你相关的内容。稳定偏好优先写入USER.md；偏好改变时标明旧条目已被替代，避免同时留下矛盾指令。
4. 验证是否加载
- 在正确agent的私聊开启新会话，提出一个能够体现新规则的小任务。
- 使用聊天命令
/context list或/context detail查看注入内容及截断情况。 - 加入一条无敏感信息的临时测试记忆，要求助手指出来源文件；对照磁盘内容，不只相信它口头说“记住了”。
- 验证完成后移除临时测试条目，保留正式规则。
- 群聊另行检查，不要通过把私人MEMORY.md复制进去解决记忆缺失。
记忆需要实际写入持久文件。“我以后会记住”不是保存证据。详细过程留在每日笔记，长期文件只保存压缩后的结论。
5. 备份与故障排查
工作区、配置、凭据与会话状态不是同一份数据。仅备份Markdown不能恢复全部OpenClaw状态。工作区可用私有版本库管理，但提交前检查差异，不将.env、token、聊天原始附件或状态数据库推送到公开仓库。
| 现象 | 检查顺序 |
|---|---|
| 改了文件但回答没变 | agent选择、实际路径、新会话、上下文注入情况 |
| 记忆逐渐遗漏 | 文件是否写入、内容是否过长、注入是否截断 |
| 多个助手混用资料 | 每个agent的workspace配置；不要假定同名文件会自动合并 |
| 迁移后失忆或认证丢失 | 区分工作区与状态目录；按官方备份/迁移流程恢复 |
| 新旧指令冲突 | 找到来源和日期，明确替代关系，保留可回退副本 |
恢复验证宜在隔离副本进行；不要覆盖唯一生产数据来试验备份。进一步参考官方备份说明。
上一课：Day 2 平台接入 · 后续：Day 5 自动化 · 系列目录