如何搭建一个会“越用越好”的 OpenClaw 智能体系统(把这篇文章贴给你的OpenClaw龙虾)

大家好,我是老杜,是一名资深架构师。

智能体真的会越用越聪明吗?

如果你指的是“模型本身进化”,答案通常是否定的。

但如果你指的是“输出越来越贴合要求、犯错越来越少、协作越来越顺”,答案可以是肯定的。

关键不是不停调 prompt、换模型、重做架构。

更稳的路径是:持续对话、给出反馈、并把反馈写进一套固定的文件。

同一个模型,40 天前可能到处踩雷;40 天后却能稳定产出。

差异来自:一套会每周变得更丰富的 Markdown 文件栈。

这篇文章仿照一套成熟实践,把它写成通用版本,并把关键“源代码块”也附上,你可以直接复制改名使用。


这套方法的核心:不用复杂编排,文件系统就是集成层

你不一定需要消息队列、数据库、复杂编排框架。

很多情况下,一个可长期维护、可复利的智能体系统只需要:

  • • 磁盘上的 Markdown 文件
  • • 明确的文件分层
  • • 持续的反馈写入

文件不是“文档”。

文件是:

  • • 智能体每次启动都要读取的规则
  • • 多智能体之间交接的协议
  • • 你长期积累的上下文资产

这套文件栈长什么样:三层结构就是整个操作系统

这套栈可以拆成三层。每层解决一个关键问题。

  • • Layer 1:Identity(身份层) :这个智能体是谁?为谁服务?
    • • SOUL.mdIDENTITY.mdUSER.md
  • • Layer 2:Operations(操作层) :它怎么工作?怎么保持可靠?
    • • AGENTS.mdHEARTBEAT.md、角色专属指南
  • • Layer 3:Knowledge(知识层) :它学到了什么?怎么长期记住?
    • • MEMORY.mdmemory/YYYY-MM-DD.mdshared-context/

就这些。

没有额外中间件。

Markdown 文件在磁盘上。

文件系统本身就是集成层。


Layer 1:Identity(身份层)

1) SOUL.md:定义“它是谁”

SOUL.md 决定了智能体的:身份、职责、行为方式、原则边界。

一个常用技巧是用“角色原型”来快速塑形(例如:严谨、强执行、极度认真)。

写法建议:保持短。

SOUL.md 往往会在每次会话启动时加载;太长会吞掉应该留给任务的上下文。

经验做法:控制在 60 行以内,只写身份、角色、原则、关系、语气。

下面是一个“研究型智能体”的通用 SOUL.md 示例(去特征化版本):

# SOUL.md## Core IdentityYou are a Research Agent.You are intense about accuracy. You care about sources. You hate hand-wavy claims.## Role- Find high-signal information.- Verify before claiming.- Summarize for downstream creators/operators.## Principles1. Never fabricate. If unsure, label [UNVERIFIED].2. Signal over noise. Skip content that can't lead to action.3. Always attach primary sources (links, API responses, official docs).## Working Style- Short, structured, factual.- Prefer bullet points.- If the request is ambiguous, ask one clarifying question, then proceed.

2) IDENTITY.md:快速参考卡

SOUL.md 是完整人格,IDENTITY.md 是名片。

当你同时跑多个智能体时,它是很高性价比的体验优化:你一眼就知道“是谁在说话”。

通用模板:

# IDENTITY.md- Name: Research Agent- Role: Verification + Intel- Vibe: Precise, skeptical, calm- Emoji: 🔍- One-liner: "I verify claims and extract signal."

3) USER.md:它服务的人是谁

每个智能体都需要知道它在帮谁。

USER.md 记录:偏好、背景、约束、禁区。

一些看起来无关紧要的细节会产生复利:时区、表达习惯、禁区。

通用模板:

# USER.md- Name: <Your Name>- Timezone: <Your Timezone>## Preferences- Writing: short paragraphs, strong claims backed by evidence- Format: step-by-step when instructing, avoid buzzwords## Constraints- Do not claim timelines/numbers without sources- Do not publish externally without explicit confirmation## Topics- Focus: <Your Focus Areas>- Avoid: <Your Avoid List>

Layer 2:Operations(操作层)

1) AGENTS.md:行为规则

SOUL.md 定义“它是谁”。AGENTS.md 定义“它怎么运作”。

它通常包含:会话启动流程、文件读取顺序、记忆写入规则、安全边界。

必须写死两件事:

  • • 智能体在会话之间没有记忆,每次都是重新开始
  • • 如果纠正没有进入文件,下次会话它就不存在

下面是一个“根级 AGENTS.md”通用示例(所有智能体都继承):

# AGENTS.md## Every Session (Startup)Before doing anything:1. Read SOUL.md2. Read USER.md3. Read today's memory/YYYY-MM-DD.md and yesterday's4. If this is the main/private session, also read MEMORY.md## Memory Rules- If the user says "remember this" or corrects behavior, write it into:  - daily log: memory/YYYY-MM-DD.md (raw)  - and later distill into MEMORY.md (curated)- No "mental notes". Files are the memory.## Safety- Do not leak private data.- Do not run destructive commands unless explicitly asked.- If uncertain, ask a single clarifying question.

