Harness 与 Agent 工程 · 运行控制与长任务 · 2026-02-24

OpenClaw 最佳实践:5条“基本原则”

OpenClaw Agent系统的5条黄金法则,教你如何让智能体真正"会做"而不只是"会说"。

核心内容:

  1. 安全第一原则:从技能安装到脚本审查的完整安全体系
  2. 文件即大脑:通过持久化存储解决上下文丢失问题
  3. 模型分层与极简架构:构建可持续运行的智能体系统

OpenClaw 这类 Agent 系统,最迷人的地方不在“会说”,而在“会做”。

一旦智能体开始动手抓网页、跑脚本、发邮件、定时巡检,世界就变了:它不再是一段对话,而是一套正在运行的流程。

这时候,很多人会经历同一种反差:

第一天:像开了外挂

第三天:开始走样、开始失忆

第七天:任务像野草一样长,表现杂乱无章不稳定

最后:又回到“偶尔用用”的工具状态

问题通常不在“模型不够强”,而在“没按系统的方式用系统”。

所以 Reddit 社区把最容易翻车、最容易失控、也最容易踩坑的地方,浓缩成5条基本原则:安全第一、文件即大脑(最重要)、模型分层、Cron 驱动、极简技能。

它们之所以叫“原则”,不是因为“听起来正确”,而是因为:只要系统想长期跑、想可复用、想能扩张,这些就是绕不过去的物理定律。

核心主旨其实就是一句话:

文件即大脑,零依赖即安全。最好的智能体架构是最简单的架构

下面逐条把每个细节拆开讲透。

原则1:安全第一:先把“刹车”装上,再谈“马力”

图里第一条写得很硬:

并且给了一个更狠的结论:

零依赖 = 最优

为什么它能叫“原则”

因为智能体时代的风险,已经不是“它会不会胡说”,而是“它会不会乱做”。

一旦技能里带脚本(scripts/),就等于把一把钥匙交给了陌生人,钥匙能开哪扇门,靠运气。

所以这条原则不是道德劝告,而是工程底线:

先把“能干什么”收窄,系统才跑得久;先把风险关进笼子,效率才有意义。

没刹车的智能体,不叫智能体,叫事故发生器。

所谓安全,绝不是“相信”,而是“限制”。

原则2(最重要):文件即大脑:把记忆从“聊天”搬到“硬盘”

图里写得非常明确:

所有上下文必须落地为文件,否则 compaction 后全部丢失

并列出了四个具体落点:

为什么它能叫“原则”

因为这里牵扯的是智能体系统最大的敌人:Compaction。

图里的 Key Insights 第一条就点名:

Compaction 是最大敌人 LLM 上下文窗口有限,compaction 会丢失未持久化的信息。 所有上下文必须落地为文件,这是整个系统的核心保障。

聊天窗口像一张白板,写满了就得擦;擦之前再“总结”一下,看似保留了重点,实际丢掉了细节。

而智能体做事,恰恰靠细节:参数、约束、历史决策、失败原因、边界条件……这些一丢,系统就会“断片”。

所以“文件即大脑”的本质是:把智能体的记忆,从短期对话迁移到长期可持久化介质。

这不是习惯问题,是系统能不能长期跑的问题。

对话是记忆的幻觉,文件才是记忆的实体。

能跑一下午的不算系统,能跑一整年的才算。

推荐结构:workspace 目录不是“美观”,是“操作系统的骨架”

图里把推荐目录结构直接给出来了(这不是示意,是“最小可用架构”):

~/workspace/ SOUL.md # 人格定义 —— 智能体的身份与价值观 MEMORY.md # 长期记忆 —— 跨会话知识 ACTIVE-TASK.md # 当前任务 —— 工作记忆 + checkpoint HEARTBEAT.md # 定时任务 —— Cron 心跳清单 memory/ # 日志目录 2026-02-22.md # 每日日志记录 2026-02-21.md skills/ # 自定义技能 SKILL.md # 纯 Markdown 技能说明

这里每个文件名都在说一句系统设计的大白话:

SOUL.md:先定义“它是谁”,再让它做事(身份决定边界)

MEMORY.md:长期事实放这里(跨会话还能用)

ACTIVE-TASK.md:当前只盯一件事的“工作台”,中途有 checkpoint

HEARTBEAT.md:所有定时任务统一在“心跳清单”里

memory/:每天留痕,像飞行记录仪

skills/SKILL.md:技能先从说明书开始,别先从脚本开始

目录结构不是整理癖,是系统的脊椎。文件名写对了,系统就会自己变得有边界。

原则3:模型分层:把模型当组织结构,而不是当神仙

图里写得很具体:

并补了一句实用主义到底的备注:

可替换为其他测试过的模型来降低成本

为什么它能叫“原则”

因为这条背后是成本与稳定性的物理规律:

所有任务都用最强模型:贵,而且容易把“思考”浪费在“搬砖”上

所有任务都用便宜模型:省,但关键节点会崩

没有回退机制:系统遇到不确定就会卡住或胡来

所以分层的核心不是“省钱”,而是“可控”:

Opus像“总指挥”:拆解、判断、兜底

Sonnet像“执行队”:批量处理、整理、跑流程

回退机制像“升级通道”:不行就上更强的,关键时刻不赌运气

把模型当岗位…

— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/Openclaw/2026022479820.html