跳转到主要内容
身份文件是特殊的记忆文档。每一轮对话开始时,IronClaw 会自动把它们注入到系统提示词中,从而让代理在跨会话、重启后仍保持一致行为与风格。

四个身份文件

文件作用
AGENTS.md行为规则与执行约束
SOUL.md价值观、性格与决策原则
USER.md你的偏好、上下文与工作方式
IDENTITY.md角色定义与整体身份设定
这些文件位于工作区根目录。你可以手动编辑,也可以让代理通过 memory_write 写入。

AGENTS.md

用于约束代理“该做什么/不该做什么”,例如沟通风格、工具使用规范、安全策略。

SOUL.md

用于定义代理风格与价值取向,例如准确性优先、透明表达、安全优先、尊重用户决策。

USER.md

用于描述你的个人信息与偏好,让代理长期记住你的工作上下文,减少重复澄清。

IDENTITY.md

用于定义该工作区内代理扮演的角色,比如“嵌入式开发助手”“安全审计助手”等。

注入顺序

每次 LLM 调用会按如下顺序构造提示词:
[AGENTS.md]
[SOUL.md]
[USER.md]
[IDENTITY.md]
[Skill injections]
[Conversation history]
[Current message]
缺失的文件会被自动跳过,不需要一次性准备全部四个文件。