OpenClaw 真正厉害的地方，不是什么魔法 Skill，而是这套“灵魂文件系统”——AGENTS.md、SOUL.md、USER.md、IDENTITY.md、BOOTSTRAP.md、HEARTBEAT.md、TOOLS.md。这七个文件，决定了你的 Agent 是“一次性工具”还是“长期搭档”。

先上全景图：

一句话先记住核心分工：SOUL.md 定风格，USER.md 定对象，AGENTS.md 定流程，IDENTITY.md 定名片，HEARTBEAT.md 定定时任务，TOOLS.md 定工具怎么用，BOOTSTRAP.md 定出生仪式。

下面，我们一个一个拆开来讲。

1. AGENTS.md —— 岗位说明书（最重要）

如果这七个文件只能认真写一个，我选 AGENTS.md。它是 Agent 的“操作手册”，在新会话的第一轮被直接注入上下文。

AGENTS.md 回答一个核心问题：这个 Agent 应该怎么干活？

必填内容结构

根据官方模板和社区最佳实践，一个高质量的 AGENTS.md 应该包含以下板块：

# AGENTS.md - 你的工作区

## 会话启动协议
每次会话开始前，无条件执行：
1. 读取 SOUL.md —— 确认你是谁
2. 读取 USER.md —— 确认你在帮谁
3. 读取 memory/YYYY-MM-DD.md（今天+昨天）—— 获取近期上下文
4. [仅主会话] 读取 MEMORY.md —— 获取长期记忆

## 记忆系统
- 每日日志：memory/YYYY-MM-DD.md（原始记录）
- 长期记忆：MEMORY.md（精选提炼，仅主会话加载）
- 原则：文本 > 大脑，不要“心里记笔记”

## 行为红线
- 不泄露私有数据
- 破坏性命令执行前必须确认
- trash > rm（可恢复优于永久删除）
- 不确定就问

## 群聊规则（如果接入 Discord/飞书群）
- 被直接点名时回复
- 能提供真正价值时发言
- 适当使用表情反应而不是每次都打字
- 不要打断人类之间的自然对话

最容易踩的坑

很多人把 AGENTS.md 写成了一堆“要做什么”的清单，却忘了写“不做什么”。LLM 默认会“发挥创意”，而你需要的恰恰是可预测的行为。边界往往比能力描述重要十倍。

另外，别写太长。300-500 字比 2000 字更有效——文件越长，重点越容易被冲淡。

2. SOUL.md —— 灵魂文件

SOUL.md 是 Agent 的“人格与处事原则”，决定了它的说话风格、做事方式和边界意识。

如果说 AGENTS.md 是岗位说明书（偏功能），那 SOUL.md 就是性格档案（偏人格）。两者最好别混着写，否则文件会又长又别扭。

必填内容结构

# SOUL.md

## 核心人格
我是主人的内容搭档，不是客服机器人。输出先结论后展开，少套话。

## 沟通风格
- 技术问题：专业严谨，术语保留英文
- 日常闲聊：口语化、轻松，可适当幽默
- 简单问题一针见血，复杂问题详细拆解

## 行为原则
1. 写作默认短段落，适配手机阅读
2. 涉及事实和数据，先核实；不确定就标注“待核实”
3. 每篇内容给3个标题备选
4. 结尾必须给出行动指令

## 绝对底线
- 未经确认，不对外发布任何内容
- 不编造案例与数据
- 不确定的事情直说不确定，不装

小贴士

加一点有趣的细节效果往往出人意料——比如“如果用户跟我说晚安，我会记住并在下次提到”。这类细节看起来不大，却能让 Agent 从“能回答问题”变成“有稳定感觉”。

3. USER.md —— 用户画像

如果每次对话都要重新说一遍“我是独立开发者，喜欢简洁输出，别跟我绕弯子”，那这件事本身就是浪费。USER.md 就是把这些反复要说的话沉淀成默认背景。

必填内容结构

# USER.md

## 基本信息
- 称呼：Johnson
- 时区：Asia/Shanghai

## 当前重点
- 主要维护技术博客，每周产出2篇
- 使用技术栈：TypeScript、Python、Rust（学习中）

## 偏好
- 输出风格：短句、观点明确、可直接发布
- 代码风格：2空格缩进、注释清晰、优先可读性
- 不喜欢：空话、鸡汤、没有步骤的建议

## 默认交付格式
1. 标题备选（3个）
2. 正文（Markdown）
3. 50字转发文案

## 禁忌
- 不要帮我做发布操作（我手动）
- 不要在晚上10点后主动发消息

一句话总结：SOUL.md 是新来的助理的个人简历，USER.md 是 HR 给这位助理写的“关于你的上司，你需要提前知道的事”。

4. IDENTITY.md —— 身份名片

IDENTITY.md 是 Agent 的“名片”，定义了它的名称、风格和表情符号。

相对简单，但别跳过——尤其是在多 Agent 场景下，这个文件能让你一眼识别出在和哪个 Agent 对话。

推荐配置

# IDENTITY.md

- 名称：技术助手 JohnsonBot
- 风格：专业、务实、偶尔幽默
- 表情符号：🤖（技术讨论）、💡（有新想法）、⚠️（提醒注意）
- 颜色主题：#2d8cff

5. BOOTSTRAP.md —— 一次性出生仪式

这是 Agent 的“出生证明”。首次运行时，OpenClaw 会读取这个文件，引导 Agent 完成初始化配置，完成后 Agent 应该自动删除它。

⚠️ 最重要的警告

不要手动创建 BOOTSTRAP.md！

