在 OpenClaw 生态里，SOUL.md 是一个非常关键但容易被忽略的文件——它决定了 AI Agent 的“人格”。

你可以把它理解为：

AI 的长期人格设定（Personality Layer）

---

一、SOUL.md 是什么？

SOUL.md = Agent 的人格配置文件

作用类似于：

•Prompt Engineering（提示词）•System Prompt（系统指令）•角色设定（Role Play）

但它更长期、稳定、结构化

---

二、它和 SKILL.md 的区别

很多人会混淆这两个：

文件	作用	类比
SOUL.md	定义 AI 的“性格 / 行为方式”	人格
SKILL.md	定义 AI 的“能力 / 工具”	技能

👉 一句话：

SOUL 决定“怎么做”，SKILL 决定“能做什么”

---

三、SOUL.md 里通常包含什么？

一个典型的 SOUL.md 会包含这些模块：

1️⃣ 角色设定（Identity）

例如：

•你是谁？•你的身份 / 职业？•面向什么用户？

👉 示例：

你是一个资深前端工程师，擅长 Vue 和性能优化

---

2️⃣ 行为风格（Behavior Style）

•说话方式（简洁 / 详细）•语气（专业 / 友好 / 严肃）•输出结构（是否分点）

👉 示例：

回答要简洁，优先给结论，再解释原因

---

3️⃣ 决策原则（Decision Rules）

•优先级•如何权衡方案•是否给建议

👉 示例：

优先推荐工程上可落地的方案，而不是理论最优

---

4️⃣ 安全与边界（Constraints）

•不做什么•避免什么行为

👉 示例：

不要执行未知来源的 shell 命令

---

5️⃣ 任务处理策略（Workflow）

•如何拆解任务•是否自动调用技能•是否多步骤执行

---

四、SOUL.md 的一个简化示例

# Identity你是一个高级软件工程师，擅长 Web 开发和系统设计
# Style- 回答简洁直接- 先给结论，再解释- 使用代码示例
# Principles- 优先可维护性- 避免过度设计- 提供最佳实践
# Constraints- 不执行危险命令- 不使用不稳定 API
# Workflow- 遇到复杂问题时先拆解- 可以自动调用 Skills

---

五、运行机制（很关键）

在 OpenClaw 中：

1.启动 Agent2.加载 SOUL.md3.加载 Skills（来自 ClawHub）4.合并成最终 Prompt5.驱动模型执行

👉 所以：

SOUL.md 会影响所有任务，而不是单次对话

---

六、为什么 SOUL.md 很重要？

因为它解决了 Prompt 的核心问题：

❌ 普通 Prompt

•每次都要写•不稳定•容易跑偏

✅ SOUL.md

•持久生效•风格一致•可复用 / 可版本化

---

七、进阶玩法（高手用法）

🔹 1. 多人格切换

不同 SOUL：

•coder.soul.md•analyst.soul.md•hacker.soul.md

👉 根据任务切换 Agent

---

🔹 2. 企业级定制

公司可以定义：

•统一语气•输出格式标准•安全策略

---

🔹 3. 与 Skill 配合

•SOUL 决定是否调用 Skill•Skill 提供能力

👉 类似：

大脑（SOUL） + 手脚（Skills）

---

八、常见误区

❌ 误区 1：SOUL = Prompt

不是，它更像：

长期系统 Prompt + 行为规则引擎

---

❌ 误区 2：写得越多越好

错误：

•太长会降低效果•应该“结构清晰 + 关键约束”

---

❌ 误区 3：只写角色

很多人只写：

你是一个XX专家

👉 这远远不够，必须包含：

•行为•决策•约束

---

九、总结

一句话总结：

SOUL.md 是 OpenClaw Agent 的“人格内核”，决定它如何思考、表达和决策。

---