终于有人把 OpenClaw 配置文件讲清楚了！

前言

“这文件是干啥的？”、”我应该改哪个配置？”——每个养虾新手都会遇到的问题。

OpenClaw 的配置文件不少，但核心就 5 个。今天帮你彻底搞懂，以后改配置不迷路。

为什么配置文件这么重要？

配置文件是 Agent 的”人格说明书”。

你养的龙虾怎么说话、怎么做事、什么能干什么是不能干，全写在这些文件里。改对文件，龙虾才懂你；改错了，它就按默认方式跑，越用越别扭。开局随便写写，后面越养越乱，最后只能重建；但如果开局花 20 分钟写好配置文件，后面能省几十小时的调试时间。

5 个核心配置文件详解

IDENTITY.md - 身份证

定义 Agent 的基本身份：名称、Emoji、专长、边界、工作空间位置。

改名称、换 Emoji、调整专长范围时动它。开局必填。

配置示例：

1
2
3
4
5
Agent: your-agent-name
Emoji: 🤖
专长：你的 Agent 擅长做什么
不做什么：明确边界，不越权操作
工作空间：/home/node/.openclaw/workspace-your-agent/

SOUL.md - 人格说明书

定义沟通风格、价值观、行事底线、知识引用位置。

调整说话风格、修改行为准则时动它。开局必填。

配置示例：

1
2
3
4
5
6
7
## 💬 沟通风格
- 语气：温暖/专业/简洁（根据你的定位选择）
- 表达方式：用"你"不用"您"，避免 AI 套路用语

## 🧭 价值观
核心信念：用一句话概括你的核心信念
行事原则：列出 3-5 条必须遵守的原则

AGENTS.md - 操作手册

定义核心职责、工作流程、核心规范、协作 Agent、文件结构。

调整工作流程、增加新规范时动它。最常用，开局必填。

配置示例：

1
2
3
4
5
6
7
8
9
10
11
## 🎯 核心职责
用一句话说明你的 Agent 是干什么的

## 📋 工作流程
1. 第一步：输入是什么
2. 第二步：处理流程
3. 第三步：输出什么

## 🔧 核心规范
1. 必须遵守的规则 1
2. 必须遵守的规则 2

USER.md - 用户偏好

记录服务对象、特定偏好、平台偏好、文章类型。

服务对象变化、新增偏好时动它。可选，但建议写。

配置示例：

1
2
3
4
5
6
## 服务对象
你的个人/团队/公司名称

## 特定偏好
- 本地记录位置：notes/areas/记录文件.md
- 默认状态：Draft（草稿）/Published（已发布）

TOOLS.md - 工具箱

列出必需工具、必需命令、Skills 位置和使用方式。

新增工具、更新命令时动它。可选。

配置示例：

1
2
3
4
5
6
7
## 必需工具
- sessions_send - 跨 Agent 通信
- read - 读取文件内容
- exec - 执行 shell 命令

## 必需命令
your-command --option value

MEMORY.md - 记忆与偏好（可选）

用于存放长期有效的“记忆”，例如：长期项目背景、固定术语表、反复出现的约束、常用上下文链接等。

当你发现 Agent 总在重复问同一类背景信息，或需要稳定保持某些“长期设定”时，就把内容沉淀到这里。

重要建议：当 MEMORY.md 越写越大时，建议把详细内容沉到「第二大脑」（notes/、知识库页面、PARA 等）里，用链接在 MEMORY.md 中做索引与引用，而不是把所有内容都堆在一个文件里。

否则很容易导致上下文过长，影响模型命中关键信息与回复质量。

配置示例：

1
2
3
4
5
6
7
## 🧠 长期记忆
- 项目：OpenClaw / 青萍 Claw
- 常用术语：龙虾=Agent，养虾=配置与训练

## ✅ 必须长期遵守
- 不泄露密钥与隐私信息
- 输出先结论后解释

HEARTBEAT.md - 心跳与自检（可选）

用于定义 Agent 的“自检清单”或“健康检查节奏”。比如每次启动、每次对话前后，需要快速确认哪些状态（配置是否加载、关键依赖是否可用、记忆库是否可读等）。

适合需要长时间在线、并且希望“越用越稳”的场景。

配置示例：

1
2
3
4
5
6
7
## 🔁 启动自检
- 配置文件是否齐全（IDENTITY/SOUL/AGENTS）
- 必需工具是否可用（read/exec 等）

## 🧪 对话前检查
- 是否需要读取 MEMORY.md
- 是否需要刷新 notes/ 里的规范引用

常见坑和避坑指南

配置文件太大怎么办？

把详细规范移到 notes/ 目录，在配置文件中引用即可。配置文件保持精简，详细文档单独管理。

写错了怎么回滚？

建议用 Git 管理配置文件。改错了直接回滚：

1
git checkout HEAD -- AGENTS.md

没有 Git 就靠 drafts/ 目录的备份，定期备份配置文件。

修改频率对照表

文件 必填 修改频率
IDENTITY.md ✅ 低
SOUL.md ✅ 中
AGENTS.md ✅ 高
USER.md ❌ 中
TOOLS.md ❌ 低

开局顺序：IDENTITY.md → SOUL.md → AGENTS.md → 其他按需补充。

青萍 Claw 和养虾交流

关于青萍 Claw

青萍 Claw 是开箱即用的 OpenClaw 龙虾云端托管平台。

官网：https://claw.lusyoe.com

核心理念：龙虾不应该只是个聊天机器人，而应该是你的数字分身。

核心能力：

  • 📅 飞书日历与日程管理
  • 📝 微信公众号、知乎、小红书内容创作
  • 🧠 个人知识库与第二大脑
  • 📊 多维表格与数据处理
  • 🔍 网络搜索与信息检索
  • ⏰ 定时任务与自动化工作流
  • 💬 多平台消息（WhatsApp/Telegram/飞书）
  • 🎨 青萍 AI 专属技能（AI 生图、AI 视频）

云端托管，开箱即用，24 小时在线。

养虾交流

想学习更多 OpenClaw 龙虾的培育技巧？

关注公众号 【青萍叙事】，回复【养虾】加入交流群。

和志同道合的虾友一起交流养虾心得，分享实战经验。