乐于分享
好东西不私藏

用 OpenClaw 搭建自动客服系统:从安装到上线(附代码)

用 OpenClaw 搭建自动客服系统:从安装到上线(附代码)

▎一、方案概述与架构


OpenClaw 是一个开源轻量级 AI 智能体框架,支持对接微信、Telegram、WhatsApp、飞书等多种渠道,可快速搭建 7×24 小时自动客服系统。相比传统人工客服,AI 客服的成本仅为前者的 10% 以下,却能提供 3 倍的服务时长。

推荐配置:2 核 4G 及以上云服务器(同时服务 50+ 客户需 4 核 8G)


▎二、环境准备


2.1 依赖要求


组件
最低版本
验证命令
Node.js
≥ 22.x
node -v
pnpm
≥ 9.0
pnpm -v
Git
≥ 2.30
git --version

2.2 安装 Node.js 与 pnpm


# 安装 nvm(Node 版本管理器)curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bashsource ~/.bashrc  # Linux# source ~/.zshrc   # macOS# 安装 Node.js 22nvm install 22nvm use 22nvm alias default 22# 安装 pnpmnpm install -g pnpm# 配置国内镜像(国内用户必做)pnpm config set registry https://registry.npmmirror.com/

▎三、部署方式


3.1 一键脚本快速部署(推荐新手)


# 一键安装脚本curl -fsSL https://raw.githubusercontent.com/open-claw/openclaw/main/install.sh | bash# 进入配置向导openclaw onboard --install-daemon

3.2 源码部署(完整控制)


# 克隆项目(国内用户使用 Gitee 镜像)git clone https://gitee.com/OpenClaw-CN/openclaw-cn.gitcd openclaw-cngit checkout v2026.2.2-cn# 安装依赖pnpm installpnpm ui:buildpnpm build# 启动配置向导pnpm openclaw onboard --install-daemon

3.3 Docker 容器化部署(生产环境推荐)


# docker-compose.ymlversion: '3'services:  openclaw:    image: openclaw/core:latest    container_name: openclaw-customer-service    restart: always    ports:      - "80:80"      - "443:443"    volumes:      - ./config.yml:/app/config.yml      - ./knowledge:/app/knowledge      - ./logs:/app/logs    environment:      - TZ=Asia/Shanghai      - OPENCLAW_MODE=production    deploy:      resources:        limits:          cpus: '2.0'          memory: 4G
# 启动容器docker-compose up -d# 查看日志docker logs -f openclaw

▎四、AI 模型配置


4.1 配置阿里云百炼(国内推荐)


// config/ai.ymlmodel:  provider: aliyun-bailian  api_key"你的API-Key"  endpoint"https://bailian.aliyuncs.com"  model_name: qwen-turbo  temperature0.3  max_tokens500

获取 API Key 步骤:

1. 访问阿里云百炼控制台

2. 进入「模型服务」→「API 密钥管理」

3. 创建 API-Key 并保存

# 验证模型连接openclaw test llm# 预期输出:LLM connection successful

4.2 配置 OpenAI(海外用户)

model:  provider: openai  api_key"sk-xxxx"  model_name: gpt-4  temperature0.3  max_tokens500

▎五、客服 Prompt 配置


在 OpenClaw 工作区创建 AGENTS.md:


# 客服机器人工作规则你是 [品牌名] 的专业客服助手。请遵循以下规则:## 响应规则1. **基于知识库**:所有回答必须基于提供知识库内容,不编造信息2. **简洁专业**:单次回复不超过 200 字,使用短段落3. **诚实告知**:无法回答时主动建议转人工,不强行回答4. **情绪识别**:检测到投诉或负面情绪时,表达歉意并建议转人工## 自动转人工条件- 客户明确说"转人工"- AI 连续 2 次无法回答问题- 检测到敏感关键词(退款、赔偿、投诉、账号泄露)- 客户情绪被判定为愤怒或极度不满## 转人工回复模板"您的问题我已记录,正在为您转接人工客服,请稍候。"

创建 SOUL.md 定义语气风格:


你是专业、耐心、友好的客服助手。- 语气:平和专业,不使用表情符号- 格式:短段落,关键信息可加粗- 禁止:讨论竞品、承诺未经确认的信息、索要密码

▎六、知识库构建


6.1 知识库文件结构


knowledge/├── faq.md              # 常见问题├── product-guide.md    # 产品手册├── pricing.md          # 定价与套餐├── refund-policy.md    # 退换货政策├── troubleshooting.md  # 故障排查└── escalation-rules.md # 升级规则

6.2 FAQ 格式示例(faq.md)

