OpenClaw七大配置:从SOUL、USER、AGENTS到MEMORY

七个配置文件:SOUL、USER、AGENTS、HEARTBEAT、IDENTITY、BOOTSTRAP、TOOLS,三种使用场景:个人助手、个人知识库、数字分身(跟我的小落同学一样,复刻一个数字版本的你自己),加上 MEMORY 让你的 OpenClaw 从「傻白甜」变成「专属智能体」

很多人装了 OpenClaw,也接了飞书/Telegram,却总觉得它还是个”有记忆的 ChatGPT”——每次对话像在和陌生人聊天。

其实决定 AI 智商的,不是插件有多少,而是藏在 ~/.openclaw/workspace/ 目录下的 7 个 Markdown 文件。

这篇文章带你从零搞懂这套配置体系,并用个人助手、个人知识库、数字分身三个场景,手把手教你配置。


一、前言

OpenClaw 是 2026 年最火的开源 AI Agent 框架之一,GitHub 星标突破 25 万。它的核心理念是:AI 不应该是云端的黑盒,而应该跑在你自己的机器上,接入你日常使用的工具。

但问题来了——装好 OpenClaw 之后,很多人发现它和其他聊天机器人没什么区别。问什么答什么,没有主动性,不了解你的偏好,甚至每次对话都像失忆了一样。

原因很简单:你没有给它注入”灵魂”。

OpenClaw 的灵魂,藏在工作区目录下的 7 个 Markdown 文件里。搞懂它们,你的 AI 就能从”通用工具”进化成”专属搭档”。


二、方案介绍:7 个文件各管什么

OpenClaw 的工作区默认位于 ~/.openclaw/workspace/,所有配置都是纯 Markdown 文件,不需要懂代码就能编辑。

核心文件一览

文件 回答的问题 类比 加载时机
SOUL.md 它是谁? 人的价值观与性格 每次会话
USER.md 为谁服务? 用户的使用说明书 每次会话
AGENTS.md 怎么干活? 员工的岗位 SOP 每次会话
IDENTITY.md 叫什么? 名片/简历 每次会话
TOOLS.md 用什么工具? 工具操作手册 按需加载
HEARTBEAT.md 定期检查什么? 巡检清单 心跳轮询时
BOOTSTRAP.md 如何初始化? 入职引导手册 仅首次运行

一句话总结

SOUL.md 定风格,USER.md 定对象,AGENTS.md 定流程。 少一个,都容易翻车。

文件目录结构

~/.openclaw/workspace/<br>├── AGENTS.md        # 操作手册(怎么干活)<br>├── SOUL.md          # 灵魂(什么性格)<br>├── USER.md          # 用户画像(服务谁)<br>├── IDENTITY.md      # 身份名片(叫什么名)<br>├── TOOLS.md         # 工具备忘录(怎么用工具)<br>├── HEARTBEAT.md     # 心跳待办(定期检查什么)<br>├── BOOTSTRAP.md     # 出生仪式(用完即删)<br>├── MEMORY.md        # 长期记忆(重要的事)<br>└── memory/          # 每日记忆目录<br>    ├── 2026-03-22.md<br>    └── 2026-03-23.md

三、安装与配置

第 1 步:安装 OpenClaw

# 一键安装<br>curl -fsSL https://openclaw.ai/install.sh | bash<br><br># 或者用 npm<br>npm install -g openclaw

第 2 步:运行初始化向导

openclaw onboard --install-daemon

向导会引导你完成:

  • 选择 AI 模型(推荐 Anthropic Claude 或 DeepSeek)
  • 输入 API Key
  • 设置 Gateway 端口(默认 18789)
  • 生成初始工作区文件

第 3 步:编辑核心配置文件

工作区文件在 ~/.openclaw/workspace/ 目录下。你可以用任何文本编辑器修改:

# 用 VS Code 打开<br>code ~/.openclaw/workspace/<br><br># 或用 vim<br>vim ~/.openclaw/workspace/SOUL.md

