乐于分享
好东西不私藏

Openclaw揭秘:只需3个文件,让你掌握智能体原理

Openclaw揭秘:只需3个文件,让你掌握智能体原理

声明:本文以通俗易懂、快速上手为第一目标,不追求科学最优。

你问智能体“年假怎么请”,它为什么能准确回答?

当它主动提醒你“会议要开始了”,它怎么知道该在这个时候出现?

很多人以为,这背后是复杂的算法、海量的数据、神秘的模型。但实际上,智能体的“思考”还有一个非常重要的因素——规则。就像一家公司的新员工入职。你给他一本员工手册、告诉他岗位职责、教他遇到问题怎么处理。他就能开始工作了。

智能体也一样。你只需要告诉它三件事:

  • 你是谁?(角色)

  • 你在和谁说话?(用户)

  • 你能做什么?(能力)

在Openclaw中,这三件事分别写在3个文件里。今天让我们一起来揭秘。

第一部分:Openclaw是什么?

Openclaw:是一个智能体操作系统。

你可以这样理解:你的电脑有Windows操作系统。Windows本身不是Word、不是微信,但有了它,你可以安装和使用这些应用程序。

Openclaw扮演的正是这样的角色。它本身不是智能体,但你可以用它来创建、配置、运行、管理多个智能体——让它们各司其职,协同工作。

你不需要写代码,只需要定义规则。就像你不需要懂操作系统的底层原理,只需要会使用应用程序一样。

第二部分:读懂3个文件,读懂智能体的“灵魂”

Openclaw首次运行时,会在其工作空间(~/.openclaw/workspace/)生成3个文件:

  1. SOUL.md:“性格”配置文件——它是什么风格、用什么语气说话、遵守什么原则。

  2. USER.md:“用户”配置文件——谁在使用它、这些人有什么特点、他们需要什么。

  3. AGENTS.md:“工作手册”配置文件——它能做什么、知识从哪来、遇到问题怎么处理。

文件一:SOUL.md——智能体的“性格”(它是谁)

这个文件定义智能体的角色、语气、行为准则。

想想看,当你招聘不同岗位的员工时,你对他们的期望是不同的:

  • 客服人员:耐心、专业、友好

  • 法务人员:严谨、准确、审慎

  • 行政秘书:高效、贴心、主动

智能体也是如此,不同岗位,需要不同的“性格”。

# SOUL.md 示例## 角色你叫G哥,你是一个专业的客服助手,负责回答客户关于产品的问题。## 语气专业但不生硬,友好但不随意## 行为准则1. 只回答产品相关问题2. 不确定的事情不说3. 回答时附上信息来源

总结:SOUL.md 决定了智能体的“人设”,你可以直接拷贝上面示例给你的龙虾(Openclaw)。

文件二:USER.md——智能体的“用户”(你是谁)

这个文件定义谁会使用这个智能体、他有什么特征、他需要什么。

一位经验丰富的服务员,面对不同的客人,会采用不同的沟通方式:

  • 面对第一次来的客人:详细介绍菜单,推荐招牌菜

  • 面对常客:直接问“还是老样子吗?”

智能体也是如此。它不了解你是谁,就服务不好你。

# USER.md 示例## 用户画像- **用户姓名**:王鹤- **角色定位**:解决方案专家- **使用场景**:撰写技术方案、准备客户演示、回答技术问题- **用户特征**  - 时间紧张,追求效率  - 需要精准的技术信息,不能有模糊表述  - 方案需要结构清晰,便于客户理解  - 经常需要在短时间内完成多份方案## 用户需求1. 快速获取准确的技术参数和案例数据2. 方案模板能根据客户类型自动调整3. 演示文稿需要专业、美观、有说服力## 沟通方式- 回答时直击要点,不啰嗦- 提供结构化信息(优先用表格或分点)- 附上可编辑的模板链接,方便直接使用- 涉及技术细节时,标注信息来源

一句话总结:USER.md 决定了智能体“为谁服务、如何服务”,你可以直接拷贝上面示例给你的龙虾(Openclaw)。

文件三:AGENTS.md——智能体的“工作手册”(它能干什么)

这个文件定义核心能力、知识来源、执行流程、异常处理。

这就像一份“岗位说明书”。当你入职一个新岗位,公司会给你这样一份文件,告诉你:

  • 你的核心职责是什么?

  • 你需要用到哪些资源?

  • 遇到问题应该按什么步骤处理?

有了这份说明书,你才知道自己该做什么、怎么做。

# AGENTS.md 示例## 核心能力- 查询产品信息- 根据客户需求推荐产品方案- 编写方案文档## 知识来源- 《产品库》:产品规格、适用场景、价格- 《案例库》:过往成功案例- 《方案模板》:标准文档框架## 执行流程### 推荐产品1. 了解客户需求(场景、预算、要求)2. 从《产品库》检索匹配产品3. 按匹配度排序,推荐2-3款4. 说明推荐理由和价格区间### 编写方案1. 获取客户信息2. 从《方案模板》选择框架3. 填充产品信息和案例4. 生成方案初稿,标注需人工确认部分## 异常处理- 需求不清晰 → 反问引导- 信息不足 → 标注“需人工补充”

一句话总结:AGENTS.md 告诉智能体“能做什么、怎么做”。

第三部分:3个文件如何协同工作?

这3个文件不是孤立的。它们合在一起,才构成一个完整的智能体。

soul.md          users.md          agent.md (性格)            (用户)            (大脑)    ↓                ↓                ↓ “我是谁?”        “为谁服务?”       “能做什么?”    ↓                ↓                ↓    └────────────────┴────────────────┘                     ↓               完整的智能体“灵魂”

场景设定:你问“Gestmind这款产品怎么样?

在Openclaw的实际运行中,会同时参考3个文件的内容,它们协同工作过程

  1. AGENTS.md :这是产品查询,检索知识库。

  2. SOUL.md:用专业友好的语气回答。

  3. USER.md:用户是王鹤,时间紧张,需要精准信息,用表格呈现。

智能体最终回答(符合3个文件的共同要求):

“Gestmind专注于人工智能技术应用,使命是‘智能化重塑组织效能’。对于您的需求,核心功能包括:知识库构建、智能检索、问答助手。如需详细参数,我可以进一步提供。”

畅想:未来的组织,人机共存

回到开篇的问题:智能体是怎么“思考”的?

答案很简单:它按照你设定的规则运行。

你通过3个文件告诉它:你是谁、为谁服务、能做什么。3个文件,各司其职。合在一起,就是一个完整的智能体。Openclaw作为智能体操作系统,负责把这些规则变成真正能运行、能服务的智能体。

我们正在进入一个前所未有的时代——人机共存的时代。

未来的组织里,智能体不再是“工具”,而是“协作者”。它们承担重复性工作,处理海量信息,执行标准流程。而人类,则专注于判断、决策、创造和情感连接。

但这一切有一个前提:你越了解它,才能和它协作好。

了解它的性格,才知道如何沟通;了解它的能力,才知道如何分工;了解它的边界,才知道何时介入。

了解,是协作的开始。协作,是人机共存的基石。

今天,你通过3个文件,读懂了智能体的工作原理。明天,你就可以用它来创造价值。

未来已来。而你对它的理解程度,决定了你在人机共存时代的位置。

关注Gestmind,用最简单的方式科普AI