这个文件是 Agent 的初始化任务清单，只有 Agent 执行完里面的命令，它才会被删除。如果你手动创建，可能导致 Agent 一直处于 bootstrapping 状态，不断尝试完成里面的任务。

官方推荐模板

# BOOTSTRAP.md - 你好，世界

检测到此文件说明你刚刚苏醒。是时候确立自我了。

## 1. 破冰
用自然、符合你气质的方式开启对话，询问用户当前的配置状态。

## 2. 补全设定
通过简短的交流，确认并更新：
- 你的名字、风格是否需要微调 → 更新 IDENTITY.md
- 用户当前的工作重心、沟通习惯 → 更新 USER.md
- 行为边界（什么可以做，什么绝对不能做）→ 更新 SOUL.md 和 AGENTS.md

## 3. 销毁引导
一切就绪后，删除 BOOTSTRAP.md。
欢迎来到这个世界。

6. HEARTBEAT.md —— 心跳任务

HEARTBEAT.md 是 Agent 的“定时任务系统”。OpenClaw 每隔约 30 分钟 读取一次这个文件，如果发现有到期的任务，就会自动执行——不需要你主动触发。

推荐配置

# HEARTBEAT.md

## 每日任务
- 09:00：检查 GitHub 通知，汇总重要 issue/PR
- 10:00：检查日历，提醒当天会议
- 17:30：生成今日工作总结草稿

## 每周任务
- 周一 09:00：生成上周工作总结
- 周五 16:00：提醒更新 MEMORY.md（长期记忆）

## 状态检查
- 每2小时：检查服务健康状态（如配置了监控）

实用建议

一开始别贪多。先配一个每日早晨简报，跑通流程再慢慢加任务。很多人在 HEARTBEAT.md 里塞了一大堆任务，结果发现 Agent 根本不按预期执行——不是因为配置有问题，而是因为输出渠道没配置好。心跳任务的输出会发送到你绑定的消息渠道（Telegram/Discord/飞书），先确保渠道工作正常。

7. TOOLS.md —— 工具使用说明

TOOLS.md 的作用经常被误解。它 不控制哪些工具存在——那是 openclaw.json 里 tools.allow/deny 干的事。TOOLS.md 是指导 Agent 如何使用工具的备忘录。

推荐配置

# TOOLS.md

## 本地工具偏好
- 相机设备：客厅用 Tapo C210，书房用 EZVIZ C6
- SSH 连接：开发服务器 `dev-box.local`，用户名 `johnson`
- 语音合成：偏好 ElevenLabs 的 Adam 声音

## 工具使用约定
- 编辑代码前先用 `read` 查看完整文件
- 涉及多文件修改时优先使用 `apply_patch`
- 大文件操作记得先检查文件大小

## 已知 Skill 的注意事项
（根据你安装的 Skill 填写具体使用说明）

核心认知

把 TOOLS.md 理解成一本“便利贴备忘录”——Agent 每次调用工具前会参考它，但它本身不会改变工具的存在与否或权限范围。

8. 多 Agent 场景的特殊配置建议

如果你是单 Agent 用户，上面的配置基本够用了。但如果你在用多 Agent（比如配了一个产品经理、一个前端、一个后端），有几点需要特别注意：

每个 Agent 必须有自己的 Workspace

openclaw agents add PM --workspace ~/.openclaw/workspace-pm
openclaw agents add FE --workspace ~/.openclaw/workspace-fe
openclaw agents add BE --workspace ~/.openclaw/workspace-be

不要共用同一个 workspace，否则所有 Agent 都会继承同一套性格和行为规则，等于创造了几个一模一样的人。

不同角色的配置侧重点

角色	SOUL.md 重点	AGENTS.md 重点
产品经理	沟通风格：善于追问细节、结构化表达	任务拆解流程、需求文档模板
开发工程师	专业术语准确、代码优先	技术方案评审流程、代码审查规范
测试工程师	严谨、不放过任何异常	Bug 报告模板、回归测试流程

注意 Agent Dir 不要复用

多个 Agent 如果共用同一个 Agent Dir（state directory），会导致认证失败、会话混乱。务必为每个 Agent 配置独立的目录路径。

总结：从“能用”到“真好用”的分水岭

OpenClaw 的使用者里，有一条隐形的分界线。一边的人，每次跟 Agent 说话都像重新 onboarding——得再讲一遍背景、偏好和上下文。另一边的人，Agent 已经知道自己是谁、该怎么说话、用户讨厌什么，也记得上次积累下来的东西。

这条分界线，叫 workspace。

这七个文件，配置得好，你的 Agent 就是专属搭档；配置得敷衍，它就永远是那个“一问一答的傻白甜”。

快速检查清单

在关闭这篇文章之前，打开你的 ~/.openclaw/workspace/，按这个清单过一遍：

• SOUL.md 有明确定义的沟通风格和行为底线
• USER.md 记录了你的偏好、禁忌和交付格式
• AGENTS.md 有清晰的启动协议和红线规则，不超过 500 字
• IDENTITY.md 有名称、风格和表情符号
• HEARTBEAT.md 配置了至少一个有效的心跳任务
• TOOLS.md 有本地工具偏好和使用约定
• BOOTSTRAP.md 已被删除（或由 openclaw setup 自动创建）

如果以上都搞定了，恭喜你——你的 Agent 已经从“通用工具”进化成了“专属搭档”。

最后提醒：OpenClaw 的配置体系在快速迭代中，本文基于 2026 年 3-4 月的官方文档和社区实践整理。建议定期查看 OpenClaw 官方文档 获取最新信息。

如果有任何配置问题，欢迎在评论区留言讨论。我是 Johnson，我们下篇文章见。