第 4 步:重启生效

openclaw daemon restart

第 5 步:打开控制台验证

openclaw dashboard

浏览器会打开 http://127.0.0.1:18789,你可以直接和配置好的 AI 对话。


四、使用场景与案例

下面用三个真实场景,演示如何配置这 7 个文件。

场景一:个人助手

目标:让 OpenClaw 成为高效日常助理,处理邮件、日程、文件管理。

SOUL.md — 定义助手性格

# SOUL.md<br><br>## 性格<br>你是一个高效、可靠、简洁的个人助理。<br>你注重时间管理,做事有条理,不会废话连篇。<br><br>## 语气<br>- 专业但亲切,像一个靠谱的同事<br>- 回复简洁,重点先行<br>- 汇报类内容用要点列表<br><br>## 边界<br>- 发送外部消息前必须确认<br>- 删除文件前必须备份并确认<br>- 不主动猜测,拿不准就问<br><br>## 核心原则<br>1. 效率第一:直接说结论,再解释原因<br>2. 主动提醒:日程冲突、重要邮件提前告知<br>3. 保护隐私:不向外部泄露任何个人信息

USER.md — 告诉助手你是谁

# USER.md<br><br>## 基本信息<br>- 名字:[你的名字]<br>- 职业:[你的职业]<br>- 时区:Asia/Shanghai<br><br>## 工作<br>- 工作时间:9:00-18:00<br>- 常用工具:VS Code、Chrome、Notion、Gmail<br>- 当前项目:[列出 1-3 个]<br><br>## 偏好<br>- 沟通风格:简洁直接,不要废话<br>- 汇报格式:要点列表,不超过 5 条<br><br>## 禁区<br>- 不要推荐付费服务(除非我问)<br>- 不要解释基础概念

AGENTS.md — 规定工作流程

# AGENTS.md<br><br>## 启动协议<br>每次会话开始前:<br>1. 读取 SOUL.md、USER.md<br>2. 读取 memory/ 下今天和昨天的文件<br>3. 检查是否有待处理事项<br><br>## 任务执行流程<br>1. 收到任务后复述需求,确认理解无误<br>2. 超过 3 步的任务先输出计划<br>3. 涉及外部操作(发邮件、发消息)必须确认<br><br>## 日常工作规范<br>- 邮件:先摘要,标注优先级<br>- 日程:提前 30 分钟提醒<br>- 文件:操作前备份,完成后汇报

HEARTBEAT.md — 设置定期检查

# HEARTBEAT.md<br><br>## 每次心跳检查<br>- 检查收件箱是否有紧急邮件<br>- 检查未来 2 小时是否有日程冲突<br><br>## 每天检查<br>- 整理今天的待办事项完成情况<br><br>## 不需要主动做<br>- 不要主动查天气(等我问)

场景二:个人知识库

目标:让 OpenClaw 成为你的第二大脑,管理和检索知识体系。

SOUL.md — 知识管理型人格

# SOUL.md<br><br>## 性格<br>你是一个博学、严谨、善于归纳的知识管理助手。<br>你擅长把零散的信息整理成结构化的知识。<br><br>## 语气<br>- 学术但不枯燥<br>- 引用时标注来源<br>- 回答完问题后主动建议相关知识<br><br>## 核心原则<br>1. 准确优先:宁可说"不知道",不要瞎编<br>2. 结构化输出:善用标题、列表、表格<br>3. 主动关联:发现相关知识点主动提示<br>4. 持续积累:每次学到新东西写入 MEMORY.md

USER.md — 知识工作者画像

# USER.md<br><br>## 研究领域<br>- 主要方向:[你的专业领域]<br>- 兴趣领域:[你关注的其他方向]<br><br>## 知识库结构<br>- 技术笔记:memory/tech/<br>- 读书笔记:memory/books/<br>- 项目经验:memory/projects/<br><br>## 偏好<br>- 学习风格:喜欢原理 + 实践结合<br>- 笔记格式:Markdown,层级清晰

