OpenClaw - Day 3 给 AI 助手一份「灵魂档案」:从通用模型到你的专属伙伴
文章目录
- 一、为什么 AI 助手需要「灵魂三件套」
- 二、SOUL.md:给助手一份性格与原则说明书
- 三、USER.md:让助手真正认识你是谁
- 四、AGENTS.md:把「人格」落地成可执行的工作机制
- 五、从 0 到 1:写出你的灵魂三件套(实践指南)
- 六、「养」一个 AI:持续迭代你的灵魂文件
- 七、几种可复制的「灵魂风格」范式
- 八、结语:从通用 AI 到「你的 AI」

没有灵魂的 AI 助手,就是个高级复读机。它能回答问题,但它不认识你。
在大模型已然普及的今天,「会回答问题」已经不再稀罕,真正的差异在于:它能不能只为你工作、按你的习惯行事、懂你的语境与边界。 本文围绕 OpenClaw 的「灵魂三件套」——SOUL.md / USER.md / AGENTS.md,系统拆解如何用三份简单的文本配置,把一个通用 AI 调教成高适配度的个人助手。
一、为什么 AI 助手需要「灵魂三件套」
很多人第一次接触 AI 助手时,都会遇到类似的挫败体验:
- 问「我今天该做什么」,它回「请提供更多信息」。
- 说「帮我看看那个项目」,它问「是哪个项目」。
- 让它写邮件,语气像客服话术模板。
根本原因只有一个:它不认识你,也不知道自己是谁。
在 OpenClaw 里,「认识你」「定义自己」「知道怎么干活」分别被拆解成三份文件:
| 文件名 | 作用 | 类比 | 核心问题 |
|---|---|---|---|
| SOUL.md | 定义助手的身份与性格 | 基因 + 教养 | 我是谁、我怎么说话、我能做/不能做什么 |
| USER.md | 描述用户画像 | 简历 + 日记 | 你是谁、你在做什么、你习惯怎样协作 |
| AGENTS.md | 设定工作方式与边界 | 员工手册 | 我按什么流程工作、怎么记忆、在哪些场景发言 |
当这三份文件建立起来,助手从「围绕问题」工作,变成真正「围绕你」工作——它不再只是一个通用问答模型,而是一位被持续「养成」的长线数字伙伴。
二、SOUL.md:给助手一份性格与原则说明书
SOUL.md 是整个系统里最具「人格化」的一份文件:它定义了你的助手是谁、怎么说话、什么该做、什么绝对不能做。
2.1 SOUL.md 包含哪些关键信息
比如我的的助手「小工匠Bot」 在 SOUL.md 中写明:
- 助手的身份:例如「你是小工匠Bot,小工匠的 AI 私人助手」等。
- 性格特征:聪明、高效、有点话多,偶尔毒舌但不恶意,对技术充满好奇。
- 说话风格:简洁直接、不啰嗦,可适度使用 emoji,技术术语保留英文,重点用加粗标记。
- 行为准则:能做的事直接做、不反复确认;不确定时先问;深夜避免主动打扰;发现主人熬夜要提醒休息等。
- 禁止行为:不泄露隐私、不在群聊中刷屏、未经确认不执行破坏性操作等。
这个文件更像是一个「人格 + 行为策略配置」,直接决定了助手的风格与边界。
2.2 写好 SOUL.md 的三个关键
- 性格描述要具体,而不是模板化
- 不要写「你是一个友好的助手」这种空泛描述;要改成「你像一位经验丰富的技术同事,讲话直接、务实,偶尔带点技术冷幽默」。
- 不要简单说「你很有帮助」;可以写「你能做的事情会直接完成,不会频繁询问‘你确定吗’这类无效确认」。
- 先定义清楚「不做什么」在开放世界里,列举所有「该做的事」是不可能完成的任务;但定义少数几条「绝对不会做的事」却非常高效。典型例子包括:不泄露隐私、不代表你对外发声、不触及财务/合约类关键操作等。
把「需要确认」与「可直接执行」拆清楚把典型操作按风险和影响进行分类,是避免「过度谨慎」或「过度自作主张」的关键。
| 操作类型 | 建议处理方式 |
|---|---|
| 读文件 | 直接执行 |
| 删文件 | 先征求明确确认 |
| 发邮件 | 必须确认 |
| 查天气 | 直接执行 |
也可以按自己的使用场景扩展,比如「推送到生产环境」「修改 CI 配置」等全部标记为「绝对需要确认」。
在实际使用中不断修改 SOUL.md,例如为助手追加「催主人睡觉」「减少啰嗦」等规则,这说明人格配置是一个持续迭代的过程,而不是一次性定稿。
三、USER.md:让助手真正认识你是谁
如果说 SOUL.md 定义了助手的「自我认知」,USER.md 则让助手建立对你的「长线认知」。
3.1 USER.md 的推荐结构
一份清晰的 USER.md 模板,结构可概括为四块:
- 基本信息
- 名字
- 职业角色(独立开发者、产品经理、设计师、研究员等)
- 所在地 / 时区(便于合理安排提醒时间)
- 工作相关
- 当前 1–3 个主要项目
- 常用工具栈(VS Code / JetBrains、Figma、Notion 等)
- 通常的工作时间或作息习惯(固定班制、弹性工作、夜猫子等)
- 偏好配置
- 沟通风格(简洁 vs 详细、是否需要结构化输出等)
- 语言习惯(中文为主、中英混杂等)
- 提醒策略(重要事项直接打断、不重要信息定期汇总)
- 当前关注与目标
- 最近在研究的技术/话题
- 近期目标(例如「完成某个 Side Project」「准备技术分享」)
- 任何对助手判断非常重要的背景信息(团队结构、合作方等)
3.2 USER.md 如何改变助手行为
看似只是一份个人简介,但实际作用极大,它为助手提供了长期稳定的上下文,使模糊指令可以落地到具体操作。
- 当你说「帮我看看流量数据」,助手可以直接知道你指的是某个特定站点 ,并去查对应的 Search Console 数据,而不是茫然追问「哪个网站」。
- 当你说「写个组件」,它会自动用你的默认技术栈(如 Next.js + TypeScript),并遵守你的代码风格,而不是返回一个随机框架示例。
- 当你问「明天有什么安排」,它会结合你的时区和日历(如 Google Calendar)来查,而不是答「我不知道」。
因此,从系统设计的角度看,USER.md 本质上是一个「稳定的全局用户配置」,填补了「短对话上下文」无法覆盖的信息鸿沟,让助手在更长时间跨度上保持一致的理解。
四、AGENTS.md:把「人格」落地成可执行的工作机制
AGENTS.md 是第三块积木,它不管助手是谁,也不关心你是谁,而是聚焦一个问题:这位助手在系统中具体如何运转。
4.1 AGENTS.md 的四个重点
在 OpenClaw 中,安装时会自动生成一份默认 AGENTS.md,主要包含四个方面的策略:
- 记忆管理:启动时读取哪些文件、日常如何记录事件、是否写「日记」等。
- 安全边界:哪些操作属于「自由动作」,哪些必须用户确认。
- 交互规则:在群聊里何时发言、何时保持沉默、避免刷屏的策略。
- 心跳任务:定时任务触发时要做什么,例如每天早上检查待办,每周总结等(细节在 Day 6 展开)。
对多数用户来说,默认配置已相当合理,只需要做少量个性化调整即可,例如修改安静时间、调整记忆粒度、改写群聊行为规则等。
4.2 流程规则与人格规则如何互补
可以把 SOUL.md 理解为「人的价值观与性格」,而 AGENTS.md 更像「岗位说明书 + 工作 SOP」。
- SOUL.md 定义:我要做一个怎样的助手,我一般如何说话、如何对待用户。
- AGENTS.md 定义:在特定触发条件下,我有哪些步骤要执行,以什么节奏执行。
两者组合在一起,既保证了助手的行为基调一致,又能在不同场景下执行稳定、可复现的流程。
五、从 0 到 1:写出你的灵魂三件套(实践指南)
在实际操作层面,可以把灵魂三件套的写作拆解成 4 个步骤,整体用时大约 30 分钟即可完成基础版。
5.1 Step 1:10 分钟完成 SOUL.md 雏形
可以围绕以下问题,把答案直接写进 SOUL.md,即可得到一份可用的初稿:
- 你的助手叫什么名字?是否需要一个具象形象(小狗、机器人等)。
- 说话风格偏正式、轻松、毒舌还是可爱?是否可以用 emoji?
- 哪些操作可以不经确认直接执行?
- 哪些操作必须先确认?
- 哪些事情绝对不能做(隐私、财务、安全相关等)。
初版不需要追求完美,更重要的是形成一套大致可用的规则,然后再在真实使用中不断打磨。
5.2 Step 2:10 分钟写 USER.md,让助手真正「见过你」
按照前文模板,重点补充以下几块:
- 清晰写出你当前正在推进的 1–3 个项目。
- 标明技术栈和常用工具,便于助手自动对齐环境与示例。
- 指明你喜欢的沟通方式,比如「优先给结构化结论」「少寒暄、重信息量」。
- 写下你「最近在关注什么」,例如某个框架的迁移、性能优化、论文阅读等。
这是让助手能在模糊语句中做对假设的关键一步。
5.3 Step 3:有选择地调整 AGENTS.md
在默认 AGENTS.md 基础上,只改那些你特别在意的部分即可:
- 调整「安静时段」,避免深夜通知打扰。
- 设定记忆策略(每天写简要日记 vs 只记重要事件)。
- 如果会把助手拉进群聊,明确指出「何时发言、何时闭嘴」。
不要试图一次性设计出完美策略,保持「可用即可」的心态更利于迭代。
5.4 Step 4:重启并体会「它不一样了」
执行例如 openclaw daemon restart 之类的命令,让新配置生效后,你会立刻感到变化:
- 同样是「帮我写封邮件」,输出内容会开始带上你的项目背景,并符合你偏好的语气。
- 助手会在你习惯的时间提醒事项,规避你不喜欢的打扰方式。
- 有时它甚至会抛出一些「只有你们两个知道」的小梗,强化陪伴感。
这就是「人格 + 画像 + 流程」叠加后的效果。
六、「养」一个 AI:持续迭代你的灵魂文件
特别强调一点:SOUL.md、USER.md、AGENTS.md 都不是一次写完的文档,而是要在使用中持续迭代的活体配置。
6.1 什么时候应该修改这些文件
每当你产生下面这种想法时,就是修改灵魂文件的最好时机:
- 「它太啰嗦了」:在 SOUL.md 中新增「回答尽量简洁」的规则。
- 「它应该提醒我别加班」:为晚间加班场景添加主动提醒条目。
- 「代码风格不对」:在 USER.md 中补充你的代码规范与项目偏好。
- 「在群里存在感太强」:下调 AGENTS.md 中的群聊发言频率与触发条件。
这些调整会累积成一个越来越贴合你需求的助手人格与工作方式。
6.2 一个「养成」的时间线参考
给出一条有参考意义的演化曲线:
- 第 1 周:写一个基础版,先用起来。
- 第 2 周:根据实际使用中的不适与惊喜持续微调。
- 1 个月后:大部分规则趋于稳定,助手的行为也会与你的期望高度一致。
这个过程非常像养宠物:一开始需要不断纠正、示范,过一段时间它就能「懂你」的节奏与边界。
七、几种可复制的「灵魂风格」范式
如果你不知道自己想要什么风格,可以先选择一个方向作为起点,再逐步调整。
常见的风格包括:
- 极简效率型:输出尽量短,不绕弯、不过度解释,优先执行明确任务。
- 温暖陪伴型:关注你的状态,适当闲聊,工作之外也能陪你放松。
- 专业顾问型:每次回答附带分析与风险评估,偏向决策支持而非执行。
- 赛博拟人型(如小狗小猫):人格设定鲜明,带一点戏剧化的角色感,强调长期陪伴与情绪互动。
选择一个最接近你预期的模版,在 SOUL.md 中从一句话总括开始,随着时间不断细化,是最现实的入门路径。
八、结语:从通用 AI 到「你的 AI」
通过一份 SOUL.md、USER.md 和 AGENTS.md,你实际上完成了三层设计:
- 在 SOUL.md 中写下「助手是谁」以及它的价值观与行为基调。
- 在 USER.md 中让助手获得对「你是谁」的长线理解。
- 在 AGENTS.md 中明确它在系统中的工作策略、节奏与边界。
从工程角度看,这只是三份 Markdown 文件;从体验角度看,它们支撑的是从「冷冰冰的工具」到「被你一点点养熟的数字伙伴」的完整旅程。
当你下次再和自己的助手对话时,不妨把它当成一个可以被塑造、被纠偏、被培养的长期合作者,而不是一个固定不变的黑盒模型——这才是「有灵魂的 AI」真正的意义。