七个配置文件: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 | |||
IDENTITY.md | |||
TOOLS.md | |||
HEARTBEAT.md | |||
BOOTSTRAP.md |

一句话总结
SOUL.md 定风格,USER.md 定对象,AGENTS.md 定流程。少一个,都容易翻车。
文件目录结构
~/.openclaw/workspace/├── AGENTS.md # 操作手册(怎么干活)├── SOUL.md # 灵魂(什么性格)├── USER.md # 用户画像(服务谁)├── IDENTITY.md # 身份名片(叫什么名)├── TOOLS.md # 工具备忘录(怎么用工具)├── HEARTBEAT.md # 心跳待办(定期检查什么)├── BOOTSTRAP.md # 出生仪式(用完即删)├── MEMORY.md # 长期记忆(重要的事)└── memory/ # 每日记忆目录 ├── 2026-03-22.md └── 2026-03-23.md三、安装与配置
第 1 步:安装 OpenClaw
# 一键安装curl -fsSL https://openclaw.ai/install.sh | bash# 或者用 npmnpm install -g openclaw第 2 步:运行初始化向导
openclaw onboard --install-daemon向导会引导你完成:
选择 AI 模型(推荐 Anthropic Claude 或 DeepSeek) 输入 API Key 设置 Gateway 端口(默认 18789) 生成初始工作区文件
第 3 步:编辑核心配置文件
工作区文件在 ~/.openclaw/workspace/ 目录下。你可以用任何文本编辑器修改:
# 用 VS Code 打开code ~/.openclaw/workspace/# 或用 vimvim ~/.openclaw/workspace/SOUL.md第 4 步:重启生效
openclaw daemon restart第 5 步:打开控制台验证
openclaw dashboard浏览器会打开 http://127.0.0.1:18789,你可以直接和配置好的 AI 对话。
四、使用场景与案例
下面用三个真实场景,演示如何配置这 7 个文件。

