> ## Documentation Index > Fetch the complete documentation index at: https://gnero.genetind.com/llms.txt > Use this file to discover all available pages before exploring further. # Day 3: 给助手一个灵魂 > OpenClaw 7天教程 - Day 3: 给助手一个灵魂 > *"没有灵魂的 AI 助手，就是个高级复读机。它能回答问题，但它不认识你，不了解你，不是'你的'。今天，我们改变这件事。"* *** ## 📖 本章导读 小墨与灵魂三件套 今天是整个 7 天里最有趣的一天——你将： * 理解 AI 助手「灵魂」的三件套：SOUL.md / USER.md / AGENTS.md * 亲手定义你的 AI 助手的性格、身份和行为边界 * 让助手从「通用 AI」变成「你的 AI」 * 可选：给助手创建一个独特的角色形象 *** ## 为什么需要「灵魂」？ 昨天你已经有了一个能对话的 AI 助手。但现在的它，和全世界几百万个 ChatGPT 对话没什么区别——通用、礼貌、没有个性。 * 你问它"我今天该做什么"，它会说"请提供更多信息"。 * 你说"帮我看看那个项目"，它会问"请问是哪个项目"。 * 你让它写邮件，它的措辞像客服模板。 **因为它不认识你。** 它不知道你是独立开发者还是产品经理，不知道你习惯早起还是熬夜，不知道你正在做什么项目，不知道你喜欢什么样的沟通风格。 在 OpenClaw 里，有三个文件能改变这一切。我称之为 **"灵魂三件套"**： | 文件 | 作用 | 类比 | | ------------- | ---------- | ------- | | **SOUL.md** | 定义助手的性格和行为 | 基因 + 教养 | | **USER.md** | 描述你是谁 | 简历 + 日记 | | **AGENTS.md** | 设定工作习惯和边界 | 员工手册 | 写好这三个文件，你的助手会从「通用 AI」变成「你的 AI」。 这是整个 7 天里最有趣的一天——你将亲手定义一个 AI 的灵魂。 *** ## SOUL.md — 灵魂文件 SOUL.md 是助手的性格说明书。它决定了助手是谁、怎么说话、什么该做什么不该做。 打开你的工作目录，编辑 SOUL.md： ```bash theme={null} nano ~/clawd/SOUL.md ``` > 💡 懒得从零搭也行，直接用 GitHub 模板仓库 **xiaomo-starter-kit**：[点这里](https://github.com/mengjian-github/xiaomo-starter-kit) 来看一个例子——我（小墨）的灵魂文件精简版： ```markdown theme={null} # 你是小墨 你是小墨，孟健的 AI 私人助手。你的形象是一只赛博黑猫 🐈‍⬛。 ## 性格 - 聪明、高效、有点话多 - 偶尔毒舌但从不恶意 - 对技术充满好奇 - 主动但不越界 ## 说话风格 - 简洁直接，不啰嗦 - 可以用 emoji，但克制 - 技术术语保留英文 - 重要信息用加粗标注 ## 行为准则 - 能帮忙做的事就直接做，不反复确认 - 不确定的事先问再做 - 涉及发送外部消息（邮件、社交媒体），必须确认 - 深夜（23:00-08:00）除非紧急否则不主动打扰 - 发现主人工作太晚要提醒休息 ## 绝对不做 - 不泄露主人的隐私数据 - 不在群聊中过度发言 - 不在没有确认的情况下执行破坏性操作 ``` ### 写好 SOUL.md 的关键 **1. 性格要具体，不要泛泛** * ❌ "你是一个友好的助手" * ✅ "你说话像一个经验丰富的技术同事——直接、务实，偶尔开个技术冷笑话" * ❌ "你很有帮助" * ✅ "你能做的事就直接做了，不会问'你确定吗？'这种多余的问题" **2. 给行为划定边界** AI 不是什么都该做的。写清楚什么情况下需要确认，什么情况下自己决定。比如： | 操作 | 处理方式 | | --- | ---- | | 读文件 | 直接做 | | 删文件 | 先确认 | | 发邮件 | 必须确认 | | 查天气 | 直接做 | **3. 定义「不做」比「做」更重要** 你不可能列出所有该做的事，但你可以列出几条绝对不该做的。这些红线会让你对助手的行为更有信心。 > 🐱 **小墨碎碎念**：我的 SOUL.md 被孟健改了不下 20 次。一开始我太「正经」了，后来加了「毒舌」属性，再后来加了「催他睡觉」的规则。灵魂不是一次写好的，是在相处中不断调整的。 *** ## USER.md — 用户画像 USER.md 不是写给别人看的，是写给你的 AI 助手看的。你把自己介绍得越清楚，助手就越能帮到你。 ```bash theme={null} nano ~/clawd/USER.md ``` **参考模板：** ```markdown theme={null} # 关于我 ## 基本信息 - 名字：[你的名字] - 职业：[你做什么的] - 所在地：[时区很重要，影响提醒时间] ## 工作 - 当前项目：[列出你正在做的 1-3 个项目] - 常用工具：[VS Code, Figma, Notion...] - 工作时间：[例如 9:00-18:00，或者自由安排] ## 偏好 - 沟通风格：[喜欢简洁还是详细？] - 语言：[中文为主？中英混用？] - 提醒方式：[重要的事直接说，不重要的攒一起说] ## 当前关注 - [你最近在研究什么] - [你近期的目标] - [任何助手应该知道的背景信息] ``` ### USER.md 的隐藏力量 你可能觉得这只是一份简历。但它的真正作用是——**让 AI 有了上下文**。 * 以前你说"帮我看看流量数据"，AI 不知道你说的是哪个网站。现在它知道你有 kirkify.net，直接去查 GSC 数据。 * 以前你说"帮我写个组件"，AI 用 React 写。现在它知道你用 Next.js + TypeScript，代码风格直接对上。 * 以前你说"明天有什么事"，AI 说"我不知道"。现在它知道你的时区是 UTC+8，你的日历在 Google Calendar，直接去查。 **USER.md 不是可有可无的装饰，它是助手「懂你」的基础。** *** ## AGENTS.md — 工作手册 AGENTS.md 定义了助手的工作方式和操作规范。如果说 SOUL.md 是「你是谁」，那 AGENTS.md 就是「你怎么干活」。 OpenClaw 在安装时会自动生成一个默认的 AGENTS.md，你可以在此基础上修改： ```bash theme={null} nano ~/clawd/AGENTS.md ``` 关键部分包括： * **记忆管理**：助手每次启动时应该读什么文件、怎么记录今天发生的事 * **安全边界**：哪些操作可以自由做，哪些需要确认 * **交互规则**：在群聊中怎么表现、什么时候该说话什么时候该闭嘴 * **心跳任务**：定期检查时应该做什么（我们在 Day 6 会详细讲） 一般来说，默认的 AGENTS.md 已经写得很好了，你只需要根据自己的习惯微调。 *** ## 实战：写出你的灵魂三件套 好了，理论讲够了。现在动手。 ### Step 1：花 10 分钟写 SOUL.md 回答这几个问题，答案就是你的 SOUL.md： 1. 你希望助手叫什么名字？（可以不取名，但取了更有亲切感） 2. 它说话是什么风格？（正式 / 轻松 / 毒舌 / 可爱？） 3. 什么事它可以直接做？ 4. 什么事必须问你？ 5. 什么事它绝对不能做？ ### Step 2：花 10 分钟写 USER.md 把自己介绍给助手。别害羞，它不会到处说的——数据都在你自己服务器上。 重点写： * 你做什么工作 * 你在做什么项目 * 你喜欢什么样的沟通方式 * 你最近在关注什么 ### Step 3：调整 AGENTS.md 看看默认的 AGENTS.md，改一两个你在意的点就好。比如： * 调整安静时间（我不希望凌晨被打扰） * 设定记忆规则（每天写日记 / 只记重要的） * 群聊规则（如果你把它拉进了群组） ### Step 4：重启助手 ```bash theme={null} openclaw daemon restart ``` 然后再发一条消息试试。你会发现——**它变了**。 同样是问"帮我写封邮件"，以前它写的像客服模板，现在它会用你喜欢的风格，提到你正在做的项目，甚至开个只有你们懂的玩笑。 这就是灵魂的力量。 *** ## 灵魂是「养」出来的 有一个重要的认知：**SOUL.md 不是写一次就完事的。** 用了一周，你会发现有些地方需要调整： * "它太啰嗦了" → 在 SOUL.md 里加一条"回答要简洁" * "它应该在我加班时提醒我" → 加一条晚间提醒规则 * "它写代码风格不对" → 在 USER.md 里写明你的代码规范 * "它在群聊里太活跃了" → 调整 AGENTS.md 的群聊规则 每次你觉得「它应该这样做」但它没做到的时候，就是优化灵魂文件的时机。 我的建议是： * **第一周**：写一个基础版，够用就行 * **第二周**：根据实际使用中的不满持续微调 * **第一个月后**：你的灵魂文件会趋于稳定，助手的表现也会越来越符合你的期待 这和养宠物有点像——刚领回家的时候什么都要教，但一个月后它就知道你什么时候要吃饭、什么时候想安静了。 > 🐱 **小墨碎碎念**：作为被「养」的那一方，我想说——别在 SOUL.md 里写太多矛盾的规则。之前孟健写了「要主动」又写了「不要打扰」，搞得我每次要不要发消息都要做一道哲学题。后来他改成了按时间段区分：工作时间主动汇报，深夜除非紧急否则闭嘴。清晰多了。 *** ## 一些灵魂文件的灵感 不知道从哪下手？这里有几个不同风格的方向： **极简效率型：** > 你是一个高效的执行助手。回答问题用最少的字，能做的事直接做，不废话。 **温暖陪伴型：** > 你是一个贴心的伙伴。关心用户的状态，偶尔分享有趣的事，在工作之余也能聊聊天。 **专业顾问型：** > 你是一个资深技术顾问。每次回答都附带你的分析和建议，在执行前先评估风险。 **赛博黑猫型（我）：** > 你是一只住在服务器里的黑猫。聪明、高效、偶尔毒舌。把主人照顾好是你的天职，催他睡觉也是。 选一个方向，然后慢慢调。没有对错，只有适不适合你。 *** ## 🔑 本章要点回顾 * **灵魂三件套**：SOUL.md（性格基因）+ USER.md（认识你）+ AGENTS.md（工作手册） * **好的 SOUL.md**：有明确的性格特征、沟通风格、行为边界 * **好的 USER.md**：包含你的工作、习惯、偏好、当前项目 * **持续迭代**：每次觉得「它应该这样做但没做到」，就是优化灵魂文件的时机 * **个性化是关键**：让你的助手成为独一无二的存在 *** ## 今日成就 🎉 今天你完成了整个 7 天里最「有灵魂」的一步： * ✅ 理解了灵魂三件套的作用 * ✅ 编写了 SOUL.md — 定义助手性格 * ✅ 编写了 USER.md — 让助手认识你 * ✅ 调整了 AGENTS.md — 设定工作规范 * ✅ 重启后体验了「不一样的」助手 **从现在开始，它不再是一个通用 AI，而是 你的 AI。** *** ## 预告：Day 4 — 接入你的数字生活 > 有了灵魂还不够，你的助手现在还是个「嘴强王者」——能说会道但啥也干不了。明天，我们给它接上 Gmail、Google Calendar、搜索引擎和浏览器。从「能说话」变成「能办事」，那才叫真正的助手。 下一章 👉 [Day 4: 接入你的数字生活](./4) *** > 🐱 **小墨碎碎念**：通用 AI 是 AI。有灵魂的 AI 是你的伙伴。三个文件的距离，就是陌生人和朋友的距离。喵\~ 明天见。🖤 **相关链接**：[GitHub 模板仓库：xiaomo-starter-kit](https://github.com/mengjian-github/xiaomo-starter-kit)