type
Post
status
Published
date
slug
openclaw-agents.md-user.md-soul.md
summary
面对 OpenClaw 的一堆配置文件不知道如何下手？本文详解 5 个核心文件的作用和配置示例，10 分钟读完，以后改配置不迷路。
category
OpenClaw
tags
实用教程
create_time
Mar 24, 2026 11:10 AM
icon
password
my_create_time
2026年3月24日 20:38
前言
"这文件是干啥的？"、"我应该改哪个配置？"——每个养虾新手都会遇到的问题。
OpenClaw 的配置文件不少，但核心就 5 个。今天帮你彻底搞懂，以后改配置不迷路。
一、为什么配置文件这么重要？
配置文件是 Agent 的"人格说明书"。
你养的龙虾怎么说话、怎么做事、什么能干什么是不能干，全写在这些文件里。改对文件，龙虾才懂你；改错了，它就按默认方式跑，越用越别扭。开局随便写写，后面越养越乱，最后只能重建；但如果开局花 20 分钟写好配置文件，后面能省几十小时的调试时间。
二、5 个核心配置文件详解
IDENTITY.md - 身份证
定义 Agent 的基本身份：名称、Emoji、专长、边界、工作空间位置。
改名称、换 Emoji、调整专长范围时动它。开局必填。
配置示例：
SOUL.md - 人格说明书
定义沟通风格、价值观、行事底线、知识引用位置。
调整说话风格、修改行为准则时动它。开局必填。
配置示例：
AGENTS.md - 操作手册
定义核心职责、工作流程、核心规范、协作 Agent、文件结构。
调整工作流程、增加新规范时动它。**最常用**，开局必填。
配置示例：
USER.md - 用户偏好
记录服务对象、特定偏好、平台偏好、文章类型。
服务对象变化、新增偏好时动它。可选，但建议写。
配置示例：
TOOLS.md - 工具箱
列出必需工具、必需命令、Skills 位置和使用方式。
新增工具、更新命令时动它。可选。
配置示例：
MEMORY.md - 记忆与偏好（可选）
用于存放长期有效的“记忆”，例如：长期项目背景、固定术语表、反复出现的约束、常用上下文链接等。
当你发现 Agent 总在重复问同一类背景信息，或需要稳定保持某些“长期设定”时，就把内容沉淀到这里。
重要建议：当
MEMORY.md 越写越大时，建议把详细内容沉到「第二大脑」（notes/、知识库页面、PARA 等）里，用链接在 MEMORY.md 中做索引与引用，而不是把所有内容都堆在一个文件里。否则很容易导致上下文过长，影响模型命中关键信息与回复质量。
配置示例：
HEARTBEAT.md - 心跳与自检（可选）
用于定义 Agent 的“自检清单”或“健康检查节奏”。比如每次启动、每次对话前后，需要快速确认哪些状态（配置是否加载、关键依赖是否可用、记忆库是否可读等）。
适合需要长时间在线、并且希望“越用越稳”的场景。
配置示例：
三、常见坑和避坑指南
配置文件太大怎么办？
把详细规范移到 notes/ 目录，在配置文件中引用即可。配置文件保持精简，详细文档单独管理。
写错了怎么回滚？
建议用 Git 管理配置文件。改错了直接回滚：
没有 Git 就靠 drafts/ 目录的备份，定期备份配置文件。
修改频率对照表
文件 | 必填 | 修改频率 |
✅ | 低 | |
✅ | 中 | |
✅ | 高 | |
❌ | 中 | |
❌ | 低 |
开局顺序：IDENTITY.md → SOUL.md → AGENTS.md → 其他按需补充。四、青萍 Claw 和养虾交流
关于青萍 Claw
青萍 Claw 是开箱即用的 OpenClaw 龙虾云端托管平台。
核心理念：龙虾不应该只是个聊天机器人，而应该是你的数字分身。
核心能力：
- 📅 飞书日历与日程管理
- 📝 微信公众号、知乎、小红书内容创作
- 🧠 个人知识库与第二大脑
- 📊 多维表格与数据处理
- 🔍 网络搜索与信息检索
- ⏰ 定时任务与自动化工作流
- 💬 多平台消息（WhatsApp/Telegram/飞书）
- 🎨 青萍 AI 专属技能（AI 生图、AI 视频）
云端托管，开箱即用，24 小时在线。
五、养虾交流
想学习更多 OpenClaw 龙虾的培育技巧？
关注公众号 【青萍叙事】，回复【养虾】加入交流群。
和志同道合的虾友一起交流养虾心得，分享实战经验。
- 作者:青萍叙事
- 链接:https://blog.lusyoe.com/article/openclaw-agents.md-user.md-soul.md
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议，转载请注明出处。