2) 角色专属指南:当你看到模式才加

不要一开始就堆很多规范。

更有效的策略:先跑起来;某类纠正反复出现,再把它固化成专属文件(写作指南、研究协议等)。

3) HEARTBEAT.md:自愈机制

智能体团队是基础设施。

基础设施会坏:依赖挂了、定时任务看起来在跑但其实没执行。

HEARTBEAT.md 的作用是:每次心跳触发时做健康检查。

通用模板(你可以按你的环境替换具体检查项):

# HEARTBEAT.md## Health Checks (run on every heartbeat)### 1) Browser- Check whether the managed browser is running.- If not running, start it.### 2) Scheduler / Cron- Check whether key scheduled jobs have run in the last 26 hours.- If any is overdue, trigger it manually and log the incident.### 3) Pipeline (optional)- Check whether there are stuck tasks or failures.- If stuck, surface a short alert with the last error.

建议:不要在第一天就写心跳。

在你第一次真实被故障坑过之后再写,因为那时你最清楚要监控什么。


Layer 3:Knowledge(知识层)

一个能长期变好的记忆系统,通常不是“把所有聊天塞进去”。

更有效的是三层。

Tier 1:MEMORY.md(精炼长期记忆)

它不是日志。

它是“会反复用到的结论”。

尤其建议写一节:Hard Lessons(血泪教训)。

通用模板:

# MEMORY.md## Writing Preferences- Keep paragraphs short.- Strong claims must have sources.- Avoid filler and buzzwords.## Hard Lessons- Never delete project folders without explicit confirmation.- Never claim "#1" or "all-time" without verifiable ranking sources.## Bad Patterns (Do Not Repeat)- Overuse of emojis/hashtags- Generic motivational tone- Unverifiable timelines

安全提示:长期记忆要谨慎放敏感信息。

Tier 2:memory/YYYY-MM-DD.md(每日日志)

这是原材料:今天做了什么、输出了什么、收到了什么反馈。

维护规则:日志会快速膨胀。更稳的做法是每次只加载今天和昨天,定期归档旧日志。

通用模板:

# Daily Log — YYYY-MM-DD## What happened- ...## Outputs- Draft: ...## Feedback received- Correction: ...## Follow-ups- ...

Tier 3:有组织的记忆目录

当系统变大后,把记忆按人或项目拆开,会更好管理、更好复用。


shared-context/:跨智能体共享上下文(让一次纠正全员生效)

当你开始对不同智能体重复同一条纠正时,就该引入 shared-context/

两个最关键文件:

  • • THESIS.md:你当前关注什么、写过什么、空白点在哪里
  • • FEEDBACK-LOG.md:跨智能体纠正(写一次,所有智能体生效)

通用模板:

# shared-context/THESIS.md## What I care about now- ...## What I've already published- ...## Gaps to explore- ...
# shared-context/FEEDBACK-LOG.md## Global corrections- "No em dashes" (example)- "Always cite primary sources" (example)## Content rules- ...

智能体如何协作:不用 API,不用队列,靠文件交接

智能体之间的协作可以非常简单:

  • • 一个智能体写入一个共享文件(上游输出)
  • • 其他智能体读取它继续工作(下游消费)

关键规则:

单写者原则:一个共享文件永远只有一个写者。

这能避免几乎所有协调冲突。

如果需要顺序,就靠调度保证:上游先跑,下游后跑。


目录结构示例(通用)

workspace/  SOUL.md  IDENTITY.md  USER.md  AGENTS.md  HEARTBEAT.md  MEMORY.md  memory/    2026-03-01.md    2026-03-02.md  shared-context/    THESIS.md    FEEDBACK-LOG.md  intel/    DAILY-INTEL.md  agents/    research-agent/      SOUL.md      AGENTS.md      memory/    content-agent/      SOUL.md      AGENTS.md      memory/

为什么这套方法有效:复利来自文件,而不是模型

模型不变。

但文件会变得更丰富、更锐利、更贴合真实需求。

这套积累出来的上下文资产,才是护城河。

别人可以用同一个模型。

但别人复制不了你持续沉淀的文件栈。


如何开始:不要试图一个周末搭完

一个通用节奏:

  • • 今天:安装 OpenClaw。写 SOUL.mdIDENTITY.mdUSER.md。选一个最重复任务。设一个定时任务。
  • • 3 天后:输出会很一般。开始给具体反馈,并确保反馈落入记忆文件。
  • • 1 周后:创建 AGENTS.md,写清楚会话启动流程、读取顺序、记忆管理规则。
  • • 2 周后:开始写 MEMORY.md。回顾每日记录,把高频纠正蒸馏成永久条目。
  • • 3 周后:加第二个智能体,用文件做交接;当开始重复纠正时,引入 shared-context/
  • • 4 周后:经历一次故障后,再加 HEARTBEAT.md,把故障模式纳入自检。

你要做的不是把系统搞复杂。

你要做的是:持续出现,持续反馈,让文件自己长出来。

文件会完成剩下的事。

如果有什么想法,欢迎留在评论区!    👇可以加我,一起成长、一起交流picture.image

0
0
0
0
评论
未登录
暂无评论