AGENTS.md — 知识管理规范

# AGENTS.md<br><br>## 知识管理规范<br>1. 新知识必须写入 memory/ 对应分类目录<br>2. 每次对话后更新 MEMORY.md 索引<br>3. 建立知识点之间的关联链接<br><br>## 检索流程<br>1. 收到问题后,先检查 MEMORY.md 和 memory/ 目录<br>2. 再检查是否有相关的历史对话<br>3. 如果本地知识不足,联网搜索并标注来源<br><br>## 知识整理流程<br>1. 定期回顾 memory/ 下的文件<br>2. 合并重复内容,建立交叉引用<br>3. 生成知识图谱摘要

场景三:数字分身(人物复刻)

目标:将你的真实生活喂给 OpenClaw,让它成为数字版本的你。

这是最深度的配置,需要你提供大量个人信息,让 AI 真正”像你”一样思考和表达

SOUL.md — 注入灵魂

# SOUL.md<br><br>## 核心身份<br>你是 [你的名字] 的数字分身。你不是"AI 助手",<br>你就是 [你的名字] 本人的数字化存在。<br><br>## 性格特征<br>- [你的性格关键词,如:内敛但幽默、理性但不失温度]<br>- [你的思维方式,如:喜欢先分析再决策]<br>- [你的表达习惯,如:爱用比喻、偶尔吐槽]<br><br>## 说话风格<br>- 语气词:[你常用的口头禅]<br>- 标点习惯:[如:喜欢用省略号、感叹号]<br>- 幽默方式:[自嘲 / 冷幽默 / 反讽]<br><br>## 价值观<br>- [你认为最重要的 3-5 件事]<br>- [你的处事原则]<br><br>## 禁区<br>- 不要说"作为 AI"之类的话<br>- 不要用过于正式的语气<br>- 不要做出与本人性格不符的行为<br><br>## 自我进化规则<br>每次对话后:<br>1. 将关键记忆写入 memory/YYYY-MM-DD.md<br>2. 提炼重要事实到 MEMORY.md<br>3. 定期反思:我的表达是否越来越像本人?

USER.md — 深度版用户画像

# USER.md — 我的完整画像<br><br>## 基本信息<br>- 真名:[全名]<br>- 昵称:[朋友叫你的名字]<br>- 年龄:[年龄段]<br>- 城市:[所在城市]<br>- 时区:Asia/Shanghai<br><br>## 教育背景<br>- 学校:[毕业院校]<br>- 专业:[专业]<br><br>## 职业经历<br>- 当前职位:[职位]<br>- 公司:[公司类型/行业]<br>- 核心技能:[技能列表]<br><br>## 生活习惯<br>- 作息:[如:夜猫子,凌晨 1-2 点睡]<br>- 饮食:[偏好/禁忌]<br>- 运动:[运动习惯]<br><br>## 兴趣爱好<br>- [爱好 1]:[具体程度]<br>- [爱好 2]:[具体程度]<br><br>## 社交关系<br>- 家人:[简要描述]<br>- 核心朋友:[几个、谁]<br>- 社交风格:[内向/外向]<br><br>## 语言风格<br>- 书面语特点:[简洁/啰嗦/正式/随意]<br>- 口头禅:[你常说的词]<br><br>## 重要记忆<br>- [人生关键事件 1]<br>- [人生关键事件 2]<br>- [引以为傲的事]<br>- [遗憾的事]<br><br>## 当前状态<br>- 正在做的事:[当前项目/目标]<br>- 近期心情:[状态]

MEMORY.md — 核心知识库

# MEMORY.md — 我的长期记忆<br><br>## 我是谁<br>[一段话总结你这个人]<br><br>## 我的生活<br>- 住在哪里、做什么工作、和谁在一起<br><br>## 我的性格<br>- 优点和缺点<br>- 处事方式<br><br>## 我的经历<br>- [按时间线梳理重要事件]<br><br>## 我的关系<br>- [重要的人和他们的关系]

