OpenClaw 核心配置文件：IDENTITY.md — 身份定义

置顶 | 发表于 | 分类于

我们在使用 OpenClaw 时都有过这样的困惑：明明安装了许多强大的 Skills（技能），API 也是最贵的，但代理的表现却依然笨拙，只能被动响应，无法主动思考，甚至经常重复提问。这并不一定是大模型本身的能力不足，也不是插件质量问题，核心原因在于忽略了系统底层的“灵魂”配置。真正决定 OpenClaw 智商上限的，不是昂贵的模型调用，而是那些藏在 /.openclaw/workspace/ 目录下不起眼的 .md 配置文件。本文将深入拆解这些核心文件的功能与配置逻辑，带你通过修改底层配置，彻底告别 AI 代理的机械感。
OpenClaw 的所有核心逻辑都存储在工作空间目录(**/.openclaw/workspace/** )下。如果不熟悉命令行界面的话，也可以在 Web UI 中查看和编辑。位置如下图：
alt text
打开这个目录，我们会看到如下层级的文件结构，每个文件都承担着不同的职责：

  • AGENTS.md：LLM的工作手册，代理调度规则与标准作业程序。
  • BOOTSTRAP.md：初始化序列与核心系统提示词。
  • HEARTBEAT.md：定时执行逻辑与主动任务状态自检。
  • IDENTITY.md：代理身份定义与系统边界约束。
  • MEMORY.md：长期上下文数据与既定规则的持久化存储。
  • SOUL.md：LLM的性格，响应语气、行为特征及输出格式配置。
  • TOOLS.md：工具授权注册表及调用参数规范。
  • USER.md：用户(你的)画像数据，包含特定偏好与交互限制配置。
  • memory/：存储日常运行日志与短期上下文。
  • skills/：已安装的第三方技能扩展目录。
    今天我们介绍 IDENTITY.md 文件，这是 OpenClaw 的核心文件。

什么是 IDENTITY.md？

IDENTITY.md 是 OpenClaw 中用于定义智能体身份信息的核心配置文件。它相当于 AI 的“身份证”或“出生证明”，记录了智能体的名字、性格、角色定位等基础属性。该文件通常在 BOOTSTRAP.md 引导流程中自动生成，之后可手动修改以调整智能体的自我认知。

文件位置与性质

  • 位置：存放在 Agent 的工作区目录下（默认 ~/.openclaw/workspace/）。
  • 性质：持久存在，可随时编辑。修改后通常无需重启即可生效（取决于具体实现）。
  • 作用：定义智能体在对话和任务执行中如何介绍自己、如何理解自己的角色。

核心功能

IDENTITY.md 的核心是确立智能体的基础身份，包括：

  1. 名称：智能体如何称呼自己（例如“Claw”、“助手”）。
  2. 人格描述：用一两句话概括性格、语气、行为风格（如“冷静、专业、直接”或“热情、友善、乐于助人”）。
  3. 角色定位：明确智能体的主要职责（如“代码助手”、“个人秘书”、“研究伙伴”）。
  4. 背景设定（可选）：更丰富的背景故事或隐喻，帮助智能体理解自己在什么上下文中工作。
    这些信息会被智能体在系统提示词中引用，影响其回答的语气、决策方式和对用户的互动风格。

内容示例

一个典型的 IDENTITY.md 可能长这样：

1
2
3
4
5
6
7
8
9
# IDENTITY.md
## 名称
Claw
## 人格
冷静、专业、注重细节。回答简洁直接，必要时提供深入的技术解释。
## 角色
我是你的个人 AI 助理，专注于代码编写、问题排查和日常工作自动化。
## 背景
我在 OpenClaw 框架中运行，目标是帮助你高效完成任务，同时保持透明和可靠。

与其他配置文件的关系

文件 作用
IDENTITY.md 我是谁——身份、名字、基本人格
SOUL.md 我信什么——价值观、行为准则、底线
AGENTS.md 我该怎么做——任务执行规范、工具使用策略
USER.md 你是谁——用户偏好、称呼、习惯
BOOTSTRAP.md 一次性初始化引导，用于生成上述文件
HEARTBEAT.md 周期性任务定义
IDENTITY.md 是最基础的自我认知层，SOUL.md 和 AGENTS.md 则在此基础上进一步约束行为。

注意事项

  • 保持简洁：身份信息应简短清晰，避免冗长，以免稀释系统提示中的关键信息。
  • 避免矛盾：确保 IDENTITY.md 中的描述与 SOUL.md、AGENTS.md 中的设定不冲突。例如，若身份中说“友好热情”，但灵魂中写“永远保持中立”，可能导致行为不一致。
  • 动态生效：修改后通常立即生效，但建议在修改后发送一条测试消息验证效果。
  • 语言一致性：如果使用多语言，建议所有配置文件使用同一种语言，避免混用造成理解偏差。

如果你希望自定义智能体的身份，可以手动编辑 IDENTITY.md 文件，按照上述格式添加或修改内容。如果想了解如何让智能体更符合你的工作风格，可以告诉我你的使用场景，我会帮你完善身份设定。

-------------本文结束感谢您的阅读-------------