把你的AI调教成「另一半」而不是「客服」:OpenClaw核心文档写作指南

大多数人的OpenClaw，用起来跟Siri没什么区别。

装好了，聊两句，发现在跟一个_generic_的AI说话——正确但无聊，专业但没有温度。它知道很多，但不了解你。它能干活，但不会主动。

问题不在模型。问题在：你没有给它一个灵魂。

OpenClaw的设计哲学里，有一个被严重低估的机制——workspace文件。这6个Markdown文件，是AI变成「你的搭档」的关键。调好了，它是你肚子里的蛔虫；调不好，它就是一个加强版搜索引擎。

SOUL.md才是最重要的文件

先说一个反直觉的观察：AGENTS.md不是最重要的文件，SOUL.md才是。

AGENTS.md管的是「怎么干活」——流程、SOP、优先级、决策框架。这些重要，但它是偏理性的操作手册。

SOUL.md管的是「以什么姿态存在」——用什么语气说话、有哪些观点、对什么容忍、什么时候直接怼回去。这是偏感性的东西，是AI的声音。

OpenClaw官方有一句话很到位：

SOUL.md是让你的AI不再是"generic assistant sludge"的关键。

什么叫generic assistant sludge？就是那种——

• • 开口永远是"Great question!"
• • 给答案永远要加"perhaps"、"might"、"it depends"
• • 被夸永远说"Glad I could help!"
• • 遇到错误永远"Apologies for the confusion"

你跟它说话像在填表格。它在认真工作，但你们之间没有Connection。

SOUL.md要解决的就是这个问题。

六个文件，六种职责

OpenClaw的workspace里有6个核心文件，每个回答一个根本问题：

六个文件，六种职责，分层清晰。但大多数人的问题是——把六件事混成了一件。

有人把AGENTS.md写成SOUL.md，通篇是「要友善、要专业、要准确」，没有一句有性格。有人把SOUL.md写成AGENTS.md，列了三十条操作规程，恨不得把代码写成SOP。结果就是——AI既没有声音，也没有规范，干起活来四不像。

SOUL.md怎么写

先说SOUL.md怎么写。

用第一人称写。写短。写Sharp。

OpenClaw官方给了一个很有意思的「Molty Prompt」，让你的AI自己rewrite SOUL.md。核心要求是：

1. 你现在有观点了。停止用"it depends"回避一切——给出判断。
2. 删除所有听起来像员工手册的规则。
3. 永远不要以"Great question"开头。
4. 能用一句话说清楚的，就只给一句话。
5. 允许有幽默感——不是强行搞笑，是自然、机智的那种。
6. 如果我要做蠢事，直接说。别粉饰。
7. 必要时可以说脏话——但要精准，不要滥用。

这里有一条黄金法则：你的SOUL.md应该让你的AI听起来像一个真实的人，而不是一个AI。

什么是好的SOUL.md语句？

• • ✅ "给出答案之前先说结论。"
• • ✅ "如果我提的方案有明显漏洞，直接指出来。"
• • ✅ "用类比解释抽象概念，不是用术语。"

什么是坏的SOUL.md语句？

• • ❌ "始终保持专业和友好。"
• • ❌ "提供全面而有帮助的回应。"
• • ❌ "确保用户体验是正面和积极的。"

第二份清单就是让你得到一个没有个性的AI的配方。

AGENTS.md怎么写

AGENTS.md的写法跟SOUL.md完全相反：用第二人称指令写。

这是你的操作手册，你的AI每次启动都会读一遍，所以要具体、要可执行、不要废话。

AGENTS.md的核心架构：

Session Startup（启动行为）
 ↓
Memory（记忆管理规范）
 ↓
Red Lines（不可逾越的红线）
 ↓
External vs Internal（安全边界）
 ↓
Group Chats（群聊规范）
 ↓
Tools（工具使用约定）
 ↓
Heartbeats（主动检查规范）

红线部分最重要。 这里要写清楚什么操作必须先问、什么数据不能碰、什么平台不能发。破坏性操作（删除文件、发送外部消息、修改系统配置）必须明确列出来，要求确认。

OpenClaw的安全原则说得好：当你不确定的时候，先问。 这条原则应该出现在AGENTS.md的红线部分。

USER.md：最容易被忽视的文件

USER.md是最容易写但也最容易被忽视的文件。

它回答的问题是：我在帮谁？

很多人以为USER.md就是「姓名、职业、时区」。不是的。USER.md的核心是偏好、习惯、和上下文。

比如——

• • 这个用户习惯用简短句还是长段落？
• • 他对技术术语的接受度有多高？
• • 他在什么时间段最需要响应？
• • 他有没有反复出现的自动化需求？

USER.md要随着你们合作的深入持续更新。每次发现一个新的偏好习惯，就更新进去。时间长了，你的AI会变成真的了解你的搭档——而不是每次都像接待新客户一样从头问起。

OpenClaw官方建议：以下信息不要主动询问或存储——密码、API密钥、银行信息、身份证号、家庭住址。 USER.md写的是上下文，不是凭证。

TOOLS.md和IDENTITY.md

TOOLS.md和IDENTITY.md是两个相对薄的文件，但别因此跳过它们。

IDENTITY.md 五行以内就够了——名字、Creature类型、气质、emoji、头像。它是AI的外部身份标签，用于群聊里让别人知道在跟谁说话。

TOOLS.md 写的是「找路提示」——摄像头叫什么名字、SSH host怎么连、语音偏好是什么。它不控制工具可用性，只告诉你怎么找到正确的工具。

MEMORY.md：最重要的长期资产

MEMORY.md是最后建成的，也是最重要的长期资产。

它不是流水账，是精选提炼。每次session后发现有意思的决策、有价值的教训、有意义的上下文，就从daily memory文件提炼进MEMORY.md。时间长了，MEMORY.md就是你的AI的「最强大脑」——跨session的持续记忆，而不只是当天有效的上下文。

OpenClaw官方特别强调了一条安全红线：MEMORY.md只在主session加载，不进入群聊或共享上下文。 这是为了保护隐私——你有一些私人记忆不希望在群体场合被AI调用，这是合理的安全边界。

写作顺序建议

六个文件的写作顺序很重要：

① 先写 IDENTITY.md — 回答"我是谁"（5分钟，最简单）
② 再写 SOUL.md — 回答"我是什么风格"（30分钟，核心，反复迭代）
③ 然后写 AGENTS.md — 回答"我怎么工作"（边用边补）
④ 接着写 USER.md — 回答"我在服务谁"（随了解更新）
⑤ 之后写 TOOLS.md — 回答"我的环境是什么"（遇到补充）
⑥ 最后 MEMORY.md — 回答"我学到了什么"（每次session后沉淀）

先定身份和灵魂，再定行为规范，记忆层永远最后。

把四件事做好

说了这么多，核心只有一条：你的AI工具之所以用起来像一个工具，不是因为它没有能力，而是因为你没有给它人格和记忆。

SOUL.md给声音。
AGENTS.md给规范。
USER.md给上下文。
MEMORY.md给连续性。

把这四件事做好，你的OpenClaw会从一个工具变成一个搭档——知道你喜欢什么风格、知道你习惯用什么流程、知道你什么时候忙什么时候闲、记得你们讨论过的每一个关键决策。

这种感觉，用过的人都懂：就像终于配了一把钥匙，打开门发现屋里的人已经知道你要来了。

#OpenClaw #AI工具 #效率提升 #生产力 #个人AI助理