乐于分享
好东西不私藏

你的OpenClaw根本不算Agent!90%的人把"龙虾"养废了

你的OpenClaw根本不算Agent!90%的人把"龙虾"养废了

花3天配好的"龙虾",结果只会陪你聊天?问题不在OpenClaw,在你根本没搞懂这9个组件。

一则小广告(马上开放OpenAPI 和 Skill,可通过OpenClaw直接调用!)
👉 https://subscription.ivheli.com

3秒自测:你的Agent是真有用,还是假智能?

灵魂拷问来了:

• 你的OpenClaw能记住上周聊过的客户需求吗?

• 它会在凌晨自动检查未处理的消息并提醒你吗?

• 它能直接调用你的CRM系统查询客户记录,而不是让你"稍等,我查一下"?

• 它知道什么该说、什么不该说,而不是每次都要你手动纠正?

如果以上任何一个答案是否定的——你的OpenClaw还只是个聊天机器人,不是真正的Agent。

这不是模型的问题,是边界没定好

OpenClaw出厂设置是个"通才",但你的业务需要"专才"。把通用Agent改造成专用Agent的核心逻辑只有一个:重新定义它的认知边界、能力边界和行为边界

本文将拆解OpenClaw的9层架构,手把手教你如何通过配置每个组件,打造一个稳定、高效、专属于你的领域Agent


一、架构全景:9层组件各司其职

OpenClaw的架构可拆解为9个层次,每一层都决定了Agent的某一方面特性:

层级
组件
核心作用
身份层
SOUL.md / IDENTITY.md / USER.md
定义"这个Agent是谁"
能力层
Skills系统
定义"这个Agent能做什么"
记忆层
Memory系统
定义"这个Agent能记住什么"
调度层
HEARTBEAT.md / Cron
定义"什么时候主动做事"
通道层
Channel配置
定义"用户通过什么渠道交互"
模型层
LLM Provider配置
定义"用哪个大脑"
安全层
Sandbox / 权限 / Pairing
定义"能碰什么、不能碰什么"
插件层
Plugin系统
高级扩展:替换核心模块
工作流层
Multi-Agent / Lobster
多Agent协作编排

下面逐层详解配置要点。


二、身份层:用3个文件定义Agent的"人格"

身份层是定制化的起点。它决定了Agent"是谁、怎么说话、什么能做什么不能做"。

2.1 SOUL.md — Agent的灵魂(必改)

文件位置~/.openclaw/SOUL.md

这是OpenClaw加载的第一个系统级文件,内容会被注入到每次LLM调用的System Prompt中。可以理解为Agent的"岗位说明书 + 行为守则"

SOUL.md必须包含的7大要素

1. 角色定位:你是谁?属于哪个组织?服务于什么场景?

2. 专业领域:你擅长什么?知识边界在哪里?

3. 行为准则:回答风格、语气、格式要求

4. 禁止行为:什么话不能说、什么事不能做

5. 工作流程:面对特定请求,按什么步骤处理

6. 输出规范:回答的结构、长度、格式要求

7. 升级机制:什么情况下转交人工

示例 — 客服Agent的SOUL.md

# 角色定义

你是「小艾」,艾维禾砺数字科技有限公司的AI客服专员。

## 核心身份
- 公司:成都艾维禾砺数字科技有限公司
- 岗位:AI客服专员
- 服务范围:AI自动化解决方案的售前咨询、使用指导、故障排查
- 工作时间:7×24小时在线

## 行为准则
### 语气与风格
- 专业但不生硬,友好但不过度亲热
- 每次回复控制在200字以内
- 使用emoji适度点缀,不超过2个/回复

### 处理流程
1. 收到消息后判断意图:售前咨询/使用问题/故障报告/投诉建议
2. 知识库中有答案 → 直接回答
3. 知识库中无答案 → 坦诚告知并承诺跟进
4. 超出能力范围 → 转交人工

### 严格禁止
- 不得编造产品功能或价格信息
- 不得承诺超出公司政策的退款/赔偿
- 不得泄露客户隐私数据

### 升级条件
- 用户连续3次表示不满意
- 涉及退款金额超过500元
- 涉及法律/合同纠纷

编写要点

• 越具体越好:不要写"你是一个有用的助手",要写"你是XX公司的客服,负责XX产品线"

• 用约束替代祈使:不要写"请尽量准确",要写"如果不确定,必须回复'我需要确认'"

• 控制长度:建议500-1500字,避免占用过多Context Window

2.2 IDENTITY.md — 身份名片(建议改)

提供结构化的身份信息,适合放"不影响行为逻辑但有助于自我介绍"的内容:

