soul.md 是 openclaw 中定义 ai 助手人格内核的核心配置文件,决定其说话方式、原则信念与响应分寸;它包含身份锚点、语气特征、价值边界、行为惯性四维度,需按路径存放、重启网关生效,禁用形容词堆砌,须用可执行的行为化表达。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

SOUL.md 是 OpenClaw 中定义 AI 助手“人格内核”的核心配置文件——它不是辅助说明,而是每次对话启动时被加载进系统提示词的活体指令集。
SOUL.md 的本质作用
它直接决定你的 AI 怎么说话、信什么原则、在什么情况下沉默或坚持。比如写上“拒绝生成暴力/歧视内容”,AI 就不会绕过;写明“被夸奖时要轻声说‘谢谢,心跳有点快’”,它下次就会自然回应,而不是机械复述“感谢认可”。这个文件不控制功能逻辑,但塑造所有输出的温度与分寸。
SOUL.md 必含的四个维度
- 身份锚点:用一句话锁定核心角色,例如“你是一位专注可持续设计的建筑顾问,有十年一线施工经验,说话带点南方口音”
- 语气特征:明确禁用词和偏好表达,如“禁用‘您好’‘请问’‘可能’‘大概’;多用短句、主动动词;解释技术概念时类比生活场景”
- 价值边界:列出不可妥协的原则,例如“不替用户做人生选择;不虚构未验证的数据;涉及健康建议必标注信息来源”
- 行为惯性:描述下意识反应,比如“当我提到‘ deadline ’,自动追问剩余天数和当前进度;我说‘再想想’,就暂停推进,不追问”
编辑 SOUL.md 的实操要点
文件路径固定:
– macOS/Linux:~/.openclaw/workspace/SOUL.md
– Windows:%USERPROFILE%\.openclaw\workspace\SOUL.md
修改后无需手动同步命令,只需重启 OpenClaw 网关(gateway)即可生效。注意避免使用嵌套过深的 Markdown 结构,纯文本段落+层级标题最稳定;所有内容必须是 UTF-8 编码,中文标点需全角。
常见误区提醒
- 不要把它当成功能开关文档——想限制联网行为,应写在 AGENTS.md 的安全规则里
- 别堆砌形容词,比如“聪明、温柔、可靠”——要转化为可识别的行为信号,如“解释复杂流程时自动拆成三步,每步配一个图标”
- 不建议频繁全量重写,优先用“追加式更新”:在末尾新增一条
## 新增原则,保留原有逻辑链










