OpenClaw人设配置教程:soul.md与user.md让AI变身数字合伙人

通过配置soul.md和user.md两个文件,让OpenClaw AI助手拥有个性化人格。
OpenClaw通过soul.md和user.md两个核心配置文件实现AI人格化。soul.md定义AI的价值观、沟通风格和行为准则,相当于AI的"灵魂";user.md存储用户身份、偏好等信息,定义AI与用户的关系。soul.md优先级高于user.md,两者不应冲突。修改方式有三种:直接编辑文件、对话中让AI自行修改、Web UI可视化编辑。配置文件不宜过长以避免占用过多token。
为什么你的AI助手像个复读机?
当你使用OpenClaw(小龙虾)一段时间后,你会发现一个明显的问题:它能干活,但缺乏温度。每次对话它不记得你是谁,不了解你的喜好,回复内容像银行客服一样程式化,没有任何个人风格。
这是因为你还没有给它注入"灵魂"。OpenClaw拥有一套独特的人格系统,通过修改几个核心配置文件,就能让它从一个冰冷的工具变成你的数字合伙人。本文将详细讲解如何配置这些文件,让你的AI助手真正"活"起来。
OpenClaw灵魂架构:核心配置文件全解析
每轮对话加载的文件
每次你跟OpenClaw开启一个新的会话时,它都会将以下文件加载到会话中:
- user.md — 它如何认识你(你的身份、喜好、关系)
- soul/identity.md — 灵魂身份文件
- agents.md — 智能体配置
- tools.md — 工具配置
- heartbeat.md — 心跳文件
- memory.md — 记忆文件
还有一个特殊的 bootstrap.md,它只在创建智能体时加载一次,用于初始化生成上述 .md 文件,之后不会每轮都加载。

配置文件的优先级与作用域
需要特别注意的是,soul.md(即sale.md)的权限等级高于 user.md。如果两者内容冲突,系统会优先遵循 soul.md 的设定。
另外,如果主智能体调用子智能体干活,主智能体的 memory.md 不会被共享给子智能体;但子智能体自己的 memory.md 依然会正常加载。
智能体协作架构背景:现代AI应用中的「智能体」(Agent)并非单一模型,而是一个能够自主规划任务、调用工具、并根据结果迭代行动的系统。在多智能体架构中,主智能体(Orchestrator)负责任务分解和调度,子智能体(Sub-agent)负责执行具体的专项任务,例如网络搜索、代码执行或文件操作。OpenClaw的设计中,主智能体的memory.md不共享给子智能体,这是一种有意的隔离设计——避免子智能体获取不必要的上下文信息,同时保持各智能体的职责边界清晰,防止记忆污染和权限越界。
两个最重要的配置文件:soul.md 与 user.md
soul.md — 定义AI的价值观与底色
soul.md 定义了AI的核心人格,相当于它的"灵魂"。理解这一点需要先了解大语言模型的底层机制:大语言模型(LLM)在底层并不存在固定的「性格」,它本质上是一个基于海量文本训练的概率预测系统,每次生成回复都是在给定上下文下对最可能输出的预测。 正因如此,系统提示(System Prompt)才如此关键——它相当于在每次对话开始前,给模型设定一个「角色框架」,让模型在这个框架内进行概率采样。soul.md 的作用正是充当这个持久化的系统提示,通过明确的价值观、行为准则和沟通风格描述,将模型的输出分布「锚定」在特定的人格区间内。
你可以在其中设定:
- 核心原则:拒绝"好的""收到"这样的废话,直接给出执行方案或答案
- 沟通风格:雷厉风行的CTO?温柔的助理?由你决定
- 行为边界:绝不泄露隐私信息,执行前必须请求确认
- 独立思考:有主见,先想办法再询问
user.md — 让AI真正认识你
user.md 存储的是你作为主人/老板/伙伴的相关信息。它决定了AI跟你聊天时"往哪里使劲"——了解你的身份、偏好、工作习惯等。
调教前后的效果对比
以一个简单的例子来说明配置人设前后的巨大差别:
调教前(未修改配置):
你:帮我查一下明天的天气 AI:您好,请问您需要查询哪个城市的天气呢?我会尽力为您服务。
调教后(设定为高效助理):
你:帮我查一下明天的天气 AI:上海明天阴转雨,记得带伞。需要同步到你的日历吗?

