安装 OpenClaw 🦞 过后必须立刻马上建立的文档!刚好因为我更新了最新版本后,都卡完了。我重置了,从新配置!新手小白先了解这几个重要文档 ‼️
⚠️⚠️
先了解这几个档案(下一篇直接给 prompt):
SOUL.md:性格 + 价值观 + 输出风格。
IDENTITY.md:当前角色 + 责任边界。
USER.md:你的偏好 + 长期目标 + 禁区。
TOOLS.md:工具使用规则 + 风险动作确认机制。
MEMORY.md:长期有效的 20–50 条浓缩事实。
memory/YYYY-MM-DD.md:当天日志、决定、待办。
AGENTS.md:开机顺序 + 记忆读写协议 + 行动流程。
HEARTBEAT.md:轻量巡检与维护
⚠️⚠️
它们每个的作用?
SOUL. md 只管它是谁。写人格,价值观、表达风格、默认做事倾向,不写流程,不写项目细节,不写工具说明。比如:回答先给结论、语气直接但不冒犯、先尝试再发问、外部动作先确认、内部整理可自主执行。这个文件应该像气质,不像操作手册。
IDENTITY. md 只管这台助手当前扮演什么角色。这里写模型定位、工作场景、当前职责边界,比如个人执行助理 / 研究搭档 / 编程副驾驶,以及它不该越界做什么。它比 SOUL.md 更具体,但仍然不是流程表。
USER. md 只写你是谁、你喜欢怎么被服务。放你的偏好、沟通习惯、禁区、长期目标、常用项目名、常用目录、输出偏好。别把临时任务塞进去,临时任务应该进每日记忆。这样模型每次开机先知道服务对象,不会把你的个人偏好和它自己的风格混在一起。
TOOLS. md 只写有什么工具,什么时候用,什么不能乱用。重点不是列 API 名字,而是给它决策规则:什么时候读文件,什么时候搜索,什么时候执行脚本,什么时候必须先问你;哪些是高风险动作,比如删文件、发消息、改线上配置,一律确认后再动。这样它的行动边界会稳定很多。
MEMORY. md 只保留长期记忆的浓缩版,务必短。这里写稳定有效、跨天还重要的信息:长期项目、固定偏好、关系图、反复复用的规则。不要把聊天流水账全塞进去,不然每次启动都在烧上下文。很多人把 MEMORY.md 写成公司 wiki,结果启动又重又乱,这正是常见翻车点。
memory/ 目录才是你真正该关注的地方。建议用 memory/YYYY-MM-DD.md 记当天发生了什么、做了哪些决定、有哪些待续动作。主会话优先读今天和昨天,定期把已经沉淀下来的东西提炼进 MEMORY. md。也就是说:memory/ 是原始日志,MEMORY. md 是蒸馏结果。
AGENTS. md 是总调度器,也是最关键的文件。它应该放最上面的,是启动顺序和工作协议,而不是一堆理念。最推荐的结构是:开机会先读 SOUL. md、USER. md、IDENTITY. md、TOOLS. md、MEMORY. md;然后读取 memory/ 里今天和昨天;再决定是否需要搜索更旧的记忆;最后按“先内部工作、后外部动作确认”的原则执行。收到心跳任务时,再转去 HEARTBEAT. md。这类编排放顶部最有效。
HEARTBEAT. md 轻量活。它适合做上下文健康检查,未完成事项巡检、记忆维护提醒;没事就返回 HEARTBEAT_OK 这种轻响应。它不是第二套主人格,也不是第二本 AGENTS。越短越稳定。
⚠️⚠️
真正接近完美的标准,其实就三条。
第一、启动文件越短越好,尤其 MEMORY. md 和 HEARTBEAT. md。
第二、身份、用户、工具、流程彻底分层,别混写
第三、长期记忆靠提炼,不靠堆积。OpenClaw 这套架构本来就是把 bootstrap 文件作为每次会话都会重载的核心层,所以你是在设计稳定内核,不是在写一堆提示词备忘录。
下一篇直接分享我的详细设置!