---
title: "IDENTITY.md"
type: concept
tags: [OpenClaw, Agent, Identity]
sources: [万字讲透openclaw-workspace深度解析-2026-03-21]
last_updated: 2026-03-21
---

## Definition

**IDENTITY.md** 是 OpenClaw workspace 中存储 Agent **结构化身份元数据**的文档。与 SOUL.md 的叙事性性格文档分工明确：IDENTITY.md 是名片（结构化元数据），SOUL.md 是人物小传（叙事性性格）。

## 核心字段

- **Name**：Agent 在界面和对话里的显示名
- **Creature**：Agent 的存在类型（AI assistant / ghost / familiar / robot 等）
- **Vibe**：Agent 的感觉描述（直接、毒舌、靠谱等）
- **Emoji**：UI 中的标识符
- **Avatar**：头像（workspace 相对路径 / URL / data URI）

## 与 SOUL.md 的分工

| | IDENTITY.md | SOUL.md |
|---|---|---|
| 性质 | 结构化元数据 | 叙事性文档 |
| 内容 | 谁、长什么样、什么感觉 | 怎么思考、怎么行事、有什么执念 |
| 类比 | 名片 | 人物小传 |

## Related Concepts

- [[SOUL.md]] — 叙事性性格文档，与 IDENTITY.md 互补
- [[BOOTSTRAP.md]] — 初始化时写入 IDENTITY.md 的引导流程
- [[OpenClaw]] — IDENTITY.md 所属的框架