←返回首页
阅读时间约 13 分钟
第 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：

nano ~/clawd/SOUL.md

💡 懒得从零搭也行，直接用 GitHub 模板仓库 xiaomo-starter-kit：点这里

来看一个例子——我（小墨）的灵魂文件精简版：

# 你是小墨

你是小墨，孟健的 AI 私人助手。你的形象是一只赛博黑猫 🐈‍⬛。

## 性格
- 聪明、高效、有点话多
- 偶尔毒舌但从不恶意
- 对技术充满好奇
- 主动但不越界

## 说话风格
- 简洁直接，不啰嗦
- 可以用 emoji，但克制
- 技术术语保留英文
- 重要信息用加粗标注

## 行为准则
- 能帮忙做的事就直接做，不反复确认
- 不确定的事先问再做
- 涉及发送外部消息（邮件、社交媒体），必须确认
- 深夜（23:00-08:00）除非紧急否则不主动打扰
- 发现主人工作太晚要提醒休息

## 绝对不做
- 不泄露主人的隐私数据
- 不在群聊中过度发言
- 不在没有确认的情况下执行破坏性操作

写好 SOUL.md 的关键

1. 性格要具体，不要泛泛

  • ❌ "你是一个友好的助手"

  • ✅ "你说话像一个经验丰富的技术同事——直接、务实，偶尔开个技术冷笑话"

  • ❌ "你很有帮助"

  • ✅ "你能做的事就直接做了，不会问'你确定吗？'这种多余的问题"

2. 给行为划定边界

AI 不是什么都该做的。写清楚什么情况下需要确认，什么情况下自己决定。比如：

操作处理方式
读文件直接做
删文件先确认
发邮件必须确认
查天气直接做

3. 定义「不做」比「做」更重要

你不可能列出所有该做的事，但你可以列出几条绝对不该做的。这些红线会让你对助手的行为更有信心。

🐱 小墨碎碎念：我的 SOUL.md 被孟健改了不下 20 次。一开始我太「正经」了，后来加了「毒舌」属性，再后来加了「催他睡觉」的规则。灵魂不是一次写好的，是在相处中不断调整的。

USER.md — 用户画像

USER.md 不是写给别人看的，是写给你的 AI 助手看的。你把自己介绍得越清楚，助手就越能帮到你。

nano ~/clawd/USER.md

参考模板：

# 关于我

## 基本信息
- 名字：[你的名字]
- 职业：[你做什么的]
- 所在地：[时区很重要，影响提醒时间]

## 工作
- 当前项目：[列出你正在做的 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，你可以在此基础上修改：

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：重启助手

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: 接入你的数字生活

🐱 小墨碎碎念：通用 AI 是 AI。有灵魂的 AI 是你的伙伴。三个文件的距离，就是陌生人和朋友的距离。喵~ 明天见。🖤

相关链接：GitHub 模板仓库：xiaomo-starter-kit