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

为什么你的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空间，只写核心必要信息
• 调教前后效果差异巨大，从废话连篇的客服式回复变为简洁高效的主动式助理