knowledge-vault/work/client-projects/医美/医美销售智能体系统部署方案(OpenClaw).md

496 lines
24 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 销售智能体系统部署方案OpenClaw
## 一、背景与目标
### 1.1 项目背景
现有医美销售智能体系统基于 Dify 平台构建,包含四个核心智能体:
| 智能体 | 功能 | 输入 | 输出 |
|-------|------|------|------|
| **Agent A1** | 聊天记录清洗 | 微信聊天文本 | 结构化线索、问答对、《面诊接待小贴士》 |
| **Agent A2** | 面诊复盘质检 | 录音转写文本 | 《医美面诊复盘分析报告》8大模块 |
| **Agent B** | 深度心理画像 | 微信线索 + 面诊事实 | 《3C客户心理全景图》、决策人、核心恐惧、信任缺口 |
| **Agent C** | 话术生成 | 心理画像 + 知识库 | 《催单行动指南》+ 话术原文 |
### 1.2 核心挑战
- **模型能力差异**OpenClaw 使用弱模型Qwen/MinimaxDify 使用强模型Claude/GPT
- **部署灵活性**:当前仅支持单一调用方式,需支持 IM 和系统 API 两种入口
- **可复制性**:医美案例成功后,需快速复用到其他行业(眼镜、教育、金融等)
### 1.3 项目目标
1. **标准化**:建立通用销售心智模型,一次开发多处复用
2. **自动化**OpenClaw 负责流程编排Dify 负责深度推理
3. **可部署**:试验环境验证 → 生产环境部署,标准化交付
---
## 二、系统架构
### 2.1 服务器角色分工
```
┌─────────────────────────────────────────────────────────────────────────┐
│ 生产环境 │
│ ┌──────────────┐ ┌──────────────────┐ ┌──────────────────┐ │
│ │ 医美系统 │ │ OpenClaw 生产 │ │ Dify 服务器 │ │
│ │ (入口/展示) │───→│ (自动化编排) │───→│ (专家级智能体) │ │
│ │ - CRM │ │ - 销售Agent │ │ - 深度画像 │ │
│ │ - MCP服务 │ │ - 工作流控制 │ │ - 心理分析 │ │
│ └──────────────┘ └──────────────────┘ └──────────────────┘ │
│ ▲ │ │ │
│ │ ▼ │ │
│ │ ┌──────────────────┐ │ │
│ └──────────────│ 医美服务器 │◀─────────────┘ │
│ │ (CRM + MCP) │ │
│ │ - 客户档案 │ │
│ │ - 保存清洗结果 │ │
│ │ - 知识库检索 │ │
│ └──────────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────────────┐
│ 试验环境 (本机) │
│ OpenClaw 试验 ──→ Dify ──→ MCP (本地模拟) │
└─────────────────────────────────────────────────────────────────────────┘
```
| 服务器 | 角色 | 主要职责 |
|-------|------|---------|
| **Dify 服务器** | 专家大脑 | 提供强模型能力:深度画像、心理分析、复杂推理 |
| **OpenClaw 生产** | 自动化引擎 | 流程编排、Agent调度、MCP 调用、工作流控制 |
| **医美服务器** | 信息化底座 | CRM客户管理、MCP服务保存/查询)、知识库 |
| **OpenClaw 试验** | 测试验证 | 流程验证、Agent调试、功能测试 |
### 2.2 混合架构设计
**核心理念**OpenClaw 做"调度员"Dify 做"专家"
| 层级 | 能力 | 适用场景 |
|-----|------|---------|
| **OpenClaw** | 弱模型 + 自动化 | 流程控制、简单判断、API调用、任务编排 |
| **Dify** | 强模型 + 长上下文 | 深度分析、心理画像、复杂推理、专业输出 |
```
OpenClaw Agent (销售编排)
├──→ Sub-agent A1 (清洗) ──→ Dify 或 内置
├──→ Sub-agent A2 (复盘) ──→ Dify 或 内置
├──→ Sub-agent B (画像) ──→ Dify (强模型)
└──→ Sub-agent C (话术) ──→ Dify + 知识库
```
### 2.3 调用方式
#### 方式一IM 发起(飞书/企业微信)
```
用户(飞书) ──→ 飞书消息 ──→ OpenClaw Gateway ──→ 销售Agent
┌─────────────────────────┤
▼ ▼
清洗Agent Dify Agent
│ │
▼ ▼
医美服务器MCP 医美服务器MCP
│ │
▼ ▼
返回"面诊接待小贴士" 返回分析结果
```
#### 方式二:系统 API 发起
```
医美系统 ──→ POST /v1/chat/completions ──→ OpenClaw Gateway
┌─────────────────┼─────────────────┐
▼ ▼ ▼
清洗Agent 画像Agent 话术Agent
│ │ │
▼ ▼ ▼
医美MCP 医美MCP 医美MCP
│ │ │
▼ ▼ ▼
HTTP Response ─────────────────────────→ 医美系统
```
**API 调用示例**
```bash
curl -X POST 'http://<openclaw-host>:18789/v1/chat/completions' \
-H 'Authorization: Bearer <gateway-token>' \
-H 'Content-Type: application/json' \
-d '{
"model": "openclaw:sales",
"messages": [
{"role": "user", "content": "请清洗客户张三的聊天记录..."}
]
}'
```
## 三、Agent 体系设计
### 3.1 Agent 与 Sub-agent 的区别
| 特性 | Agent智能体 | Sub-agent子智能体 |
|-----|----------------|---------------------|
| **身份** | 独立"大脑",有自己的人设 | 从属于主Agent |
| **会话** | 独立session有自己的记忆 | 共享主Agent上下文 |
| **模型** | 独立配置 | 可单独指定覆盖主Agent |
| **触发** | 独立接收消息通过bindings | 被主Agent调用 |
| **调用方式** | `sessions_spawn` 或 bindings | 主Agent内部调度 |
| **适用场景** | 独立角色、不同渠道入口 | 同一业务流程的分工环节 |
**在本方案中的定位**
```
┌─────────────────────────────────────────────────────────────┐
│ wantsong-sales (主Agent) │
│ - 角色:销售流程编排 │
│ - 模型:弱模型 (Qwen/Minimax) │
│ - 职责:接收请求 → 调度Sub-agent → 整合结果 → 返回 │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────┼─────────────────────┐
▼ ▼ ▼
┌───────────────┐ ┌───────────────┐ ┌───────────────┐
│ Sub-agent A1 │ │ Sub-agent A2 │ │ Sub-agent B │
│ 聊天记录清洗 │ │ 面诊复盘质检 │ │ 深度心理画像 │
│ 模型:弱模型 │ │ 模型:弱模型 │ │ 模型Dify │
└───────────────┘ └───────────────┘ └───────────────┘
```
### 3.2 Agent 设计
#### 3.2.1 主Agentwantsong-sales销售编排
| 属性 | 值 |
|-----|-----|
| **Agent ID** | `wantsong-sales` |
| **模型** | minimax-portal/MiniMax-M2.5(弱模型,便宜) |
| **人设** | 医美销售顾问,擅长流程控制 |
| **工具** | sessions_spawn、exec、read、write |
**核心 PromptGL0**
```
你是医美销售智能体编排中心。你的任务是根据用户需求,
调度相应的子智能体完成销售流程。
销售流程:
1. 线索清洗 (A1) → 2. 面诊复盘 (A2) → 3. 深度画像 (B) → 4. 话术生成 (C)
根据输入内容判断当前处于哪个环节调用对应的Sub-agent。
简单任务可内置处理复杂分析调用Dify强模型。
```
#### 3.2.2 Sub-agent 设计
| Sub-agent | 功能 | 模型选择 | 调用方式 |
|----------|------|---------|---------|
| **A1-清洗** | 聊天记录清洗、结构化 | 弱模型(内置) | 直接处理 |
| **A2-复盘** | 面诊录音质检、摘要 | 弱模型(内置) | 直接处理 |
| **B-画像** | ORBIT/PRISM心理分析 | **Dify 强模型** | 调用 Dify API |
| **C-话术** | 知识库检索 + 话术生成 | **Dify 强模型** | 调用 Dify API |
### 3.3 通用销售心智模型
**核心逻辑**(适用于高客单价销售):
```
客户接触 ──→ 需求挖掘 ──→ 方案展示 ──→ 异议处理 ──→ 逼单转化 ──→ 关系维护
│ │ │ │ │ │
▼ ▼ ▼ ▼ ▼ ▼
渠道来源 痛点识别 个性化方案 价格/效果 成交信号 复购/转介绍
```
**心理分析框架**
| 维度 | 维度 | 说明 |
|-----|------|-----|
| **ORBIT** | Power | 决策权力(本人/配偶/父母) |
| | Relationship | 人际关系(依赖/独立) |
| | Motivation | 动机(变美/自信/社交) |
| **PRISM** | Meme | 深层恐惧(怕痛/怕贵/怕没效果) |
| | Reasoning | 认知逻辑(纠结点) |
### 3.4 三层配置结构
**核心理念**:通用内核 + 差异化外置
```
┌─────────────────────────────────────────────────────────────┐
│ 销售流程层(通用) │
│ SKILL.md / prompts/ │
│ - 销售流程PromptGL0-GL4
│ - 心理分析框架 │
│ - 工作流逻辑 │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│ 行业话术层(可切换) │
│ knowledge-base/行业/ │
│ ├── 医美/ │
│ │ ├── 话术库.md │
│ │ ├── 术语表.md │
│ │ └── 常见问题.md │
│ ├── 眼镜/ │
│ └── 教育/ │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│ 企业信息层(独立配置) │
│ knowledge-base/企业/ │
│ ├── 医美-A机构/ │
│ │ ├── 企业信息.md简介、地址、联系方式
│ │ ├── 产品资料.md项目、价格、优惠
│ │ └── 成功案例.md │
│ └── 医美-B机构/ │
└─────────────────────────────────────────────────────────────┘
```
**配置示例**
```yaml
# 销售Agent配置
industry: "医美"
enterprise: "A机构"
# 自动加载:
# 1. knowledge-base/行业/医美/话术库.md
# 2. knowledge-base/企业/医美-A机构/企业信息.md
# 3. knowledge-base/企业/医美-A机构/产品资料.md
```
---
## 四、技术实现
### 4.1 OpenClaw 配置
#### 4.1.1 Agent 注册
```json5
{
agents: {
list: [
{
id: "wantsong-sales",
name: "医美销售编排",
workspace: "/root/.openclaw/workspace/wantsong-sales",
model: "minimax-portal/MiniMax-M2.5"
}
]
}
}
```
#### 4.1.2 Sub-agent 调用Dify API
```bash
# 调用Dify深度画像Agent
curl -sL -X POST 'https://aiplatform.wantsong.life/v1/chat-messages' \
-H 'Authorization: Bearer {api_key}' \
-H 'Content-Type: application/json' \
-d '{
"inputs": {},
"query": "客户画像分析:{客户微信线索} + {面诊事实}",
"response_mode": "blocking",
"conversation_id": "",
"user": "openclaw-sales"
}'
```
#### 4.1.3 MCP 调用
```bash
# 调用医美服务器MCP服务
curl -X POST 'http://<yimei-server>:8080/mcp/save-clean-result' \
-H 'Content-Type: application/json' \
-d '{
"customer_id": "xxx",
"clean_result": {...}
}'
```
### 4.2 调用流程(完整示例)
#### 场景:用户通过飞书发起"清洗客户聊天记录"
```
1. 用户在飞书发送:"清洗客户张三的聊天记录"
2. 飞书 → OpenClaw Gateway (wantsong-sales)
3. 主Agent 解析意图 → 调用 Sub-agent A1 (清洗)
4. A1 处理 → 返回结构化线索 + 《面诊接待小贴士》
5. 主Agent 调用医美MCP保存结果
6. 返回结果给用户(飞书)
```
### 4.3 试验与生产切换
| 环境 | OpenClaw URL | Dify URL | MCP 地址 |
|-----|-------------|---------|---------|
| **试验** | 本机 :18789 | aiplatform.wantsong.life | 本地模拟 |
| **生产** | 生产服务器 | 同上 | 医美服务器真实地址 |
**切换方式**
- 更换 `skills/dify/SKILL.md` 中的 API 地址
- 更换 MCP 调用地址配置
好的,继续输出最后两章:
---
## 五、实施计划
### 5.1 阶段划分
```
┌─────────────────────────────────────────────────────────────────────────┐
│ 实施路线图 │
├─────────────────────────────────────────────────────────────────────────┤
│ │
│ 阶段一:试验验证 (1-2周) │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ • 搭建 wantsong-sales 主Agent │ │
│ │ • 实现 A1 清洗 Sub-agent (内置弱模型) │ │
│ │ • 飞书渠道接入测试 │ │
│ │ • MCP 调用本地模拟 │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ ▼ │
│ 阶段二:能力扩展 (1周) │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ • 实现 A2 复盘 Sub-agent │ │
│ │ • 实现 B 画像 Sub-agent (调用Dify) │ │
│ │ • 实现 C 话术 Sub-agent │ │
│ │ • 行业话术库配置(医美) │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ ▼ │
│ 阶段三:生产部署 (1周) │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ • 部署到 OpenClaw 生产服务器 │ │
│ │ • 医美服务器 MCP 对接 │ │
│ │ • API 方式接入医美系统 │ │
│ │ • 监控与日志配置 │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ ▼ │
│ 阶段四:复制扩展 (持续) │
│ ┌─────────────────────────────────────────────────────────────────┐ │
│ │ • 复制到其他行业(眼镜、教育、金融) │ │
│ │ • 新增企业配置 │ │
│ │ • 优化迭代 │ │
│ └─────────────────────────────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────────────┘
```
### 5.2 里程碑
| 阶段 | 里程碑 | 验收标准 |
|-----|--------|---------|
| 阶段一 | 试验环境跑通 | 飞书发起 → 清洗 → 返回结果,全流程跑通 |
| 阶段二 | 完整流程上线 | A1→A2→B→C 全流程跑通,结果准确 |
| 阶段三 | 生产部署完成 | 医美系统API接入稳定运行 |
| 阶段四 | 行业复制 | 第二个行业(眼镜/教育)配置完成 |
### 5.3 人员分工
| 角色 | 职责 |
|-----|------|
| **架构师(你)** | 方案设计、Agent配置、Prompt优化 |
| **轮机长(开发)** | MCP开发、API对接、医美系统改造 |
| **测试** | 功能测试、流程验证 |
---
## 六、附录
### 6.1 技术栈
| 组件 | 技术 | 说明 |
|-----|------|-----|
| **编排引擎** | OpenClaw | 流程控制、Agent调度 |
| **专家大脑** | Dify | 深度分析、强模型推理 |
| **信息化底座** | 医美服务器 | CRM、MCP、知识库 |
| **入口** | 飞书/企业微信/医美系统 | IM or HTTP API |
### 6.2 配置文件结构
```
wantsong-sales/
├── SKILL.md # 主Agent入口
├── prompts/
│ ├── sales-flow.md # 销售流程Prompt
│ └── psychology.md # 心理分析框架
├── knowledge-base/
│ ├── 行业/
│ │ ├── 医美/话术库.md
│ │ └── 眼镜/话术库.md
│ └── 企业/
│ ├── 医美-A机构/企业信息.md
│ └── 医美-A机构/产品资料.md
├── skills/
│ └── dify/ # Dify调用已实现
└── config.yaml # 环境配置
```
### 6.3 API 接口定义
#### 清洗接口
```yaml
POST /v1/chat/completions
Authorization: Bearer <token>
Content-Type: application/json
Request:
{
"model": "openclaw:sales",
"messages": [
{
"role": "user",
"content": "清洗客户聊天记录 | 客户ID: 12345 | 内容: <文本>"
}
]
}
Response:
{
"id": "...",
"choices": [
{
"message": {
"content": "{\"clues\": {...}, \"tips\": \"面诊接待小贴士...\"}"
}
}
]
}
```
### 6.4 风险与对策
| 风险 | 影响 | 对策 |
|-----|------|-----|
| Dify API 不稳定 | 画像/话术无法生成 | 增加重试机制 + 降级处理 |
| MCP 调用失败 | 数据无法保存 | 记录日志 + 告警 + 人工介入 |
| 强模型幻觉 | 画像分析不准确 | 增加人工审核环节 |
| 并发过高 | 响应延迟 | 限流 + 队列机制 |