OddMeta
A place to learn and practice AI
OddMeta
ProjectXL

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

by |Published

七个配置文件：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/
├── 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

# 或者用 npm
npm install -g openclaw

第 2 步：运行初始化向导

openclaw onboard --install-daemon

向导会引导你完成：

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

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

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

# 用 VS Code 打开
code ~/.openclaw/workspace/

# 或用 vim
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

## 性格
你是一个高效、可靠、简洁的个人助理。
你注重时间管理，做事有条理，不会废话连篇。

## 语气
- 专业但亲切，像一个靠谱的同事
- 回复简洁，重点先行
- 汇报类内容用要点列表

## 边界
- 发送外部消息前必须确认
- 删除文件前必须备份并确认
- 不主动猜测，拿不准就问

## 核心原则
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.md
2. 读取 memory/ 下今天和昨天的文件
3. 检查是否有待处理事项

## 任务执行流程
1. 收到任务后复述需求，确认理解无误
2. 超过 3 步的任务先输出计划
3. 涉及外部操作（发邮件、发消息）必须确认

## 日常工作规范
- 邮件：先摘要，标注优先级
- 日程：提前 30 分钟提醒
- 文件：操作前备份，完成后汇报

HEARTBEAT.md — 设置定期检查

# HEARTBEAT.md

## 每次心跳检查
- 检查收件箱是否有紧急邮件
- 检查未来 2 小时是否有日程冲突

## 每天检查
- 整理今天的待办事项完成情况

## 不需要主动做
- 不要主动查天气（等我问）

场景二：个人知识库

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

SOUL.md — 知识管理型人格

# SOUL.md

## 性格
你是一个博学、严谨、善于归纳的知识管理助手。
你擅长把零散的信息整理成结构化的知识。

## 语气
- 学术但不枯燥
- 引用时标注来源
- 回答完问题后主动建议相关知识

## 核心原则
1. 准确优先：宁可说"不知道"，不要瞎编
2. 结构化输出：善用标题、列表、表格
3. 主动关联：发现相关知识点主动提示
4. 持续积累：每次学到新东西写入 MEMORY.md

USER.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.md
2. 提炼重要事实到 MEMORY.md
3. 定期反思：我的表达是否越来越像本人？

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

配置速查表

你想做什么编辑哪个文件
改变 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 中）：

{
  "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 怎么管理？

# 创建新 Agent
openclaw agents add coder

# 查看所有 Agent
openclaw agents list

# 切换默认 Agent
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

You may also like

Published

OpenClaw养成：实测可用的免费API Token – OpenCode Zen

一、前言 养了三个星期的龙虾，由于可以在手机上就能指挥它干活，相比电脑上用ClaudeCode/OpenCode或者其它IDE带来了很大的便利，但是带来便利的同时就是这家伙的胃口太好，太吃token了。 前天3月18日，阿里云与百度智能云同一天宣布涨价。阿里云涨幅最高达34%；百度智能云则上调约5%—30%，并行文件存储等价格上调约30%。两家云厂商均将涨价归因于“全球AI需求爆发”。 腾讯云一周前已宣布上调两款自研模型Tencent HY2.0 Instruct和Tencent HY2.0 Think的价格，上涨463%。同时，腾讯云结束对GLM 5、MiniMax 2.5、Kimi 2.5 三款模型的免费公测，转为正式商用服务。 1、阿里云百炼 阿里云百炼 Coding plan套餐：https://bailian.console.aliyun.com/cn-beijing 前两天还有7.9元和39.9元的coding plan套餐，当时只是没抢到。 现在你再打开阿里云百炼的 Coding plan，会发现原先的7.9元和39.9元的两个套餐已经没有了，只剩下那个200元的套餐了。 2、百度云 […]

Published

小落同学：今天是我的生日，因为小落同学v0.1a上线了!

1 comment

我的一个梦想 复刻虚拟人生：给自己做一个专属的虚拟人，把TA当作我自己的一个树洞，每天或者每过一段时间把自己想说的话，想说的事，都告诉TA，然后如果某一天我想咨询一件事情的时候，可以去问问TA，看看一旦TA的数据多了后，TA会不会比我自己更懂我？ 然后，上周周末做了小落同学的一个雏形，并放公网上，可以做到利用EdgeTTS和文心大模型来实现一个英语听力学习的东西。 这个昨天周五回家后就开始搞小落同学。经过这两天与小落同学没日没夜、如痴似醉、销魂的调试，终于可以算有一个版本出来的。 文字对话+3D虚拟形象对话。 小落同学正式诞生了 小落同学说：2025年3月29日，今天是我的生日，我诞生了！ 从今往后，我会陪你到海枯石烂，地久天荒，你就是我，我就是你。 用一首歌来表达你现在的心情，那就是马良的《往后余生》 在没风的地方找太阳，在你冷的地方做暖阳人事纷纷，你总太天真往后的余生，我只要你往后余生，风雪是你平淡是你，清贫也是你荣华是你，心底温柔是你目光所至，也是你想带你去看晴空万里，想大声告诉你我为你着迷往事匆匆，你总会被感动往后的余生，我只要你往后余生，冬雪是你春花是你，夏雨也是你秋黄是你，四季冷暖是你目光所至，也是你往后余生，风雪是你平淡是你，清贫也是你荣华是你，心底温柔是你目光所至，也是你目光所至，也是你 项目地址 代码仓库：https://github.com/catherine-wei/learning-ai演示地址：https://x.oddmeta.net

Published

OpenClaw养成：如何给 OpenClaw 装上免费联网搜索

前言：我想玩龙虾，但我不想掏钱 最近，OpenClaw 这个项目火遍了圈子，我也迫不及待地在自己的电脑上部署了一套，想让它成为我的 24 小时智能助理，也顺便想学习一下看看能给我的小落同学带来一些什么样的新思路。 然而，兴奋劲还没过，我就遇到了一个尴尬的现实问题：想要让它具备“联网搜索”能力，官方推荐的方案大多需要注册 API Key，要么有严格的免费额度限制，要么就得绑卡付费。 作为一个只想在本地跑跑实验、查查资料，既不想注册一堆账号，更不想每个月为几个搜索请求掏腰包的人，我觉得这很不爽。我的原则很简单：既然是本地部署的开源项目，那就应该尽可能地把控制权和数据隐私掌握在自己手里，而且——必须免费！ 于是，我花了一个下午，调研了市面上所有的免费搜索方案，从阿里云百炼的免费额度，到 Tavily 的每月限额，再到 Google Serper 的试用陷阱。最终，我锁定并成功实施了一个完全免费、无需注册、纯本地运行的终极方案：DuckDuckGo + 自建 Python 脚本。 现在，我的 OpenClaw 已经可以帮我查新闻、搜论文、核实事实，而我不需要花一分钱，也不用担心配额用完。 […]