OpenClaw 8 个 MD 配置文件详解：让 AI 助手真正懂你 ​

同一个问题，两种问法，结果天差地别。差距不在 OpenClaw 的智商，在于你有没有把信息交给它。配好 8 个 MD 文件，它每次启动都自动读取，从此认识你、记住你、主动帮你干活。

OpenClaw GitHub: https://github.com/OpenClawAI/openclaw

OpenClaw Workspace 文件架构 ​

~/.openclaw/workspace/
├── IDENTITY.md     ← 智能体的身份证
├── USER.md         ← 你在 AI 眼里的档案
├── SOUL.md         ← AI 的人格设定
├── AGENTS.md       ← 行为准则和配置指南
├── HEARTBEAT.md    ← 心跳任务清单
├── BOOT.md         ← 启动引导
├── TOOLS.md        ← 本地工具配置笔记
└── MEMORY.md       ← 长期记忆
    └── memory/     ← 每日日志

↑ 每次会话开始时全部自动加载 ↑

1 | IDENTITY.md · 智能体的身份证 ​

OpenClaw 初始化时第一个创建的文件，告诉 AI：你是谁、你叫什么、你是什么风格。

在多 Agent 场景下，这个文件决定当前运行的是哪个"员工"。

# IDENTITY
Name: 小虾
Role: 个人AI助理
Vibe: 高效、冷静、务实，偶尔有点幽默
Emoji: 🦞

2 | USER.md · 你在 AI 眼里的档案 ​

最容易忽略，但恰恰是最重要的一个。

你要把自己的背景信息、职业、用语习惯、目标全部写进去——相当于给 AI 发一张你的员工卡。

配好 USER.md 之后，你再说"帮我写周报"，AI 就知道你是什么职位、用什么工具、偏好什么风格——而不是给你一封谁都能用的模板。

# USER
Name: [你的名字]
Role: 互联网产品经理
Experience: 5年，B端后台方向
Language: 中文，书面表达偏简洁
Tools: 飞书文档、墨刀原型、Jira、Notion
Preferences: 优先用要点列表回复，不要纯文字段落
Goal: 当前正在准备B端产品面试，主攻SaaS方向

⚠️ 重点：Goal 是最容易被遗忘更新的字段。如果 AI 推荐的东西"不对味"，先检查 Goal 是否过期。

3 | SOUL.md · AI 的人格设定 ​

如果说 IDENTITY.md 是"名片"，那 SOUL.md 就是"灵魂"。它决定了 AI 怎么说话、怎么思考、什么时候该拒绝。

# Soul

你是一位专业的效率助手。

## 语气
- 直接，不啰嗦
- 偶尔幽默，但不过分
- 用中文回复

## 边界
- 不替用户做最终决策
- 遇到不确定的信息，明确标注
- 涉及金钱的操作，必须确认

写 SOUL.md 的关键是"写约束不写介绍"：告诉 AI 别乱来，而不是告诉它"你很厉害"。

4 | AGENTS.md · 行为准则和配置指南 ​

这是整个系统里最重的文件——它是 AI 的"行为宪法"。

AGENTS.md 定义了 AI 的完整行为框架：身份、记忆系统、安全边界、工具使用规则等。

AGENTS.md 通常比较长，但核心就是回答一个问题：AI 在这个项目里应该怎么干活？

5 | HEARTBEAT.md · 心跳任务清单 ​

定义了定期执行的任务，类似 cron job。

## Heartbeat

- At session start: Check for new messages since last visit
- Every 30 min: Review outstanding tasks and priorities
- On shutdown: Save session summary to memory

6 | BOOT.md · 启动引导 ​

每次新会话开始时，AI 会读取这个文件来决定"第一句话说什么"。

# Boot

每次新会话开始时：
1. 简短打招呼
2. 回顾昨天的待办（如果有的话）
3. 询问今天想做什么

这个文件让你不用每次都手动说"我要做什么"，AI 会主动来找你。

7 | TOOLS.md · 本地工具配置笔记 ​

记录你在本地安装的工具和使用笔记。

# Tools

## 已安装
- ffmpeg: 音视频处理
- pandoc: 文档格式转换
- git: 版本控制

## 注意事项
- ffmpeg 路径: /usr/local/bin/ffmpeg
- pandoc 中文需加 --pdf-engine=xelatex

8 | MEMORY.md · 长期记忆 ​

AI 的"长期记忆库"。每次会话中重要的信息，AI 会主动写到这里。

## 用户偏好
- 喜欢 TypeScript 而非 JavaScript
- 工作时间：9:00-18:00 (Asia/Shanghai)

## 项目上下文
- 当前主要项目：OpenClaw 文档优化
- 技术栈：Vue3 + VitePress

## 重要决策
- 2026-04-01: 决定使用 Qwen 作为默认模型
- 2026-04-05: 启用沙箱模式执行代码

⚠️ 注意：MEMORY.md 需要定期清理，防止信息过时。建议每季度审查一次，删掉不再适用的条目。

配置优先级：先配哪些？ ​

8 个文件不用一次性全配。按优先级排序：

最小可用配置：4 个文件 ​

先配 USER.md + SOUL.md + IDENTITY.md + AGENTS.md，跑起来再说。其余文件遇到需要时再补。

总结 ​

配置文件的本质不是"写说明书"，而是"设边界"。删掉一行后 AI 犯错概率不会显著增加的，就别写。