夜雨聆风OpenClaw 从0到1实战剖析（04）
1. USER.md 怎么写，Agent 才真的“懂你”
上一篇我们把 SOUL.md 拆清楚了：它决定 Agent 的人格和做事边界。
这一篇接着往下走，讲另一个关键文件：USER.md。
一句话：
SOUL.md 决定“它怎么做事”，USER.md 决定“它为谁做事、按谁的习惯做事”。
2. 一、USER.md 的核心作用
很多人会把 USER.md 写成简历，结果几乎没用。
真正有用的 USER.md，是执行偏好配置。
它主要解决 3 件事：
称呼与沟通成本：怎么叫你、语气松紧、默认语言 节奏与时间成本：时区、作息、消息提醒窗口 决策与交付偏好：你喜欢“先结论后细节”还是“先推导后建议”
如果这三件事写清楚，Agent 的输出会明显“像在和你配合”，而不是“对着空气说话”。
3. 二、一个可直接套用的 USER.md 模板
建议先保持精简，10~20 行就够：
markdown
# USER.md - About Your Human
- Name:
- What to call them:
- Timezone:
- Preferred language:
## Working Preferences
- 默认回复风格：先结论后细节 / 可执行清单优先
- 需要确认后再做的动作：外发内容、删除操作、批量修改
- 可以直接执行的动作：本地读写、检索、草稿准备
## Ongoing Focus
- 当前重点项目：
- 本周优先级：
- 常见决策标准：速度优先 / 稳定优先 / 成本优先
注意： 它不是“写满信息”，而是“写能影响执行质量的信息”。
4. 三、最容易踩的 4 个坑
4.1 坑 1：只写身份，不写偏好
只写“我是谁”，不写“我怎么协作”。
结果 Agent 认识你的名字，但不会按你的方式干活。
4.2 坑 2：一次写死，长期不更新
你的项目和节奏会变，USER.md 不更新就会逐渐失真。
4.3 坑 3：把临时任务塞进长期画像
“今天帮我改这个标题”这种临时需求不该写进 USER.md，应该进每日 memory。
4.4 坑 4：边界不清
不写“哪些动作要先确认”，最容易出现误发、误改、误通知。
5. 四、实战对比：同一句话，为什么结果差这么多
指令：“把今天内容处理一下。”
没有 USER.md 时，常见情况：
不知道你要的是“草稿”还是“直接发布” 不知道你想要短版还是长版 不知道该不该先确认
USER.md 写清楚后，动作会变成：
按你默认偏好先给结论版 自动补一个可执行 checklist 涉及外发先确认，内部准备直接做完
同一句话，返工次数会少很多。
6. 五、你现在就能做的 10 分钟优化
打开你的 USER.md，做这 3 个动作：
补齐“称呼 + 时区 + 默认语言” 明确“要确认/可直做”的动作边界 写上“当前重点项目 + 决策优先级”
做完后，你会感受到一个非常具体的变化：
Agent 不只是“会回答”，而是“更像在跟你协作”。
7. 这篇结论
USER.md 的本质不是资料卡，而是协作配置。
它决定 Agent 能不能从“通用助手”变成“你的助手”。
下一篇我们接着拆：
《OpenClaw 从0到1实战剖析（05）：TOOLS.md 怎么写，Agent 才能在你的机器上真干活》