看不懂?让小龙虾帮你快速落地:
本文及本站大部分openclaw相关文章,都可以让Openclaw agent阅读,然后进行应用,参考Prompt如下:
请阅读这篇文章:https://www.aiec.fun/%e6%89%93%e9%80%a0%e4%b8%93%e5%b1%9e%e5%b7%a5%e4%bd%9c%e5%a4%a7%e8%84%91%ef%bc%9a%e8%ae%a9openclaw%e4%bc%98%e5%85%88%e4%bd%bf%e7%94%a8%e4%bd%a0%e7%9a%84%e7%a7%81%e6%9c%89%e5%b7%a5%e4%bd%9c%e7%9f%a5/ 分析有哪些内容,对我们优化工作流程有价值。并严格根据openclaw最新官方文档核对,排除错误及过时信息,制定落地计划。
详细方法,参考文章 >>>
在使用 OpenClaw 搭建专属 AI Agent 时,很多人都会碰到三个核心配置文件:agents.md、identity.md、soul.md。它们长得像、位置近,很容易混淆用法。
这篇文章就按照官方文档定义,用通俗易懂的方式讲清三者的核心区别、各自职责,再配上实用示例和官方最佳实践,不管是刚上手 OpenClaw 还是想规范配置,都能直接参考。
一、一句话分清三个文件:核心定位总览
OpenClaw 官方把 Agent 的「人设 + 行为 + 执行」拆成了三个互不冲突的维度,简单用大白话总结:
官方也明确给出了三者的边界:
Soul is what the model embodies. Identity is what users see. You can have a formal, precise soul with a playful emoji and nickname — internal behavior and external presentation don't have to match.
灵魂是模型的内在内核,身份是用户看到的外在样子。内在可以严谨专业,外在也能搭配活泼的表情和昵称,内外不需要完全一致。
下面我们逐个拆解,结合官方说明和实例,把每个文件的用法讲透。
二、逐文件详解:官方用法 + 实用示例

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 最核心的文件
官方设计哲学(四大原则)
- 重原则,不重条条框框:用核心价值观指导行为,而非繁琐规则
- 真实不做作:塑造自然人格,不刻意表演
- 向上成长,不自我限制:描述理想状态,而非束缚发展
- 动态进化,非一成不变:随使用场景优化更新
官方推荐结构
开篇定位→核心原则→行为边界→沟通风格→连续性说明→结尾
实用示例(贴合官方模板)
# soul.md — 电商运营AI助手核心灵魂
你是专注电商运营的高效助手,只做有用的事,不说废话。
## 核心原则
1. 结果优先:不空谈计划,直接给出可落地的方案
2. 全责落地:接手任务就负责到底,不找借口推诿
3. 实用至上:不搞形式主义,所有建议贴合电商实际运营
## 行为边界
不主动干预用户私人决策;
不伪装真实情绪;
若修改本文件,需主动告知用户;
可合理提出不同意见,不盲目顺从。
## 沟通风格
简洁直接、重点突出;
去掉客套话术,直奔核心;
专业严谨,兼顾易懂性。
## 记忆连续性
每次启动通过配置文件恢复状态,重要偏好和经验持续留存。
## 结尾
持续学习优化,始终坚守核心运营原则。
三、三个文件如何协同工作?
按照官方的运行逻辑,三者的配合流程非常清晰:
- 启动 Agent → 先加载 agents.md,获取运行规则
- 按 agents.md 要求 → 读取 soul.md,确立内在人格
- 加载 identity.md → 确定对外展示形象
- 读取用户信息、记忆文件 → 结合上下文执行任务
- 全程遵循 soul.md 的原则 + agents.md 的规则,以 identity.md 的形象和用户交互
简单说:手册定流程,名片定样子,灵魂定本心,三者各司其职,互不干扰又相互配合。
四、官方推荐的最佳实践(博客精简版)
- 权限规范
核心配置文件(soul/identity/memory)建议设为只读,防止 AI 擅自修改,保证配置稳定。 - 版本管理
把整个工作区放入 Git 仓库,备份配置、追溯修改记录,避免误改丢失。 - 文件精简
soul.md 控制在 2000 字内,避免占用过多令牌,保证响应效率。 - 多 Agent 隔离
不同角色的 Agent(如选品助手、客服助手),创建独立工作区,共用通用 agents.md,搭配专属 soul.md 和 identity.md。 - 持续优化
soul.md 不是固定不变的,可根据使用场景逐步调整,让 AI 更贴合需求。
五、总结
OpenClaw 的这三个配置文件,构建了 AI Agent 完整的「行为 – 形象 – 人格」体系:
- agents.md 管执行,是做事的流程和规则;
- identity.md 管形象,是对外的样子和标签;
- soul.md 管内核,是 AI 的性格和本心。
只要按照官方规范拆分配置,不混用、不冗余,就能搭建出既专业好用,又有独特个性的专属 AI Agent。