宝塔 OpenClaw 怎么定人格和身份?SOUL.md、IDENTITY.md、USER.md 身份文件配置
想让 OpenClaw(昵称「龙虾」)说话像伙伴、而不是千篇一律的「尊敬的用户」,关键不是换模型,而是写好它工作区里的身份文件。OpenClaw 用一组文件定义「它是谁、该怎么做、你是谁」,每次会话都读取这些文件,等于让它「记住自己是谁」。下面按官方教程讲清这组文件各管什么、核心三项怎么写。
OpenClaw 用哪些文件定义身份?五个文件各管什么
OpenClaw 的身份系统由 5 个核心文件组成,都放在工作区目录下:
workspace/
├── AGENTS.md # 行为准则(每次会话必读)
├── IDENTITY.md # 身份定义(名字、角色、风格)
├── SOUL.md # 灵魂定义(职责、价值观、边界)
├── USER.md # 用户信息(偏好、习惯)
└── MEMORY.md # 长期记忆(主会话加载)

这 5 个文件的分工如下:
- IDENTITY.md:定义 Agent 的基本身份——名字、角色、专注领域、说话风格。
- SOUL.md:定义职责、工作风格、价值观和边界,也就是「它该做什么、不该做什么」。
- USER.md:记录你(用户)的信息——称呼、时区、偏好、习惯。
- AGENTS.md:通用行为规范,所有 Agent 共享,一般不需要改。
- MEMORY.md:长期记忆,记录项目、决策、重要事件,只在主会话加载。
设计理念一句话:文件即记忆。Agent 每次会话读取这些文件,就能「记起自己是谁」,而不是每次从零开始。
核心三项必须写:IDENTITY.md、SOUL.md、USER.md
虽然列了 5 个文件,但不是每个都要手写。官方教程明确:核心三个必须写——IDENTITY.md、SOUL.md、USER.md;AGENTS.md 和 MEMORY.md 用默认模板即可。
IDENTITY.md 怎么写:名字具体,划清「不是什么」
IDENTITY.md 回答「我是谁」,写法要点有三条:
- 名字要具体——别叫「助手」,要有个性化名字,比如「大佬虾」。
- 明确「不是什么」——划清边界,例如「不是通用助手、不是客服、不是什么都干的多面手」。
- 风格描述要简短有力——用「专业、深度、有洞察力、不装」这种短语,而不是长篇大论。
一个结构清晰的 IDENTITY.md 会同时写「你是什么」和「你不是什么」,让 Agent 知道自己该专注在哪一块。
SOUL.md 怎么写:职责具体、风格有辨识度、边界清晰
SOUL.md 回答「我该怎么做」,是最能塑造人格的文件。写法要点:
- 职责要具体:不要写「帮助用户」,要写清楚具体做什么,比如「阅读分析、内容创作、内容优化」。
- 风格要有辨识度:用「深度优先」「结构清晰」「有观点」这类词,让回复风格稳定可预期。
- 边界要清晰:明确什么能做、什么不能做,比如「不确定的信息要标注需要核实」「不抄袭,保持原创」。
SOUL.md 写得好,龙虾的每句回复都会带上稳定的性格;写得太泛,它还是那个「有问必答的客服」。
USER.md 怎么写:称呼统一、偏好具体
USER.md 回答「你是谁」,让 Agent 更懂你。要点:
- 称呼要统一:写清 Agent 该用什么称呼叫你,比如「Bacon 大王」。
- 偏好要具体:写「拒绝 AI 味」比写「喜欢自然」更明确、更可执行。
- 可记录协作关系:多 Agent 场景下,可以在这里写明团队里各成员的角色。
写的越细,它越懂你。比如 USER.md 里写了你的时区和常用工具,它就能在合适的场景直接用上这些信息。

改完必须重启 Gateway
文件改完不会立即生效,需要重启网关:
openclaw gateway restart
重启后发条消息测试,如果回复不再是「尊敬的用户」而是你的称呼,就说明身份文件生效了。
systemPrompt 冲突怎么办:以 systemPrompt 为准
如果你同时配了 systemPrompt,和身份文件内容冲突时,systemPrompt 优先级更高。官方建议:systemPrompt 只写核心身份(兜底用),详细内容交给身份文件维护。
多 Agent 怎么配:每个 Agent 一套独立文件
要跑多个 Agent(比如一个负责日常聊天、一个负责内容创作),做法是每个 Agent 用一套独立的身份文件、独立的目录空间,各自维护自己的 AGENTS.md、SOUL.md、IDENTITY.md、USER.md、MEMORY.md,互不干扰。
常见问题
OpenClaw 的身份文件都要写吗?
不用全写。核心三个必须写:IDENTITY.md(我是谁)、SOUL.md(我的职责与边界)、USER.md(用户偏好),另外两个 AGENTS.md 和 MEMORY.md 可以直接用默认模板。
改了身份文件为什么没生效?
改完文件需要重启 Gateway 才生效,执行 openclaw gateway restart,等几秒再发消息测试即可。
systemPrompt 和身份文件内容冲突时听谁的?
systemPrompt 优先级更高,冲突时以 systemPrompt 为准。建议 systemPrompt 只写核心身份,详细内容交给身份文件。
多个 OpenClaw Agent 怎么分别配身份?
每个 Agent 用一套独立的身份文件、独立的目录空间,各自维护自己的 SOUL.md、IDENTITY.md、USER.md,互不干扰。
MEMORY.md 什么时候会加载?
MEMORY.md 只在主会话(私聊)加载,群聊不加载,这是出于安全考虑。
身份配置怎么快速落地?
可以把官方教程链接发给龙虾,让它用引导对话一步步帮你配置,每次只问一个问题,省去手写文件的麻烦。