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 Security

统一安全套件，为代理工作区提供一键安装、配置和编排全部11个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 就会降级为被动应答器