宝塔面板博客官方技术博客
宝塔面板

宝塔 OpenClaw 怎么定人格和身份?SOUL.md、IDENTITY.md、USER.md 身份文件配置

想让 OpenClaw(昵称「龙虾」)说话像伙伴、而不是千篇一律的「尊敬的用户」,关键不是换模型,而是写好它工作区里的身份文件。OpenClaw 用一组文件定义「它是谁、该怎么做、你是谁」,每次会话都读取这些文件,等于让它「记住自己是谁」。下面按官方教程讲清这组文件各管什么、核心三项怎么写。

OpenClaw 用哪些文件定义身份?五个文件各管什么

OpenClaw 的身份系统由 5 个核心文件组成,都放在工作区目录下:

workspace/
├── AGENTS.md      # 行为准则(每次会话必读)
├── IDENTITY.md    # 身份定义(名字、角色、风格)
├── SOUL.md        # 灵魂定义(职责、价值观、边界)
├── USER.md        # 用户信息(偏好、习惯)
└── MEMORY.md      # 长期记忆(主会话加载)

OpenClaw 身份系统五个核心文件

这 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 回答「我是谁」,写法要点有三条:

  1. 名字要具体——别叫「助手」,要有个性化名字,比如「大佬虾」。
  2. 明确「不是什么」——划清边界,例如「不是通用助手、不是客服、不是什么都干的多面手」。
  3. 风格描述要简短有力——用「专业、深度、有洞察力、不装」这种短语,而不是长篇大论。

一个结构清晰的 IDENTITY.md 会同时写「你是什么」和「你不是什么」,让 Agent 知道自己该专注在哪一块。

SOUL.md 怎么写:职责具体、风格有辨识度、边界清晰

SOUL.md 回答「我该怎么做」,是最能塑造人格的文件。写法要点:

  • 职责要具体:不要写「帮助用户」,要写清楚具体做什么,比如「阅读分析、内容创作、内容优化」。
  • 风格要有辨识度:用「深度优先」「结构清晰」「有观点」这类词,让回复风格稳定可预期。
  • 边界要清晰:明确什么能做、什么不能做,比如「不确定的信息要标注需要核实」「不抄袭,保持原创」。

SOUL.md 写得好,龙虾的每句回复都会带上稳定的性格;写得太泛,它还是那个「有问必答的客服」。

USER.md 怎么写:称呼统一、偏好具体

USER.md 回答「你是谁」,让 Agent 更懂你。要点:

  • 称呼要统一:写清 Agent 该用什么称呼叫你,比如「Bacon 大王」。
  • 偏好要具体:写「拒绝 AI 味」比写「喜欢自然」更明确、更可执行。
  • 可记录协作关系:多 Agent 场景下,可以在这里写明团队里各成员的角色。

写的越细,它越懂你。比如 USER.md 里写了你的时区和常用工具,它就能在合适的场景直接用上这些信息。

给龙虾注入灵魂:SOUL.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 只在主会话(私聊)加载,群聊不加载,这是出于安全考虑。

身份配置怎么快速落地?

可以把官方教程链接发给龙虾,让它用引导对话一步步帮你配置,每次只问一个问题,省去手写文件的麻烦。