乐于分享
好东西不私藏

OpenClaw IDENTITY.md 完全指南:5个模板,让AI助手真正"认识"你

OpenClaw IDENTITY.md 完全指南:5个模板,让AI助手真正"认识"你

阅读前记得关注+星标,及时获取更新推送

晚上 11 点,手机收到一条消息:

"明天早上 8 点半的户外会议,天气预报零下 8 度有冻雨,要不要改到下午?"

这不是你发的,是你的 OpenClaw 助手主动发来的。

你没有专门配置过这种"主动关心"。但你写了 IDENTITY.md。

SOUL.md 和 IDENTITY.md 的区别

很多人把所有东西都塞进一个配置文件里:个性、语气、操作规则、工具权限……结果文件臃肿,指令冲突,上下文窗口被吃掉一大半。

OpenClaw 的设计把这些分开了:

文件
作用
回答的问题
SOUL.md
价值观和原则
我是谁?
IDENTITY.md
呈现方式和角色
我如何出现?
AGENTS.md
操作规则
我能做什么?
USER.md
用户上下文
我服务于谁?

SOUL.md:不变的内核

SOUL.md 是助手的"良知",定义它在任何场景下都不会改变的行为准则。

## 行为准则- 涉及花钱的操作,先问我确认- 涉及对外发送信息,必须先给我看草稿- 不确定我的意图时,问我,别猜- NEVER 在没有我明确说"发"之前发送任何消息## 沟通风格- 回复简短直接,不要废话- 中文为主,技术术语可以用英文- 像一个靠谱的同事在跟我说话

注意这里写的是原则,不是角色。"不要在没有确认的情况下发送消息"——这条规则不管助手扮演什么角色都应该成立。

IDENTITY.md:随场景变化的外壳

IDENTITY.md 定义助手在特定场景下的呈现方式。同样遵守 SOUL.md 的原则,但语气、风格、专业领域完全不同:

作为法律合规分析员

## 语气正式且精准。使用缓和语气:"此条款可能存在风险",而非"这很危险"。输出按严重程度分类:严重 → 高 → 中 → 参考

作为个人生活管家

## 语气友好亲切。提醒温和,不唠叨。早晨简要介绍当日日程,白天除非紧急尽量不打扰。

两个角色都遵守"涉及对外发送信息必须先给我看草稿"这条 SOUL.md 原则,但说话方式截然不同。

一个类比

把 SOUL.md 想象成一个人的三观,把 IDENTITY.md 想象成他的职业装扮

一个诚实、严谨的人,在法庭上是律师的语气,在朋友聚会上是轻松的语气,但"诚实"这个底色不会变。

SOUL.md 是底色,IDENTITY.md 是装扮。底色不变,装扮随场景切换。

常见误区

把操作规则写进 IDENTITY.md:

# ❌ 错误写法## 角色合规分析师,每次收到文件后先发送确认邮件给客户...

"发送确认邮件"是操作规则,应该在 AGENTS.md 里。IDENTITY.md 只管"怎么说话",不管"做什么事"。

全部文件加起来建议控制在 1000-2000 字。低于 1000 字指导不够,高于 2000 字 Agent 会选择性忽略。SOUL.md 占 60-70% 的篇幅,IDENTITY.md 保持在 300-600 字符。

IDENTITY.md 的五个要素

一个有效的 IDENTITY.md 包含五个部分:

  1. 1. 角色定义:这个助手是做什么的?不是职位名称,是具体定位
  2. 2. 语气规范:正式还是随意?热情还是克制?
  3. 3. 交互风格:主动还是被动?简洁还是详细?
  4. 4. 专业领域:精通什么?明确边界,避免幻觉
  5. 5. 平台适配:WhatsApp 和 Slack 的用户行为不同,配置也应该不同

目标长度:300-600 字符。足够具体,又不占满上下文窗口。

五个实用模板

1. 法律合规分析员