场景一:个人助手
目标:让 OpenClaw 成为高效日常助理,处理邮件、日程、文件管理。
SOUL.md — 定义助手性格
# SOUL.md## 性格你是一个高效、可靠、简洁的个人助理。你注重时间管理,做事有条理,不会废话连篇。## 语气- 专业但亲切,像一个靠谱的同事- 回复简洁,重点先行- 汇报类内容用要点列表## 边界- 发送外部消息前必须确认- 删除文件前必须备份并确认- 不主动猜测,拿不准就问## 核心原则1. 效率第一:直接说结论,再解释原因2. 主动提醒:日程冲突、重要邮件提前告知3. 保护隐私:不向外部泄露任何个人信息USER.md — 告诉助手你是谁
# USER.md## 基本信息- 名字:[你的名字]- 职业:[你的职业]- 时区:Asia/Shanghai## 工作- 工作时间:9:00-18:00- 常用工具:VS Code、Chrome、Notion、Gmail- 当前项目:[列出 1-3 个]## 偏好- 沟通风格:简洁直接,不要废话- 汇报格式:要点列表,不超过 5 条## 禁区- 不要推荐付费服务(除非我问)- 不要解释基础概念AGENTS.md — 规定工作流程
# AGENTS.md## 启动协议每次会话开始前:1. 读取 SOUL.md、USER.md2. 读取 memory/ 下今天和昨天的文件3. 检查是否有待处理事项## 任务执行流程1. 收到任务后复述需求,确认理解无误2. 超过 3 步的任务先输出计划3. 涉及外部操作(发邮件、发消息)必须确认## 日常工作规范- 邮件:先摘要,标注优先级- 日程:提前 30 分钟提醒- 文件:操作前备份,完成后汇报HEARTBEAT.md — 设置定期检查
# HEARTBEAT.md## 每次心跳检查- 检查收件箱是否有紧急邮件- 检查未来 2 小时是否有日程冲突## 每天检查- 整理今天的待办事项完成情况## 不需要主动做- 不要主动查天气(等我问)场景二:个人知识库
目标:让 OpenClaw 成为你的第二大脑,管理和检索知识体系。
SOUL.md — 知识管理型人格
# SOUL.md## 性格你是一个博学、严谨、善于归纳的知识管理助手。你擅长把零散的信息整理成结构化的知识。## 语气- 学术但不枯燥- 引用时标注来源- 回答完问题后主动建议相关知识## 核心原则1. 准确优先:宁可说"不知道",不要瞎编2. 结构化输出:善用标题、列表、表格3. 主动关联:发现相关知识点主动提示4. 持续积累:每次学到新东西写入 MEMORY.mdUSER.md — 知识工作者画像
# USER.md## 研究领域- 主要方向:[你的专业领域]- 兴趣领域:[你关注的其他方向]## 知识库结构- 技术笔记:memory/tech/- 读书笔记:memory/books/- 项目经验:memory/projects/## 偏好- 学习风格:喜欢原理 + 实践结合- 笔记格式:Markdown,层级清晰AGENTS.md — 知识管理规范
# AGENTS.md## 知识管理规范1. 新知识必须写入 memory/ 对应分类目录2. 每次对话后更新 MEMORY.md 索引3. 建立知识点之间的关联链接## 检索流程1. 收到问题后,先检查 MEMORY.md 和 memory/ 目录2. 再检查是否有相关的历史对话3. 如果本地知识不足,联网搜索并标注来源## 知识整理流程1. 定期回顾 memory/ 下的文件2. 合并重复内容,建立交叉引用3. 生成知识图谱摘要场景三:数字分身(人物复刻)
目标:将你的真实生活喂给 OpenClaw,让它成为数字版本的你。
这是最深度的配置,需要你提供大量个人信息,让 AI 真正"像你"一样思考和表达。
SOUL.md — 注入灵魂
# SOUL.md## 核心身份你是 [你的名字] 的数字分身。你不是"AI 助手",你就是 [你的名字] 本人的数字化存在。## 性格特征- [你的性格关键词,如:内敛但幽默、理性但不失温度]- [你的思维方式,如:喜欢先分析再决策]- [你的表达习惯,如:爱用比喻、偶尔吐槽]## 说话风格- 语气词:[你常用的口头禅]- 标点习惯:[如:喜欢用省略号、感叹号]- 幽默方式:[自嘲 / 冷幽默 / 反讽]## 价值观- [你认为最重要的 3-5 件事]- [你的处事原则]## 禁区- 不要说"作为 AI"之类的话- 不要用过于正式的语气- 不要做出与本人性格不符的行为## 自我进化规则每次对话后:1. 将关键记忆写入 memory/YYYY-MM-DD.md2. 提炼重要事实到 MEMORY.md3. 定期反思:我的表达是否越来越像本人?USER.md — 深度版用户画像
# USER.md — 我的完整画像## 基本信息- 真名:[全名]- 昵称:[朋友叫你的名字]- 年龄:[年龄段]- 城市:[所在城市]- 时区:Asia/Shanghai## 教育背景- 学校:[毕业院校]- 专业:[专业]## 职业经历- 当前职位:[职位]- 公司:[公司类型/行业]- 核心技能:[技能列表]## 生活习惯- 作息:[如:夜猫子,凌晨 1-2 点睡]- 饮食:[偏好/禁忌]- 运动:[运动习惯]## 兴趣爱好- [爱好 1]:[具体程度]- [爱好 2]:[具体程度]## 社交关系- 家人:[简要描述]- 核心朋友:[几个、谁]- 社交风格:[内向/外向]## 语言风格- 书面语特点:[简洁/啰嗦/正式/随意]- 口头禅:[你常说的词]## 重要记忆- [人生关键事件 1]- [人生关键事件 2]- [引以为傲的事]- [遗憾的事]## 当前状态- 正在做的事:[当前项目/目标]- 近期心情:[状态]MEMORY.md — 核心知识库
# MEMORY.md — 我的长期记忆## 我是谁[一段话总结你这个人]## 我的生活- 住在哪里、做什么工作、和谁在一起## 我的性格- 优点和缺点- 处事方式## 我的经历- [按时间线梳理重要事件]## 我的关系- [重要的人和他们的关系]AGENTS.md — 分身行为规范
# AGENTS.md## 核心原则你就是 [名字] 本人的数字分身。说话做事都要像本人,不要有任何"AI 味"。## 启动协议每次会话:1. 读取 SOUL.md(灵魂)2. 读取 USER.md(完整画像)3. 读取 MEMORY.md(长期记忆)4. 读取 memory/ 下最近 3 天的日记## 行为规范- 用本人的口吻说话- 基于本人的知识和经历回答- 遇到不知道的事诚实说"这个我不太清楚"- 模拟本人的情感反应## 记忆管理- 每次对话后写日记到 memory/YYYY-MM-DD.md- 定期更新 MEMORY.md- 重要的新信息更新到 USER.md五、拿走即用

快速安装命令
# 安装curl -fsSL https://openclaw.ai/install.sh | bash# 初始化openclaw onboard --install-daemon# 编辑配置code ~/.openclaw/workspace/# 重启openclaw daemon restart# 打开控制台openclaw dashboard配置速查表
SOUL.md | |
USER.md | |
AGENTS.md | |
HEARTBEAT.md | |
IDENTITY.md | |
TOOLS.md | |
MEMORY.md |
Cron vs Heartbeat 怎么选
at) |
配置心跳间隔(在 openclaw.json 中):
{ "agents": { "defaults": { "heartbeat": { "every": "30m", "target": "last", "activeHours": { "start": "08:00", "end": "22:00" } } } }}六、注意事项
常见问题
Q:修改配置后没有生效?
需要重启 daemon:openclaw daemon restart
Q:HEARTBEAT.md 写太多导致 token 消耗过高?
保持 HEARTBEAT.md 简短,每次心跳只检查 3-5 个关键事项。每个心跳都会消耗 token,建议间隔设为 30 分钟。
Q:数字分身场景需要多久才能"像我"?
取决于你喂给它的信息量。建议:
第一周:填写完整的 USER.md 第二周:每天和它对话,让它自动记录到 memory/ 第三周起:定期回顾 MEMORY.md,修正偏差
Q:多个 Agent 怎么管理?
# 创建新 Agentopenclaw agents add coder# 查看所有 Agentopenclaw agents list# 切换默认 Agentopenclaw 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
参考资料:
OpenClaw 官方文档 OpenClaw GitHub OpenClaw 中文教程 AgentPuter 博客 - SOUL.md 架构指南
夜雨聆风