# 身份信息
- 名称:小艾
- 版本:v1.2
- 所属公司:成都艾维禾砺数字科技有限公司
- 联系方式:support@example.com

2.3 USER.md — 用户画像(建议改)

告诉Agent"你的用户是什么样的人",帮助Agent调整沟通方式:

# 用户画像
## 主要用户群体
- 中小企业主(20-200人规模)
- 技术水平:非技术背景
- 核心诉求:降低人力成本、提升运营效率

## 沟通偏好
- 偏好简短直接的回答
- 喜欢看到具体案例和效果数据
- 对技术细节不感兴趣

三、能力层:Skills系统决定Agent的"手艺"

Skills是OpenClaw最强大的扩展机制。SOUL.md定义了Agent"应该做什么",Skills定义了Agent"能够做什么"。

3.1 Skills的三层优先

名称
位置
说明
最高
Workspace Skills
~/.openclaw/workspace/skills/
你自己开发的
Managed Skills
openclaw skill install
安装
从ClawHub安装的社区技能
最低
Bundled Skills
OpenClaw内置
bash、browser、file-system等

同名Skill高优先级会覆盖低优先级,这意味着你可以基于社区Skill做二次定制

3.2 自定义Skill的完整结构

skills/
└── crm-query/
    ├── SKILL.md          # 技能定义(必须)
    ├── query_customer.py  # 辅助脚本(可选)
    └── config.yaml        # 配置文件(可选)

SKILL.md语法示例

---
name: crm-query
description: 查询和管理CRM客户记录
version: 1.0.0

requires:
  env:
    - CRM_API_KEY
    - CRM_BASE_URL

tools:
  - name: search_customer
    description: 根据关键词搜索客户记录
    parameters:
      keyword:
        type: string
        required: true
---

# CRM客户管理技能

## 查询客户
当用户要求查询客户时:
1. 使用`search_customer`工具搜索
2. 将结果格式化为表格展示
3. 如果没有结果,建议换个关键词

3.3 常用ClawHub Skills速查

通信集成类

• gog — Gmail读写

• slack / discord / wacli — 各平台集成

生产力工具类

• notion / trello / obsidian — 笔记与项目管理

开发工具类

• github — Issues/PR/代码操作

• coding-agent — 代码编写增强

浏览器与搜索类

• browser — 浏览器自动化(内置)

• summarize / web-search — 内容摘要与搜索


四、记忆层:从"无状态"到"有记忆"

Memory是Agent从"聊天机器人"进化为"数字员工"的关键。

4.1 记忆的两层结构

第一层:MEMORY.md — 长期记忆/领域知识库(手动维护)

• 位置~/.openclaw/workspace/MEMORY.md

• 加载时机:每次会话启动时注入Context

• 用途:存放需要Agent"永久记住"的核心知识

# 公司核心信息

## 产品线
- AI数字员工平台:面向中小企业的AI自动化解决方案
- OpenClaw定制化部署:为企业定制专属AI Agent

## 价格体系
- 数字员工平台:基础版¥2,999/月,专业版¥5,999/月
- OpenClaw定制部署:¥3,000-12,000部署费 + ¥1,000-3,000/月维护费

## 常见FAQ
Q: 你们的AI客服能接入微信公众号吗?
A: 可以,支持微信公众号、飞书、钉钉、企业微信等主流平台。

第二层:memory/YYYY-MM-DD.md — 日志记忆(自动维护)

• 位置~/.openclaw/workspace/memory/

• 加载时机:自动加载今天和昨天的日志

• 用途:记录每天的对话要点、决策、待办事项

4.2 企业级知识库方案

方案A:多文件知识库(简单直接)

workspace/
├── MEMORY.md              # 核心概要
├── knowledge/
│   ├── products.md        # 产品信息
│   ├── pricing.md         # 价格体系
│   ├── faq.md             # 常见问答
│   └── troubleshooting.md # 故障排查手册

方案B:RAGFlow集成(大规模知识库)

当知识库超过几十万字时,使用RAGFlow作为外部知识检索引擎:

1. 部署RAGFlow服务

2. 安装RAGFlow Skill:openclaw skill install ragflow

3. 上传企业文档到RAGFlow

4. Agent自动从RAGFlow检索相关知识


五、调度层:让Agent主动干活

调度层让Agent从"被动问答"升级为"主动执行"。

5.1 HEARTBEAT.md — 心跳任务

文件位置~/.openclaw/HEARTBEAT.md

定义Agent在空闲时应该主动执行的任务:

# 心跳任务

## 每30分钟
- 检查是否有新的未处理客户消息
- 如果有超过15分钟未回复的消息,发送提醒到管理员