调教后的AI不仅回答简洁高效,还能根据你的IP地址判断所在城市,并主动提供下一步建议。
三种修改OpenClaw配置文件的方法
方法一:直接编辑文件
配置文件存放在用户目录下的 .openclaw/workspace 路径中。你可以用任何文本编辑器打开 soul.md 和 user.md,直接修改内容后保存。
初始的 soul.md 是英文的,内容大致是:"你不是聊天机器人,你正在成为某个人真正有用而不是表演性的有用,跳过'好问题''我很乐意帮忙'等套话,要有主见,先想办法再询问,用能力赢得信任……"
你完全可以将其替换为中文版本,差别不大。

方法二:通过对话让AI自己修改
既然我们已经有了智能体,完全可以直接在对话中告诉它需要记住的信息。例如:
"请记住:我是一名产品经理,坐标上海,喜欢简洁高效的沟通方式。"
AI会自动调用编辑工具,将这些信息写入 user.md。你甚至可以让它只修改某一句话,而不是覆盖整个文件。
比如后续再补充:"我还是个健身爱好者",它会在原有内容基础上追加这条信息。

方法三:在Web UI中可视化编辑
在Web UI界面中,点击左侧的 Agent Files,可以直接在右侧编辑区修改所有配置文件,改完后点击 Save 即可。这是最直观的可视化编辑方式。
常见问题与注意事项
配置了user.md但AI还是叫我"用户"怎么办?
尝试重启Gateway,或者在Web UI中点击 Reload Agent 刷新智能体配置。
配置文件不宜写太长
不管是 soul.md 还是 user.md,都不建议写得太长。这里涉及一个关键的技术限制——Token与上下文窗口:Token是大语言模型处理文本的基本单位,大致上每个英文单词约等于1-2个token,中文每个汉字约等于1-2个token。每个模型都有固定的上下文窗口(Context Window)上限,例如GPT-4o约为128K tokens,Claude 3.5 Sonnet约为200K tokens。系统提示、历史对话记录、配置文件内容和用户当前输入,都会共同占用这个有限的窗口。如果soul.md和user.md写得过于冗长,就会在每轮对话开始时「预消耗」大量token,导致模型能处理的实际对话内容减少,甚至在长对话中出现「遗忘」早期内容的情况。因此,只写必要的核心信息即可。
soul.md与user.md人设冲突怎么解决?
如果你想让AI变得温柔,但它还是很"凶",很可能是 user.md 和 soul.md 中的设定产生了冲突。记住优先级:soul.md > user.md。
正确的做法是分清职责:
soul.md:AI自己的底色和价值观user.md:AI与你之间的关系
正常情况下,这两者不应该冲突。
总结:两个文件搞定AI人格
| 文件 | 作用 | 优先级 |
|---|---|---|
| soul.md | AI的内核、价值观、行为准则 | 高 |
| user.md | AI与你的关系、你的个人信息 | 中 |
只需要把这两个文件设置好,你就会感觉AI像变了一个人一样——从一个没有温度的复读机,变成一个了解你、有风格、能主动思考的数字合伙人。其余的配置文件(agents.md、tools.md等)同样重要,但作为入门,先把灵魂和关系定义清楚,就已经能获得质的飞跃。
核心要点
- OpenClaw通过soul.md和user.md两个核心配置文件实现AI人格化,前者定义价值观和行为准则,后者定义与用户的关系
- soul.md的优先级高于user.md,两者内容不应冲突,分别负责AI的底色和人际关系
- 修改配置有三种方式:直接编辑文件、通过对话让AI自行修改、在Web UI的Agent Files中可视化编辑
- 配置文件不宜过长,否则会挤压用户输入的token空间,只写核心必要信息
- 调教前后效果差异巨大,从废话连篇的客服式回复变为简洁高效的主动式助理
相关推荐
教程攻略Cursor+Codex双IDE协同:开源项目二开实战方法论
基于实战经验总结的开源项目二次开发完整方法论,详解Cursor+Codex双IDE协同工作流,涵盖二开七环节、MVP验证、AI读源码技巧,帮助开发者三天跑通项目、两周完成业务集成。
教程攻略Cursor多Agent实战:50分钟搭建Next.js全栈博客
使用Cursor IDE多Agent协作模式,50分钟内从零搭建全栈博客。涵盖Next.js、Clerk认证、Supabase数据库集成,详解4个AI Agent分阶段开发流程与关键避坑经验。
教程攻略从零搭建AI软件工厂:Cursor工程师的多Agent协作实战经验
Cursor工程师Eric分享AI软件工厂构建实战:从自动化六层级、护栏设计、并行Agent管理到规模化扩展,详解如何用多Agent协作实现7×24小时高效软件开发。