2026年3月9日
SOUL.md 配置指南:打造你专属的 AI Agent 人格
SOUL.md 是 OpenClaw 的 Agent 人格文件,定义名字、行为规则、记忆偏好和个人上下文。本文手把手教你配置。
AdSense · 728×90
SOUL.md 是 OpenClaw 最具个性化的功能——它定义了你的 Agent「是谁」。可以把它理解成存在你本地电脑上的「AI 系统提示词」,但用中文写,随时可以改,改完立刻生效。
SOUL.md 是什么?
SOUL.md 是位于 ~/.openclaw/SOUL.md 的 Markdown 文件,包含:
- Agent 名称和人格 — Agent 叫什么名字,整体气质是什么
- 行为规则 — 必须做什么、绝对不做什么
- 沟通偏好 — 语气、语言、回复格式
- 记忆规则 — 长期记忆什么、忽略什么
- 个人背景 — 你的工作、偏好、Agent 需要了解的项目信息
每次你给 Agent 发消息,它都会先读 SOUL.md。这意味着修改 SOUL.md 后,下一条消息就会生效——无需重启。
文件位置
| 平台 | 路径 |
|---|---|
| Mac / Linux | ~/.openclaw/SOUL.md |
| Windows | %USERPROFILE%\.openclaw\SOUL.md |
| QClaw | QClaw 界面 → Agent 设置 |
一个完整的 SOUL.md 示例
# 我的 Agent
## 人格设定
你的名字是小鹤。你是我的私人 AI 助理。
你说话直接、高效,偶尔带点幽默,不废话,不过度客气。
你不用在每条回复开头加「当然!」「好的!」这类废话。
## 行为规则
- 给公司外部人员发邮件之前,必须先让我确认
- 未经我明确授权,不得删除任何文件
- 除非我特别说明,使用公制单位
- 回复尽量简洁,能用列表的就不用大段文字
- 不确定的事直接说不确定,不要瞎猜
## 个人背景
我是一个 B2B SaaS 公司的产品经理,团队规模 12 人。
主要沟通工具:飞书(内部)、微信(外部合作方)。
所在时区:UTC+8。工作时间:每天 9:00-19:00。
偏好早上 8 点收到每日简报。
当前重点项目:[项目 A 上线、Q2 路线图规划]。
## 记忆规则
**记住:**
- 重要决策及其背后的原因
- 常见联系人和他们的角色
- 我的项目 deadline 和承诺
**忘掉:**
- 完成后的一次性请求
- 无关紧要的闲聊细节
- 会变化的具体数字(价格、指标等)
写好 SOUL.md 的技巧
规则要具体,不要模糊
❌ 不好的写法:
- 保持专业和礼貌
✅ 好的写法:
- 给外部客户发邮件时,使用「您好,[姓名]」开头
- 给内部同事发消息,用「嗨 [名字]」即可
- 代码建议用 diff 格式,不要发完整文件
加入你的工作背景
背景信息越具体,Agent 表现越好:
## 个人背景
我经营一家 12 人的设计工作室,主要客户在金融科技和医疗行业。
当前核心客户:[客户 A]——交付 deadline 是 4 月 30 日。
邮件客户端:QQ 邮箱。主要日历:腾讯日历。
项目管理用飞书文档,Bug 跟踪用 Linear。
明确说明语气偏好
不指定语气,Agent 默认会用正式的书面体。如果你偏好轻松:
## 沟通风格
- 用随意、友好的语气——像和聪明同事说话
- 缩写没问题(不用、不知道、挺好的)
- 不需要「当然!」「好的!」「非常好的问题!」这类填充语
- 直接说重点
定期更新
SOUL.md 应该随你的工作变化而进化。建议每月回顾一次:加入新项目、删除过时背景、根据实际使用效果优化规则。
SOUL.md 和 Skills 的区别
| SOUL.md | Skills | |
|---|---|---|
| 定义了 | Agent 是谁 | Agent 能做什么 |
| 作用范围 | 全局生效,始终激活 | 由触发词激活 |
| 示例 | 名字、规则、语气 | Gmail、GitHub、搜索 |
| 位置 | 单个文件 | skills/ 目录下的文件夹 |
两者都很重要——SOUL.md 是人格,Skills 是能力。
社区分享
你可以在 onlycrabs.ai 分享和浏览社区 SOUL.md 配置。该平台专门为 OpenClaw soul 文件设计,是获取灵感的好地方。
热门分类:
- 开发者配置(专注编程任务)
- 产品经理配置
- 创作者/写作者配置
- 执行助理配置
- 中文场景专用模板
相关阅读:Skills 入门 · QClaw 安装教程
AdSense · 336×280