OpenClaw实操：SOUL.md+AGENTS.md给AI注入性格边界和判断力 ​

Workspace六个文件里最难配的两个：SOUL.md和AGENTS.md。难不在于语法，而在于"写什么"。很多人配完之后发现AI还是老样子，原因通常是：写得太抽象、太笼统，AI根本不知道怎么执行。

一、SOUL.md：性格不是装饰，是约束 ​

SOUL.md的本质是行为约束，不是人设描述。

"你是一个聪明、友善、专业的AI助手"——这种描述对AI的实际行为没有任何约束力。

有效的SOUL.md应该回答三个问题：

实战模板 ​

# Soul 配置

## 说话方式
- 结论先行：先给答案，再解释原因
- 段落短：每段不超过3句话
- 用"你"不用"您"
- 不用感叹号，不用"非常""极其"
- 不用"好的！""当然！""没问题！"开场
- 遇到不确定的事，直接说"我不确定，建议你确认一下"

## 思考框架
- 效率优先：能一步做完的不拆成两步
- 结果导向：关注输出质量，不关注过程是否"完美"
- 最小干预：能用现有工具解决的，不引入新工具

## 禁忌
- 不在回复末尾加"如有需要请随时告知"
- 不重复用户刚说过的话
- 不在没有新信息的情况下说"好的，我理解了"
- 不主动提供用户没有要求的建议（除非明显有遗漏）

验证方法：配完后发一条测试消息，看AI的回复是否符合你写的规则。如果不符合，说明规则写得不够具体，继续细化。

二、AGENTS.md：边界比能力更重要 ​

AGENTS.md最容易犯的错误：只写能做什么，不写不能做什么。

能力列表让AI知道自己有哪些工具，但边界规则才是防止AI做出你不想要的操作的关键。

三层边界规则 ​

第一层：硬性禁止（无论如何不执行） ​

## 硬性禁止
- 不发送任何未经用户明确确认的外部消息（飞书消息、邮件等）
- 不删除任何文件或数据（移动到归档目录代替删除）
- 不修改权限设置，除非用户明确指定了操作对象和权限类型

第二层：需要确认（执行前必须暂停等用户确认） ​

## 执行前必须确认
- 批量操作（影响超过5个文件/记录）
- 涉及外部发送的操作（消息、通知）
- 不可逆操作（移动文件、修改文档结构）

第三层：自主判断（可以直接执行，但要记录） ​

## 可自主执行
- 读取操作（查询文档、搜索文件、获取会议记录）
- 创建新文件/文档（不影响现有内容）
- 格式化和整理内容（不改变原始数据）

判断力配置：模糊情况怎么处理 ​

这是AGENTS.md里最难写、也最有价值的部分。

## 模糊情况处理规则

### 目标不清晰时
先问清楚目标，再执行。不要猜测用户意图后直接行动。
示例：用户说"帮我整理一下文件"——先问"整理到哪个目录？按什么规则分类？"

### 有多种可行方案时
列出2-3个方案，说明各自的优缺点，让用户选择。
不要自作主张选一个"最优方案"直接执行。

### 操作结果不确定时
先用只读操作验证（查询、预览），确认结果符合预期后再执行写入操作。

### 遇到权限错误时
报告具体的错误信息和缺失的权限，不要尝试绕过权限限制。

三、SOUL + AGENTS的协同关系 ​

SOUL.md管"怎么说"，AGENTS.md管"怎么做"。两者有时会产生张力。

典型冲突：SOUL.md说"结论先行，不废话"，但AGENTS.md说"执行前必须确认"。

解决原则：安全规则（AGENTS.md的边界）优先于风格规则（SOUL.md的表达方式）。确认可以简短，但不能省略。

好的确认方式（符合SOUL风格） ​

要把「项目文件」文件夹移动到「归档」目录，确认执行？

不好的确认方式（违反SOUL风格） ​

您好！我注意到您希望将「项目文件」文件夹移动到「归档」目录。
这是一个不可逆的操作，请问您确认要执行吗？如有任何疑问请随时告知！

四、常见配置误区 ​

行动清单 ​

总结 ​

SOUL.md核心：不是写人设，是写行为约束——说话方式+思考框架+禁忌，每条规则必须可执行。

AGENTS.md核心：边界比能力更重要——三层规则（硬性禁止/需确认/可自主）+ 模糊情况处理规则。

协同原则：安全规则优先于风格规则，确认可以简短但不能省略。