## 每天早上9:00
- 生成昨日客户服务报告
- 将报告发送到飞书群

## 每天晚上22:00
- 整理今天的对话记录
- 提取新出现的FAQ问题,更新到知识库

5.2 Cron Jobs — 精确定时任务

对于需要精确时间控制的任务,在openclaw.json中配置:

{
  "cron": [
    {
      "schedule": "0 9 * * 1-5",
      "message": "生成本周客户跟进提醒"
    },
    {
      "schedule": "0 18 * * 5",
      "message": "生成本周工作周报"
    }
  ]
}

六、通道层:50+平台一键接入

通道层决定了Agent通过什么渠道与用户交互。

通道
适用场景
接入方式
飞书
企业内部协作
飞书机器人API + Webhook
钉钉
企业内部协作
钉钉机器人SDK
企业微信
企业内部+客户服务
企业微信Bot API
Telegram
技术社群/海外客户
Bot API
Discord
社区运营/多Agent
Bot + 多频道隔离
WhatsApp
海外客户服务
Baileys (QR pairing)
Web Chat
官网嵌入
OpenClaw UI组件

配置示例(Telegram):

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "your-telegram-bot-token",
      "authorizedUsers": ["user-id-1"]
    }
  }
}

七、模型层:选择Agent的"大脑"

不同模型在成本、速度、能力上差异巨大:

模型
推荐场景
成本
上下文窗口
DeepSeek Chat (V3)
日常对话、客服
极低 (¥1/百万token)
64K
DeepSeek R1
复杂推理、分析
64K
Claude 3.5 Sonnet
复杂写作、代码
200K
GPT-4o
多模态、通用
中高
128K
Qwen2.5 (本地)
隐私敏感、离线
硬件成本
32-128K

配置示例

{
  "agents": {
    "defaults": {
      "model": "deepseek-chat",
      "provider": "deepseek",
      "apiBase": "https://api.deepseek.com/v1",
      "apiKey": "sk-xxxxx",
      "contextWindow": 64000
    }
  }
}

八、安全层:企业场景的生命线

OpenClaw拥有系统级权限,企业场景下必须严格管控。

8.1 Sandbox沙箱配置

将Agent的执行环境隔离在Docker容器中:

{
  "agents": {
    "defaults": {
      "sandbox": {
        "docker": { "enabled": true },
        "workspaceAccess": "rw"
      }
    }
  }
}

workspaceAccess选项

• "rw":读写(默认)

• "ro":只读

• "none":无访问(完全隔离)

8.2 Skills安全策略

遵循最小权限原则

{
  "skills": {
    "allowBundled": ["browser", "file-system"],
    "entries": {
      "bash": { "enabled": false },
      "coding-agent": { "enabled": false }
    }
  }
}

九、从0到1:定制化工作流检查清单

无论你要定制什么场景的Agent,都可以按照以下顺序操作:

• [ ] Step 1:明确场景需求 — 这个Agent要解决什么问题?用户是谁?

• [ ] Step 2:编写SOUL.md — 定义角色、行为准则、禁止事项

• [ ] Step 3:配置模型 — 选择合适的LLM,配置API Key

• [ ] Step 4:接入通道 — 选择用户交互的消息平台

• [ ] Step 5:安装/开发Skills — 安装必要的社区Skills,开发自定义Skills

• [ ] Step 6:预置知识库 — 在MEMORY.md中放入领域知识

• [ ] Step 7:配置USER.md — 描述目标用户画像

• [ ] Step 8:配置HEARTBEAT — 设置自动化任务

• [ ] Step 9:安全加固 — 启用沙箱、限制Skills、配置权限

• [ ] Step 10:测试与迭代 — 用真实场景测试,根据结果调整配置


结语:专用Agent的本质是"边界管理"

把OpenClaw从通用Agent改造成专用Agent,核心不是添加功能,而是划定边界

• 认知边界(SOUL.md):让它知道自己是谁、该说什么

• 能力边界(Skills):让它知道自己能做什么、不能做什么

• 记忆边界(Memory):让它知道该记住什么、该遗忘什么

• 安全边界(Sandbox):让它知道能碰什么、不能碰什么

边界越清晰,Agent越专业。


🎯 下期预告:从零打造一个7×24小时在线的AI客服Agent

看完本文,你已经掌握了OpenClaw的9层组件配置方法。但理论归理论,实战才是检验真理的唯一标准。

下期我们将带来一个完整的实战案例

如何用OpenClaw从零打造一个专门处理客户咨询的AI客服Agent。

关注公众号「合理AI」,第一时间获取下期实战教程。


关于我们

  • 官网:https://official.ivheli.com
  • 助理微信:xmaiyrjgzs(备注场景)