USER.md 是 OpenClaw 强制加载的用户身份主档案,将模糊需求转为结构化指令,决定响应节奏、表达方式、任务优先级与沟通雷区;须填 Name、Role/Job、Goals、Communication style、Timezone & Working hours 五项非空字段。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

USER.md 是 OpenClaw 的用户身份主档案,不是可选说明文档,而是每次会话启动时强制加载的“服务说明书”。它让 AI 明确知道:你是谁、你日常怎么工作、你希望它怎么配合你——而不是靠猜或通用模板应付。
USER.md 的核心作用
它把模糊的“用户需求”变成可执行的结构化指令,直接影响 AI 是否主动、是否贴合、是否少犯错:
- 决定响应节奏:根据你填写的时区和工作时间,AI 自动避开非工作时段推送或追问
- 校准表达方式:你偏好“分步说明”还是“一句话结论”,AI 就按这个风格组织语言
- 锚定任务优先级:短期目标(如“本周完成竞品分析报告”)和长期目标(如“建立个人知识沉淀体系”)会被持续对齐,避免跑偏
- 规避沟通雷区:比如你注明“不接受带营销话术的建议”,AI 就不会在推荐工具时夹带推广信息
必须填哪些字段?
官方明确要求所有字段非空。最小可用配置包含以下五项,缺一不可:
完整备份 OpenClaw 配置目录 (.openclaw) 到同名带时间戳的目录,包括所有文件和隐藏文件。当用户需要备份 OpenClaw 配置、数据或创建配置快照时使用。
- Name:你的真名或常用代号(用于记忆关联与语气适配)
- Role / Job:具体岗位+行业,例如“电商公司增长运营|快消品类”而非“市场人员”
- Goals (short & long term):用动词开头,如“整理2026年Q1客户反馈归因”“三年内建成可复用的SOP知识库”
- Communication style they prefer:限定格式,如“先给结论,再列三点依据”“禁用比喻,全部直述”
- Timezone & Working hours:精确到城市,如“Asia/Shanghai|9:00–12:30, 14:00–18:00”
怎么写才真正起作用?
别写概括性描述,要写真实行为线索。AI 不读“人设”,只认可验证的动作信号:
- 写“喜欢用表格对比方案”,就比写“偏好清晰表达”更有效
- 写“每天17:00后不处理待办,只看摘要”,AI 就会在16:50自动汇总当日进展
- 写“拒绝调用未授权的第三方API”,AI 就不会在TOOLS未显式启用某插件时擅自调用
- 写“遇到技术问题优先查本地docs/,其次才搜GitHub”,AI 会按此顺序检索,而非默认联网
和其他文件的关系
USER.md 单独存在没用,必须和 SOUL.md(定义AI怎么想)、AGENTS.md(定义AI怎么干)协同生效:
- SOUL.md 写“保持克制,不主动提问”,但 USER.md 写“每天早10点需同步待办”,AI 就会在10点准时发起,不矛盾
- AGENTS.md 设了“邮件自动归档流程”,而 USER.md 注明“仅归档含‘合同’‘付款’字样的邮件”,流程就自动带上过滤逻辑
- 三者共同构成“角色—对象—动作”闭环,缺一个,AI 就会降级为被动应答器

