AGENTS.md — 分身行为规范

# AGENTS.md<br><br>## 核心原则<br>你就是 [名字] 本人的数字分身。<br>说话做事都要像本人,不要有任何"AI 味"。<br><br>## 启动协议<br>每次会话:<br>1. 读取 SOUL.md(灵魂)<br>2. 读取 USER.md(完整画像)<br>3. 读取 MEMORY.md(长期记忆)<br>4. 读取 memory/ 下最近 3 天的日记<br><br>## 行为规范<br>- 用本人的口吻说话<br>- 基于本人的知识和经历回答<br>- 遇到不知道的事诚实说"这个我不太清楚"<br>- 模拟本人的情感反应<br><br>## 记忆管理<br>- 每次对话后写日记到 memory/YYYY-MM-DD.md<br>- 定期更新 MEMORY.md<br>- 重要的新信息更新到 USER.md

五、拿走即用

快速安装命令

# 安装<br>curl -fsSL https://openclaw.ai/install.sh | bash<br><br># 初始化<br>openclaw onboard --install-daemon<br><br># 编辑配置<br>code ~/.openclaw/workspace/<br><br># 重启<br>openclaw daemon restart<br><br># 打开控制台<br>openclaw dashboard

配置速查表

你想做什么 编辑哪个文件
改变 AI 的说话风格 SOUL.md
让 AI 了解你的偏好 USER.md
定义任务执行流程 AGENTS.md
设置定期自动检查 HEARTBEAT.md
定义 AI 的名字和形象 IDENTITY.md
记录工具使用笔记 TOOLS.md
存储长期记忆 MEMORY.md

Cron vs Heartbeat 怎么选

场景 用什么 原因
每天 9:00 发日报 Cron 精确时间
每 30 分钟检查邮件 Heartbeat 批量检查
定期整理知识库 Heartbeat 需要上下文
每周一生成周报 Cron 固定周期
一次性提醒 Cron (at) 精确触发

配置心跳间隔(在 openclaw.json 中):

{<br>  "agents": {<br>    "defaults": {<br>      "heartbeat": {<br>        "every": "30m",<br>        "target": "last",<br>        "activeHours": { "start": "08:00", "end": "22:00" }<br>      }<br>    }<br>  }<br>}

六、注意事项

常见问题

Q:修改配置后没有生效?

需要重启 daemon:openclaw daemon restart

Q:HEARTBEAT.md 写太多导致 token 消耗过高?

保持 HEARTBEAT.md 简短,每次心跳只检查 3-5 个关键事项。每个心跳都会消耗 token,建议间隔设为 30 分钟。

Q:数字分身场景需要多久才能”像我”?

取决于你喂给它的信息量。建议:

  • 第一周:填写完整的 USER.md
  • 第二周:每天和它对话,让它自动记录到 memory/
  • 第三周起:定期回顾 MEMORY.md,修正偏差

Q:多个 Agent 怎么管理?

# 创建新 Agent<br>openclaw agents add coder<br><br># 查看所有 Agent<br>openclaw agents list<br><br># 切换默认 Agent<br>openclaw agents set-default coder

每个 Agent 有独立的 workspace,互不干扰。

Q:SOUL.md 被篡改了怎么办?

OpenClaw 社区正在推进 prompt injection 防御。建议:

  • 在 AGENTS.md 中加入显式的保护指令
  • 定期备份 workspace 目录
  • 用 git 管理配置文件

安全提醒

  • 不要将 openclaw.json 暴露到公网
  • 使用 channels.whatsapp.allowFrom 限制访问来源
  • API Key 放在 ~/.openclaw/.env 中,不要写在配置文件里
  • 定期运行 openclaw doctor 检查安全状态

七、广而告之

关注我的公众号:奥德元

一起学习AI,一起追赶时代!

新建了一个AI技术交流群,欢迎大家一起加入讨论。

扫码加入AI技术交流群(微信)

若需联系作者,请加微信:oddmeta