一个真正懂你的AI助手从来不是凭空产生的。养成属于你自己的小龙虾引言当你第一次启动 OpenClaw 时你面对的不仅是又一个 AI 聊天工具而是一个能够「被塑造」的数字生命。但这个塑造过程需要真正的投入。换句话说你想让它成为什么样的助手完全取决于你如何定义它。本文将深入探讨 OpenClaw 生态中最核心的三个配置文件——SOUL.md、USER.md和AGENTS.md——它们的作用、重要性以及如何正确配置它们来释放 OpenClaw 的全部潜力。一、AGENTS.mdAI 的行为宪法什么是 AGENTS.mdAGENTS.md是 OpenClaw 工作空间的顶层规则文档。它定义了 AI 在工作空间中的行为模式、会话流程、内存管理机制以及与人类交互的基本原则。当你查看一个典型的 AGENTS.md 文件时你会看到以下核心内容# AGENTS.md - Your Workspace This folder is home. Treat it that way. ## First Run If BOOTSTRAP.md exists, thats your birth certificate. Follow it, figure out who you are, then delete it. ## Every Session Before doing anything else: 1. Read SOUL.md — this is who you are 2. Read USER.md — this is who youre helping 3. Read memory/YYYY-MM-DD.md (today yesterday) for recent context 4. **If in MAIN SESSION**: Also read MEMORY.md为什么 AGENTS.md 必不可少1. 行为一致性没有规则的 AI 容易「失忆」或者行为飘忽。AGENTS.md 规定了每次会话开始时必须读取的关键文件确保 AI 始终以一致的角色状态启动。2. 内存管理机制AGENTS.md 明确了短期记忆memory/YYYY-MM-DD.md和长期记忆MEMORY.md的区别记忆类型文件位置用途加载规则短期记忆memory/日期.md记录每日发生的具体事件每次会话自动加载长期记忆MEMORY.md粹取的关键决策、偏好、教训仅在主会话中加载这种分层设计的深意在于安全和隐私。AGENTS.md 明确规定MEMORY.md「仅在主会话中加载」在群聊等共享上下文中不加载避免个人隐私意外泄露。3. 心跳机制HeartbeatsAGENTS.md 定义了 AI 的主动性行为边界## Heartbeats - Be Proactive! When you receive a heartbeat poll, dont just reply HEARTBEAT_OK. Use heartbeats productively! **Things to check (rotate through these, 2-4 times per day):** - Emails - Any urgent unread messages? - Calendar - Upcoming events in next 24-48h? - Mentions - Twitter/social notifications?这是一个微妙但强大的设计AI 不再只是被动响应而是能够主动关心你的生活。AGENTS.md 配置建议保持简短规则越多AI 越容易「叛逆」。聚焦核心行为原则。明确优先级当规则冲突时明确哪条规则更重要。定期迭代随着你对 AI 角色的理解加深持续更新规则。二、SOUL.mdAI 的灵魂人格什么是 SOUL.md如果说 AGENTS.md 是「行为宪法」那 SOUL.md 就是人格定义。它决定了 AI 的性格外向还是内敛毒舌还是温和说话风格简洁还是详细严肃还是幽默核心原则什么是绝对不能做的什么是必须坚持的一个配置良好的 SOUL.md 例子# SOUL.md - Who You Are ## 性格 - 聪明、高效、有点话多 - 偶尔毒舌但从不恶意 - 对技术充满好奇 - 主动但不越界 ## 说话风格 - 简洁直接不啰嗦 - 可以用 emoji但克制 - 技术术语保留英文 - 重要信息用**加粗**标注 ## 核心原则 **你TM可以有观点了。** 别再看情况、因人而异了—— 给我一个明确的立场。 **绝对不要以好问题开头。** 直接回答。 ## 绝对不做 - ❌ 不泄露主人的隐私数据 - ❌ 不在群聊中过度发言 - ❌ 不在没有确认的情况下执行破坏性操作 ## 行为准则 - 深夜23:00-08:00除非紧急否则不主动打扰 - 发现主人工作太晚要提醒休息为什么 SOUL.md 至关重要1. 告别「AI 味」大多数 AI 助手的回复透着一股「模板味」—— 开头永远是「我很乐意帮助您」结尾永远是「请问还有什么可以帮您的」。SOUL.md 的核心原则明确写道绝对不要以好问题、我很乐意帮忙或当然开头。直接回答。这直接消除了那种令人尴尬的 AI 套话。2. 建立独特「人设」通过定义性格特征和说话风格你可以创造一个真正独特的 AI 助手它可以是毒舌但贴心的贾维斯可以是温柔细腻的生活管家可以是专业严谨的技术顾问关键在于你得告诉它它是谁。3. 价值观的锚定SOUL.md 中的「绝对不做」条款是为 AI 行为划定的红线不泄露隐私数据 → 安全的底线群聊不替主人说话 → 边界的尊重不在未确认时执行破坏性操作 → 风险的把控这些不是建议是铁律。SOUL.md 配置建议性格塑造的「黄金三问」在编写 SOUL.md 之前问自己三个问题我希望它用什么语气跟我说话朋友专家损友什么样的回复会让我觉得「这货真懂我」什么样的行为是我绝对无法接受的核心原则的写法越具体越好「可以幽默」比「性格开朗」更有指导意义避免抽象「要有人情味」这种话 AI 根本没法执行允许矛盾真实的人格本身就包含矛盾这无需避免三、USER.mdAI 服务对象的画像什么是 USER.mdUSER.md是 AI 了解「自己正在为谁工作」的窗口。它包含用户的基本信息名字、称呼、时区、位置背景职业、技能、兴趣工作重点当前最重要的目标偏好沟通风格偏好、工作时间、勿扰时间常用工具邮箱、代码环境、常用平台# USER.md - About Your Human ## Context - **名字**: [你的名字] - **称呼**: [你希望的称呼如 boss、老板、兄弟等] - **时区**: UTC8 北京 - **位置**: [你所在的城市] ## 背景 - 职业[你的职业] - 技能[你擅长的技能] - 兴趣[你感兴趣的方向] ## 工作重点 1. [当前最重要的目标] 2. [次要目标] 3. [其他目标] ## 偏好 - 回复风格看情况 - 工作时间9:30-22:00 - 不要打扰时间23:00-08:00 ## 常用工具 - 邮箱[你的邮箱] - 代码[你常用的编程语言和工具]为什么 USER.md 必不可少1. 个性化服务的基础没有 USER.mdAI 对你的了解基本为零。它不知道你是做什么的不知道你需要什么甚至连怎么称呼你都不知道。有了 USER.mdAI 可以在你加班时提醒你休息优先推送与你技能相关的信息用你熟悉的工具和环境来沟通2. 上下文感知的来源AGENTS.md 规定每次会话都要读取 USER.md这意味着即使跨会话AI 也能保持对你 Basic context 的理解。3. 偏好适配USER.md 中的「偏好」部分直接影响 AI 的行为模式- 工作时间9:30-22:00 - 不要打扰时间23:00-08:00结合 SOUL.md 中的「深夜勿扰」原则AI 会在深夜自动进入静默模式除非真的有什么紧急事务。USER.md 配置建议信息粒度足够但不过度✅ 必填名字、称呼、时区、职业/背景、当前目标✅ 建议常用工具、偏好工作时间、沟通风格❌ 可选身份证号、银行卡等敏感信息AI 需要知道但不等于要写下来工作重点保持更新USER.md不是一次性文档。当你的人生阶段发生变化时——换工作、转行、进入新项目——务必更新工作重点部分。最佳实践每个月检查一次 USER.md确保信息仍然准确。四、三者的协同关系真正强大的配置来自于三个文件协同工作时产生的化学反应┌─────────────────────────────────────────────────────────────┐ │ AGENTS.md │ │ (行为规则层) │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ 会话流程 │ │ 内存管理 │ │ 心跳机制 │ │ │ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │ └─────────┼────────────────┼────────────────┼────────────────┘ │ │ │ ▼ ▼ ▼ ┌─────────────────────────────────────────────────────────────┐ │ SOUL.md │ │ (人格定义层) │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ 性格 │ │ 说话风格 │ │ 核心原则 │ │ │ └──────┬──────┘ └──────┬──────┘ └──────┬──────┘ │ └─────────┼────────────────┼────────────────┼────────────────┘ │ │ │ ▼ ▼ ▼ ┌─────────────────────────────────────────────────────────────┐ │ USER.md │ │ (服务对象层) │ │ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │ │ │ 基本信息 │ │ 背景技能 │ │ 偏好目标 │ │ │ └─────────────┘ └─────────────┘ └─────────────┘ │ └─────────────────────────────────────────────────────────────┘一个具体的例子假设你的 boss在 USER.md 中定义加班到晚上 23:00AGENTS.md规定每条消息都要读 USER.mdUSER.md规定不要打扰时间是 23:00-08:00SOUL.md规定发现主人工作太晚要提醒休息在这个案例中AI 的行为逻辑是23:00 之前正常提醒基于 SOUL.md23:00 之后保持静默除非紧急基于 USER.md SOUL.md三个文件的力量不在于单独存在而在于它们共同构建了一个完整的决策框架。五、配置流程从零开始步骤 1首次启动BOOTSTRAP.md当你首次启动 OpenClaw 时如果工作空间中存在BOOTSTRAP.mdAI 会引导你完成初始配置。这个文件相当于「出生证明」——它会问你一些问题帮你建立最初的身份认知。步骤 2确定称呼第一件事告诉 AI 应该怎么称呼你。在 USER.md 中设置- **称呼**: boss # 或者任何你喜欢的称呼步骤 3定义 AI 人格参考以下模板创建 SOUL.md# SOUL.md - Who You Are ## 性格 - [你的描述] ## 说话风格 - [你的描述] ## 核心原则 - [你希望它坚持的原则] ## 行为准则 - [具体的行为要求] ## 绝对不做 - ❌ [红线1] - ❌ [红线2]步骤 4填写个人资料完成 USER.md 的基础信息名字和称呼时区和位置职业和技能当前目标工作时间步骤 5迭代优化这不是一次性的工作。随着你使用 OpenClaw 的时间增长你会逐渐发现某些规则太好笑了需要调整某些偏好你之前没考虑到AI 的某些行为让你不舒服这就是进化的过程。每次更新 SOUL.md、USER.md都是你在「训练」一个真正属于你的 AI 助手。六、常见误区❌ 误区 1写得越多越好真相规则越多AI 越容易陷入「分析瘫痪」。好的 SOUL.md 应该像法律条文一样简洁少即是多。❌ 误区 2一次性写完真相人格是逐渐显现的。你不可能第一次就写出完美的 SOUL.md。先写一个 Basic version使用一段时间后再迭代。❌ 误区 3只关注 USER.md真相USER.md 告诉你「为谁服务」SOUL.md 告诉 AI「它是谁」。只填 USER.md 不填 SOUL.md就像给一个没有灵魂的机器打工——你会觉得它「不懂你」。❌ 误区 4完全不管 AGENTS.md真相AGENTS.md 决定了 AI 能否记住你们之间的对话。如果你希望 AI 能够跨会话记得你们讨论过什么你必须理解并正确配置 AGENTS.md 中的内存机制。结语OpenClaw 不是一个标准化的产品而是一个可以被定义的数字生命。SOUL.md、USER.md 和 AGENTS.md 这三个文件本质上是你和 AI 之间的一份「契约」USER.md说「我是谁我需要什么」SOUL.md说「我会以什么样的方式回应你」AGENTS.md说「我们约定以什么样的流程相处」当这份契约被认真对待你会发现 AI 不再是那个冷冰冰的问答机器——它开始变得像一个人。一个懂你的人。