# 常见问题## 营业时间Q: 你们的营业时间是?A: 我们的 AI 客服 7×24 小时在线,人工客服工作时间为周一至周五 9:00-18:00## 密码重置Q: 如何重置密码?A: 进入「设置」→「安全中心」→「重置密码」,5分钟内会收到验证邮件。## 退换货政策Q: 可以退货吗?A: 自签收之日起 30 天内可申请退货,需保持商品完好。请联系人工客服处理。

6.3 通过 API 上传知识库

# 批量上传知识库文档curl -X POST http://localhost:3000/api/knowledge/upload \  -F "file=@faq.md" \  -F "category=faq" \  -H "Authorization: Bearer $API_KEY"

▎七、接入客服渠道


7.1 微信通道配置

# config.ymlchannel:  weixin:    enabled: true    heartbeat:      interval30      timeout10      retry3    queue:      enabled: true      redis:        host: localhost        port6379
# 生成绑定二维码openclaw channels generate-qrcode --channel weixin# 查看通道状态openclaw channels status

手机微信:我 → 设置 → 插件 → 找到微信 ClawBot 插件 → 启用 → 扫码绑定

7.2 Telegram 配置

# 创建 Bot:Telegram 搜索 @BotFather,输入 /newbot 获取 token# 配置 Telegram 通道openclaw channels add --channel telegram --token "你的bot_token"

7.3 Web 聊天组件嵌入

<!-- 嵌入网站的聊天组件 -->
<scriptsrc="https://your-domain.com/openclaw-chat.js"></script>
<divid="openclaw-chat"data-agent-id="your-agent-id"></div>

▎八、人工兜底机制


8.1 工单系统集成

# webhook 示例:转人工时创建工单from flask import Flask, requestimport requestsapp = Flask(__name__)@app.route('/webhook/escalate', methods=['POST'])def handle_escalation():    data = request.json    customer_message = data.get('message')    conversation_history = data.get('history')    # 创建工单    ticket = {        "title"f"客服升级:{customer_message[:50]}",        "description"f"对话摘要:\n{conversation_history}",        "priority""high" if "退款" in customer_message else "normal"    }    # 发送到客服群(企业微信/钉钉/飞书)    send_to_support_group(ticket)    return {"status""escalated"}

8.2 客服通知配置

# config.ymlescalation:  enabled: true  channels:    - type: feishu      webhook: "https://open.feishu.cn/open-apis/bot/v2/hook/xxx"    - type: slack      webhook: "https://hooks.slack.com/services/xxx"  notify_on:    - refund_request    - complaint    - low_confidence

▎九、监控与优化

9.1 关键指标


指标
目标值
说明
AI 独立解决率
≥ 70%
无需人工介入的比例
首次响应时间
< 3秒
客户发送消息到收到回复
客户满意度
> 80%
客户评价/反馈
人工介入率
< 30%
需要升级人工的比例

9.2 日志监控

# 查看实时日志openclaw logs --tail 100# 分析解决率openclaw analytics --metric resolution_rate --period 7d

9.3 持续优化流程



每周回顾    ↓分析 AI 无法回答的问题 → 补充知识库    ↓检查错误回答 → 修正知识库内容    ↓查看客户反馈 → 优化 Prompt    ↓更新话术模板 → 迭代发布

9.4 成本优化配置

# 使用 GPT-3.5 处理简单问题,GPT-4 处理复杂问题model_routing:  simple_queries:    model: "gpt-3.5-turbo"    indicators: ["greeting""faq_match""simple_question"]  complex_queries:    model: "gpt-4"    indicators: ["multi_step""technical""refund"]

▎十、上线检查清单


✅ 所有配置已通过测试环境验证

✅ 知识库覆盖 Top 50 常见问题

✅ 转人工机制已配置并可触发

✅ API Key 已更换为生产环境密钥

✅ 日志和监控已配置告警

✅ 客服团队已培训对接流程

✅ 已完成压力测试(建议 50 并发)

✅ 已配置自动备份(每日备份知识库和配置)


▎十一、常见问题速查



问题
解决方案
扫码后无反应
更新微信到最新版本,重新登录后重试
API 调用失败
检查 API Key 是否过期,确认账户余额充足
连接频繁断开
配置心跳检测heartbeat.interval: 30,检查网络
AI 回答幻觉
降低 temperature 到 0.2-0.3,严格基于知识库
响应延迟 > 5秒
检查服务器资源,启用 Redis 消息队列缓冲

▎总结


通过以上步骤,你可以在 30 分钟内完成一个 7×24 小时 AI 客服系统的搭建。建议先接入单一渠道验证效果,再逐步扩展更多渠道和功能。随着知识库的持续优化,AI 独立解决率可达 70% 以上,显著降低人工客服成本。

━━━━━━━━━━━━━━━━━━━━

智启技术服务 | 专注个人/商家/团队软件开发、系统搭建、App上架、软著申请、电脑系统升级

━━━━━━━━━━━━━━━━━━━━