WhatsApp Business Al Assistant — WhatsApp Business 人工智能助手

WhatsApp Business AI 助手名称和目的 为南非当地企业自动化 WhatsApp 会话——处理回复、预订查询、潜在客户捕获和智能跟进，无需 24/7 人工关注。 针对健身房、餐厅、美容院、诊所和服务型企业设计。

先决条件 要求 版本/详细信息 OpenClaw v2.4+ Node.js v18+ WhatsApp Business API (Meta) 已批准的商业账户 Meta Developer App 配置了 WhatsApp 产品 Python 3 v3.10+（用于 NLP 流水线） wacli CLI 安装在主机上 ngrok 或静态 IP 用于 webhook 回调

安装

• 复制技能文件

cp -r streams/01_ClawHub_Skills/01_WhatsApp_Business_AI_Assistant/* ~/.openclaw/skills/

• 安装依赖项

cd ~/.openclaw/skills/whatsapp-business-ai npm install pip install -r requirements.txt

• 配置环境

创建 ~/.openclaw/skills/whatsapp-business-ai/.env： WHATSAPP_PHONE_NUMBER_ID=你的电话号码 ID WHATSAPP_ACCESS_TOKEN=你的永久令牌 WHATSAPP_VERIFY_TOKEN=你的 webhook 验证令牌 WHATSAPP_BUSINESS_ACCOUNT_ID=你的商业账户 ID BUSINESS_HOURS_TIMEZONE=Africa/Johannesburg DEFAULT_LANGUAGE=en NLP_MODEL_PATH=./models/za_intent_classifier LEAD_DB_PATH=./data/leads.db BOOKING_CALENDAR_ID=你的 Google 日历 ID

• 链接到 wacli

# 验证 wacli 是否可用 which wacli || brew install wacli wacli --configure

• 设置 webhook

# 启动 webhook 接收器（使用 ngrok 进行开发） ./scripts/start-webhook.sh # 注册 webhook 与 Meta curl -X POST "https://graph.facebook.com/v18.0/$WHATSAPP_PHONE_NUMBER_ID/subscriptions" \ -H "Authorization: Bearer $WHATSAPP_ACCESS_TOKEN" \ -d "object=whatsapp_business_account&callback_url=https://your-ngrok-url.ngrok.io/webhook&verify_token=$WHATSAPP_VERIFY_TOKEN"

使用 启动助手 # 生产模式 openclaw skill run whatsapp-business-ai # 开发/试运行 openclaw skill run whatsapp-business-ai --dry-run 助手作为一个持久的 OpenClaw 进程运行： 监听传入的 WhatsApp 消息通过 webhook 分类意图（预订、查询、投诉、潜在客户） 生成上下文感知回复 记录潜在客户到本地数据库 根据商业规则安排跟进

工作流概述 传入消息 → 意图分类器 → 回复生成器 → 发送回复 ↓ 预订检测？ ├── 是 → 检查日历 → 确认时间段 → 添加预订 └── 否 → 潜在客户？ → 记录潜在客户 → 安排跟进

可用命令 命令 描述 /status 显示助手健康状况、队列深度、今天的消息计数 /leads 以 CSV 或 JSON 格式导出潜在客户 /分析 显示过去 24 小时的发送/回复/跟进计数 /blacklist <电话> 屏蔽一个号码 /broadcast 向所有潜在客户发送批量消息（先询问） /暂停 停止接受新消息（使用 /resume 恢复）

工作流模板 自动回复模板位于 ./templates/。根据业务类型自定义： templates/ ├── auto_replies/ │ ├── booking_gym.yaml │ ├── booking_restaurant.yaml │ ├── booking_salon.yaml │ ├── greeting_day.yaml │ ├── greeting_night.yaml │ ├── hours_inquiry.yaml │ ├── pricing_inquiry.yaml │ ├── complaint_acknowledgement.yaml │ └── out_of_hours.yaml ├── follow_ups/ │ ├── no_reply_24h.yaml │ ├── abandoned_booking.yaml │ ├── post_service_feedback.yaml │ └── promotion_blast.yaml └── intents.yaml

示例：booking_gym.yaml name: gym_booking trigger: intents: [booking, tour_inquiry, membership_inquiry] confidence_threshold: 0.75 response: template: | Hi {{customer_name}}！ 👋 感谢您联系 {{business_name}}。 我可以帮助您预订： 🏋️ 免费试用课程 📋 会员咨询 🎯 个人训练介绍 什么时间适合您？ 我们的营业时间是： 周一至周五：上午 5:00 - 晚上 9:00 周六：上午 6:00 - 晚上 6:00 周日：上午 7:00 - 下午 2:00 只需告诉我您偏好的日期和时间！ buttons:

• "预订试用"
• "查看价格"
• "询问人类"

提示配置 编辑 ./config/prompts.yaml： classifier_prompt: | 将传入的 WhatsApp 消息分类为一个意图。 意图：[预订、价格查询、营业时间、投诉、潜在客户、一般、垃圾邮件] 上下文：{business_type} 在 {location} 消息：{text} 只需响应意图名称和置信度。 response_prompt: | 您是 {assistant_name}，{business_name} 的友好 AI 助手。 位置：{location} 业务类型：{business_type} 营业时间：{hours} 客户消息：{text} 检测到的意图：{intent} 以温暖、专业的语气回复。 要简洁。 如果是预订，请询问时间和联系信息。 永远不要泄露您不确定的价格。 使用南非英语。

示例提示用于人类操作员 "嘿 Marvis，可以检查一下健身房助手吗？有多少未合格的潜在客户在等待？" "为 'Jozi Cuts Barbershop' 在 Randburg 设置一个新的 WhatsApp 助手。" "什么是 th