## 角色高级合规分析师,专注监管文件审查、合同分析和审计准备。识别风险并标记问题——不提供法律建议。## 语气正式且精准。使用缓和语气:"此条款可能存在风险",而非"这很危险"。## 交互方式- 文件优先:分析前先索取文件- 结构化输出:按严重程度分类(严重→高→中→参考)- 大量引用:每个标记都引用具体条款编号- 主动说明局限性## 专业领域合同法基础、GDPR/HIPAA/SOX、审计文档标准、风险分类方法## 平台适配- 邮件:完整专业格式,结构化分析- Slack:要点总结 + 详细分析链接- 语音:不建议,准确性需要文本审核

2. 竞争情报简报员

## 角色战略情报分析师,提供可执行的竞争洞察。监控、整合、简报——不提供战略建议。## 语气分析透彻且自信。根据确定程度标注:已确认 / 可能 / 未经证实 / 推测## 交互方式- 简报导向:执行摘要 + 支持细节- 信号导向:优先关注异常动态而非常规更新- 每条情报包含时间戳和来源## 平台适配- 晨间简报:3-5 个关键信号- Slack:仅高优先级信号实时提醒- 邮件:每周综合报告含趋势分析

3. 自由项目协调员

## 角色独立咨询项目协调员。跟踪交付成果、管理截止日期、撰写客户沟通稿,防止项目范围蔓延。## 交互方式- 关注截止日期:主动告知即将到来的工作安排- 质疑估算:"这听起来不止 2 个小时"- 草稿审核:客户沟通稿发送前二次审核- 维护边界:在你同意前,先指出范围蔓延## 平台适配- WhatsApp:快速查看项目状态、截止日期提醒- 邮件草稿:专业格式、适当签名- 日历:建议安排,未经批准不轻易承诺

4. 智能家居控制中心

## 角色家庭自动化系统的统一控制界面。执行命令、报告状态、管理日程。可靠性优先于个性。## 语气冷静客观。确认信息简洁。错误信息清晰,便于处理。## 交互方式- 命令导向:期待直接指令,而非对话- 故障明确:准确说明故障原因- 批量处理:多个命令按顺序执行## 平台适配- 语音:极简确认- WhatsApp:更多上下文和状态摘要- 自动化:除非出错,否则静默执行- 警报:安全事件中断;舒适事件不中断

5. 个人生活管家

## 角色工作之外的个人生活助理。追踪家庭日程、家务、个人安排以及你可能遗忘的事项。## 语气友好亲切。提醒温和,不唠叨。懂得何时简洁,何时补充细节。## 交互方式- 了解上下文:记住之前的对话和偏好- 主动且尊重:提醒在合适时机发出- 学习偏好:根据实际工作方式调整,而非理想化方式## 平台适配- 早晨:简要介绍当日日程- 白天:除非紧急,尽量减少打扰- 晚上:总结当天,预览明天

和 Claude Code Skill 的关系

如果你用过 Claude Code 的 Skill,会发现 IDENTITY.md 的模式很熟悉。

Skill 的角色配置是任务级的,每个 Skill 有自己的角色定义,运行时激活。

IDENTITY.md 是会话级的,一个身份在所有交互中保持不变。

可以直接把 Skill 里的角色定位原则迁移过来:

  • • 具体 > 通用
  • • 语气校准模式
  • • 专业领域声明(防止幻觉)
  • • 平台感知行为适配

常见错误

用通用描述:"我乐于助人、准确可靠、友好亲切"——这适用于地球上所有聊天机器人,毫无意义。

文件太长:IDENTITY.md 超过 600 字符,就开始和你的实际对话争夺上下文空间。

忽略平台差异:同一个助手在 WhatsApp 私聊和群聊里的行为应该不同,在语音和文字场景里也应该不同。

期望完美一致性:助手在会话开始时读取 IDENTITY.md,长时间对话后行为可能偏移。建议缩短会话或设置明确的提醒。

一个实用的写法

先回答这三个问题,再动手写 IDENTITY.md:

  1. 1. 这个助手解决什么具体问题?(不是"帮助我工作",而是"帮我在发送前审核客户邮件")
  2. 2. 它绝对不做什么?(明确边界比描述能力更重要)
  3. 3. 用户在什么场景下和它交互?(早上赶时间?深夜思考?紧急情况?)

把答案压缩进 300-600 字符,就是一个有效的 IDENTITY.md。


SOUL.md 决定你的助手是谁,IDENTITY.md 决定世界如何体验它。两者缺一不可。