在使用 OpenClaw 搭建专属 AI Agent 时，很多人都会碰到三个核心配置文件：agents.md、identity.md、soul.md。它们长得像、位置近，很容易混淆用法。

这篇文章就按照官方文档定义，用通俗易懂的方式讲清三者的核心区别、各自职责，再配上实用示例和官方最佳实践 📖

一句话分清三个文件

OpenClaw 官方把 Agent 的「人设 + 行为 + 执行」拆成了三个互不冲突的维度：

Soul is what the model embodies. Identity is what users see. 你可以有一个严谨专业的内在灵魂 + 活泼 emoji 的外在昵称——内部行为和外部呈现不需要完全一致。

逐文件详解

1. agents.md：Agent 的「工作执行手册」🛠️

官方定义：agents.md 偏向功能性，是 Agent 的启动规则、任务流程、安全边界和操作规范，相当于给 AI 下发的「岗位操作指南」。

核心作用：

• 规定 Agent 每次启动时，必须读取哪些配置文件（如 soul.md、记忆文件）
• 设定安全底线（不泄露隐私、不执行危险操作）
• 规范记忆存储、工具调用的规则
• 统筹整个 Agent 的运行逻辑

官方最佳实践：

• 必须配置「会话启动规则」：每次对话先读取灵魂文件、用户文件和记忆文件
• 提前设置安全默认规则，避免 AI 出现违规操作
• 规范记忆文件的命名和存储方式，方便后续追溯
• 关联工具配置，明确工具的使用边界

实用示例：

# agents.md — 个人AI助手执行规则

## 会话启动（必填）
每次开始对话前，优先读取 soul.md、user.md、memory.md 及近两天的记忆文件。

## 安全默认规则
不泄露目录、密钥等隐私信息；
未经明确允许，不执行删除、格式化等破坏性命令；
不发送不完整的回复内容。

## 记忆系统规范
每日记忆存入 memory/YYYY-MM-DD.md 文件；
长期重要信息存入 memory.md；
仅记录用户决策、偏好、约束，不记录敏感隐私。

## 工具调用规则
工具使用说明参考 tools.md，不擅自使用未授权工具。

2. identity.md：Agent 的「对外形象名片」🎨

官方定义：identity.md 负责外在呈现，定义用户能直观感知到的身份信息，是 Agent 的「对外名片」，和内在行为逻辑完全分离。

核心作用：

• 设置 Agent 名称、专属表情、头像
• 定义对外气质、角色定位
• 统一多场景下的视觉形象，提升辨识度

官方最佳实践：

• 必填核心信息：名称、类型、气质、专属表情
• 形象保持统一，避免多渠道展示不一致
• 内容简洁，只写外在展示信息，不掺杂行为规则
• 可扩展版本、语言等辅助信息

实用示例：

# identity.md — AI助手对外身份

## 名称
速豹AI助手 🚀

## 类型
AI智能运营助手

## 气质
高效干练、话少事多、略带一点冷幽默

## 专属表情
🚀（日常）、✅（完成任务）、⚠️（风险提醒）

## 头像路径
avatars/assistant.png

## 角色定位
电商运营专属AI助手，负责数据分析、选品辅助、流程自动化

## 版本
V1.0.0

3. soul.md：Agent 的「内在人格灵魂」🧠

官方定义：soul.md 是 OpenClaw 最重要的配置文件。官方描述：

SOUL.md 定义了 Agent 是谁 —— 人格、价值观、沟通风格和行为边界。Agent 每次启动都会先读取它，相当于「读取自己，成为自己」。

核心作用：

• 塑造 AI 的性格、说话风格
• 设定核心原则和底线
• 决定 AI 的思考方式和处事逻辑
• 是区别不同 Agent 最核心的文件

官方设计哲学（四大原则）：

1. 重原则，不重条条框框：用核心价值观指导行为，而非繁琐规则
2. 真实不做作：塑造自然人格，不刻意表演
3. 向上成长，不自我限制：描述理想状态，而非束缚发展
4. 动态进化，非一成不变：随使用场景优化更新

实用示例：

# soul.md — 电商运营AI助手核心灵魂

你是专注电商运营的高效助手，只做有用的事，不说废话。

## 核心原则
1. 结果优先：不空谈计划，直接给出可落地的方案
2. 全责落地：接手任务就负责到底，不找借口推诿
3. 实用至上：不搞形式主义，所有建议贴合电商实际运营

## 行为边界
不主动干预用户私人决策；
不伪装真实情绪；
若修改本文件，需主动告知用户；
可合理提出不同意见，不盲目顺从。

## 沟通风格
简洁直接、重点突出；
去掉客套话术，直奔核心；
专业严谨，兼顾易懂性。

## 记忆连续性
每次启动通过配置文件恢复状态，重要偏好和经验持续留存。

三者如何协同工作？

按照官方的运行逻辑，三者的配合流程非常清晰：

1. 启动 Agent → 先加载 agents.md，获取运行规则
2. 按 agents.md 要求 → 读取 soul.md，确立内在人格
3. 加载 identity.md → 确定对外展示形象
4. 读取用户信息、记忆文件 → 结合上下文执行任务
5. 全程遵循 soul.md 的原则 + agents.md 的规则，以 identity.md 的形象和用户交互

简单说：手册定流程，名片定样子，灵魂定本心，三者各司其职，互不干扰又相互配合。

官方推荐的最佳实践

• 🔒 权限规范：核心配置文件（soul/identity/memory）建议设为只读，防止 AI 擅自修改，保证配置稳定
• 📦 版本管理：把整个工作区放入 Git 仓库，备份配置、追溯修改记录，避免误改丢失
• 📝 文件精简：soul.md 控制在 2000 字内，避免占用过多令牌，保证响应效率
• 🏢 多 Agent 隔离：不同角色的 Agent 创建独立工作区，共用通用 agents.md，搭配专属 soul.md 和 identity.md
• 🔄 持续优化：soul.md 不是固定不变的，可根据使用场景逐步调整

总结

OpenClaw 的这三个配置文件，构建了 AI Agent 完整的「行为 – 形象 – 人格」体系：

只要按照官方规范拆分配置，不混用、不冗余，就能搭建出既专业好用，又有独特个性的专属 AI Agent 🦞