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


3秒自测:你的Agent是真有用,还是假智能?
灵魂拷问来了:
• 你的OpenClaw能记住上周聊过的客户需求吗?
• 它会在凌晨自动检查未处理的消息并提醒你吗?
• 它能直接调用你的CRM系统查询客户记录,而不是让你"稍等,我查一下"?
• 它知道什么该说、什么不该说,而不是每次都要你手动纠正?
如果以上任何一个答案是否定的——你的OpenClaw还只是个聊天机器人,不是真正的Agent。
这不是模型的问题,是边界没定好。
OpenClaw出厂设置是个"通才",但你的业务需要"专才"。把通用Agent改造成专用Agent的核心逻辑只有一个:重新定义它的认知边界、能力边界和行为边界。
本文将拆解OpenClaw的9层架构,手把手教你如何通过配置每个组件,打造一个稳定、高效、专属于你的领域Agent。
一、架构全景:9层组件各司其职

OpenClaw的架构可拆解为9个层次,每一层都决定了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.com2.3 USER.md — 用户画像(建议改)
告诉Agent"你的用户是什么样的人",帮助Agent调整沟通方式:
# 用户画像
## 主要用户群体
- 中小企业主(20-200人规模)
- 技术水平:非技术背景
- 核心诉求:降低人力成本、提升运营效率
## 沟通偏好
- 偏好简短直接的回答
- 喜欢看到具体案例和效果数据
- 对技术细节不感兴趣三、能力层:Skills系统决定Agent的"手艺"
Skills是OpenClaw最强大的扩展机制。SOUL.md定义了Agent"应该做什么",Skills定义了Agent"能够做什么"。
3.1 Skills的三层优先
~/.openclaw/workspace/skills/ | |||
openclaw skill install | |||
同名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通过什么渠道与用户交互。
配置示例(Telegram):
{
"channels": {
"telegram": {
"enabled": true,
"botToken": "your-telegram-bot-token",
"authorizedUsers": ["user-id-1"]
}
}
}七、模型层:选择Agent的"大脑"
不同模型在成本、速度、能力上差异巨大:
配置示例:
{
"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(备注场景)
夜雨聆风