Appearance
06B. OpenClaw USER.md 与记忆配置通用说明
适用对象：已经安装好 OpenClaw，想让它更懂自己、少重复沟通的用户 | 文档版本：V1.0 更新日期：2026 年 3 月 23 日 | 文档定位：专门讲
USER.md、长期偏好、资料目录与多 Agent 独立记忆的配置说明
先看结论
很多人装完 OpenClaw 后觉得“每次都要重新解释一遍”。问题通常不在模型，而在你还没把长期信息分层放好。
建议按下面的方式管理：
~/.openclaw/USER.md放你的全局偏好~/.openclaw/data/放长期资料和模板- 某个专用 Agent 再单独配自己的
USER.md
不要把所有东西都塞进一个文件，更不要把密码和 API Key 写进去。
一、USER.md 到底是干什么的
USER.md 不是知识库，也不是配置文件。
它更像是你给 OpenClaw 写的一份“长期说明书”，适合放这些内容：
- 你是谁
- 你平时做什么
- 你喜欢什么表达方式
- 你希望 AI 默认怎么理解你的指令
- 哪些事它可以直接做，哪些事要先问你
不适合放这些内容：
- API Key
- 密码
- 大量项目文档原文
- 频繁变化的临时待办
二、全局 USER.md 应该怎么写
文件位置：
text
~/.openclaw/USER.md编辑方式：
bash
nano ~/.openclaw/USER.md或者：
bash
code ~/.openclaw/USER.md推荐结构：
markdown
# 关于我
## 个人背景
- 我的职业和行业
- 我的技术水平
- 我当前最常做的工作
## 输出偏好
- 默认使用中文
- 结论先行
- 给命令时优先给可复制版本
- 不确定时明确说明
## 执行边界
- 涉及删除、覆盖、外发时先确认
- 普通文档整理、信息汇总、草稿生成可直接做
## 常用工具
- 飞书
- VS Code
- GitHub
- Notion
## 沟通约定
- “帮我看一下”偏向分析
- “帮我处理一下”偏向可直接执行
- “先别动文件”表示只讨论方案
## 常见任务
- 写文档
- 查资料
- 整理会议纪要
- 配置开发环境这个结构的核心价值是：让 OpenClaw 先理解你，再理解你的任务。
三、写 USER.md 的 6 条实用规则
3.1 写稳定规则，不写临时需求
适合写：
- “默认用中文”
- “先给结论，再给细节”
- “修改文档时优先保留原结构”
不适合写：
- “今天下午 3 点我要开会”
- “这周先做 A 项目”
临时事项更适合放在 data/ 目录或直接在当前对话里说。
3.2 写行为偏好，不写空泛口号
好例子：
- “给我命令时优先给完整命令，不要只给思路”
- “如果你不确定，请直接说不确定，不要猜”
差例子：
- “请尽量聪明一点”
- “请表现得专业”
3.3 一条规则只表达一件事
不要一大段混在一起。
例如：
- “默认使用中文”
- “回复优先简洁”
- “涉及删除操作前先确认”
这样比长段落更容易稳定生效。
3.4 不要把项目细节全塞进去
如果你把某个项目的全部背景都放进 USER.md，会有两个问题：
- 文件越来越长
- 换项目后大量内容失效
更好的做法是：
USER.md保留长期稳定偏好- 项目资料单独放在
~/.openclaw/data/项目名/
3.5 控制长度
建议：
- 新手控制在 50 到 120 行
- 重度用户控制在 200 行以内
不是越长越好。越长越容易互相冲突，也越占上下文。
3.6 改完后开新对话
USER.md 通常在新对话开始时加载。
所以你改完后如果发现“怎么没变”，先新开一个会话再测试。
四、推荐你单独维护的 data/ 目录
除了 USER.md，更建议你把长期资料放到：
text
~/.openclaw/data/推荐结构：
text
~/.openclaw/data/
├── todo.md
├── contacts.md
├── writing-style.md
├── weekly-template.md
└── projects/
├── project-a.md
└── project-b.md适合放在这里的内容：
- 待办清单
- 固定模板
- 联系人资料
- 常用文案风格
- 项目背景摘要
这样做的好处：
- 和
USER.md分工清晰 - 更适合给自动化任务读取
- 更适合做迁移和备份
五、多 Agent 时怎么拆记忆
如果你开始用多个专门 Agent，不要所有 Agent 共用一份大而全的偏好说明。
推荐方式：
| 位置 | 适合用途 |
|---|---|
~/.openclaw/USER.md | 所有 Agent 都要遵守的全局规则 |
~/.openclaw/agents/coder/USER.md | 代码 Agent 的规则 |
~/.openclaw/agents/writer/USER.md | 文档 Agent 的规则 |
~/.openclaw/agents/ops/USER.md | 运维 Agent 的规则 |
例如代码 Agent 的 USER.md 可写：
markdown
# Coder Agent
- 默认输出可运行命令
- 修改代码前先说明风险点
- 优先保留现有项目结构
- 涉及破坏性操作必须先确认
- 回答中优先给 diff、文件路径和验证步骤文档 Agent 的版本则可以写：
markdown
# Writer Agent
- 默认使用中文
- 优先保留现有章节层级
- 面向非技术用户时减少术语
- 示例命令必须可复制执行六、常见错误写法
6.1 把敏感信息写进记忆文件
不要写：
- API Key
- 邮箱密码
- Cookie
- 内部系统密钥
6.2 用记忆文件代替配置文件
例如把“默认模型是 DeepSeek”写在 USER.md 里，这不是最合适的做法。
这类系统配置应该用：
bash
openclaw config set models.default "deepseek/deepseek-chat"6.3 一份 USER.md 既写个人偏好又写所有项目资料
这是最常见的失控来源。后果通常是：
- 文件越来越长
- 规则互相打架
- 模型抓不住重点
6.4 写成抽象要求
例如：
- “请保持高质量”
- “请尽量像专家一样回答”
这类话太抽象，不如改成可执行规则。
七、推荐的最小可用方案
如果你不想花太多时间，先做这个版本就够了：
- 创建
~/.openclaw/USER.md - 写 5 到 10 条稳定偏好
- 建一个
~/.openclaw/data/目录 - 把待办和模板文件移进去
最小模板：
markdown
# 关于我
- 默认使用中文
- 先给结论，再给步骤
- 提供命令时优先给完整可复制版本
- 不确定时直接说明
- 涉及删除、覆盖、外发时先确认这已经比完全不配强很多。
八、建议配套备份
至少备份：
bash
cp ~/.openclaw/USER.md ~/USER.md.backup 2>/dev/null || true
cp -R ~/.openclaw/data ~/openclaw-data.backup 2>/dev/null || true如果你后面做了多 Agent 拆分，也把 agents/ 一起备份。
下一步看哪篇
| 你的目标 | 建议阅读 |
|---|---|
| 先补整个安装后配置主线 | 06A-OpenClaw-安装后配置-通用说明.md |
| 想做自动启动和长期常驻 | 06C-OpenClaw-自动启动与长期运行-通用说明.md |
| 想开放局域网或远程访问 | 06D-OpenClaw-远程访问与安全配置-通用说明.md |
| 想继续做多 Agent 配置 | 11-OpenClaw-进阶玩法-通用说明.md |