用 OpenClaw 搭建自动客服系统:从安装到上线(附代码)
▎一、方案概述与架构
OpenClaw 是一个开源轻量级 AI 智能体框架,支持对接微信、Telegram、WhatsApp、飞书等多种渠道,可快速搭建 7×24 小时自动客服系统。相比传统人工客服,AI 客服的成本仅为前者的 10% 以下,却能提供 3 倍的服务时长。

推荐配置:2 核 4G 及以上云服务器(同时服务 50+ 客户需 4 核 8G)
▎二、环境准备
2.1 依赖要求
|
|
|
|
|---|---|---|
|
|
|
node -v |
|
|
|
pnpm -v |
|
|
|
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:latestcontainer_name: openclaw-customer-servicerestart: alwaysports:- "80:80"- "443:443"volumes:- ./config.yml:/app/config.yml- ./knowledge:/app/knowledge- ./logs:/app/logsenvironment:- TZ=Asia/Shanghai- OPENCLAW_MODE=productiondeploy:resources:limits:cpus: '2.0'memory: 4G
# 启动容器docker-compose up -d# 查看日志docker logs -f openclaw
▎四、AI 模型配置
4.1 配置阿里云百炼(国内推荐)
// config/ai.ymlmodel:provider: aliyun-bailianapi_key: "你的API-Key"endpoint: "https://bailian.aliyuncs.com"model_name: qwen-turbotemperature: 0.3max_tokens: 500
获取 API Key 步骤:
1. 访问阿里云百炼控制台
2. 进入「模型服务」→「API 密钥管理」
3. 创建 API-Key 并保存
# 验证模型连接openclaw test llm# 预期输出:LLM connection successful
4.2 配置 OpenAI(海外用户)
model:provider: openaiapi_key: "sk-xxxx"model_name: gpt-4temperature: 0.3max_tokens: 500
▎五、客服 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: trueheartbeat:interval: 30timeout: 10retry: 3queue:enabled: trueredis:host: localhostport: 6379
# 生成绑定二维码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.jsoncustomer_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: truechannels:- type: feishuwebhook: "https://open.feishu.cn/open-apis/bot/v2/hook/xxx"- type: slackwebhook: "https://hooks.slack.com/services/xxx"notify_on:- refund_request- complaint- low_confidence
▎九、监控与优化
9.1 关键指标
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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 并发)
✅ 已配置自动备份(每日备份知识库和配置)
▎十一、常见问题速查
|
|
|
|---|---|
|
|
|
|
|
|
|
|
heartbeat.interval: 30,检查网络 |
|
|
|
|
|
|
▎总结
通过以上步骤,你可以在 30 分钟内完成一个 7×24 小时 AI 客服系统的搭建。建议先接入单一渠道验证效果,再逐步扩展更多渠道和功能。随着知识库的持续优化,AI 独立解决率可达 70% 以上,显著降低人工客服成本。
━━━━━━━━━━━━━━━━━━━━
智启技术服务 | 专注个人/商家/团队软件开发、系统搭建、App上架、软著申请、电脑系统升级
━━━━━━━━━━━━━━━━━━━━
夜雨聆风