Skip to content

如何使用WhatsApp搭建OpenClaw多Agent协作

需要快速获取验证码?立即开始您的验证之旅

立即开始

关于OpenClaw

OpenClaw是2025年底诞生的开源AI Agent框架(MIT许可证),GitHub Stars突破270,000+。它将ChatGPT、Claude、Gemini等大型语言模型接入Discord、Slack、WhatsApp等通讯平台,支持在一个Gateway进程内运行多个完全隔离的AI助手。最新版本v2026.3.7引入可插拔ContextEngine,成为AI工程师和开发者的主流选择。

为什么用WhatsApp组建多Agent协作?

WhatsApp拥有超过20亿月活跃用户,是全球最广泛使用的即时通讯应用。企业和开发团队选择WhatsApp作为OpenClaw多Agent部署平台,因为其优势显而易见:

  • 客户覆盖广:直接在客户习惯使用的平台上提供AI服务
  • 多部门分流:不同WhatsApp号码对应不同业务部门(销售、客服、技术支持)
  • 独立上下文:每个Agent拥有独立的对话历史,互不干扰
  • 统一管理:通过单一Gateway进程统一调度和监控所有Agent
  • 灵活扩展:随时添加新的WhatsApp号码和对应的Agent

准备工作:批量获取WhatsApp号码

OpenClaw WhatsApp多Agent架构的核心要求是每个Agent对应独立的WhatsApp账号(即独立的手机号码)。每个账号需要:

  1. 一个独立的手机号码(用于WhatsApp注册)
  2. 手机号SMS验证(WhatsApp注册强制要求)
  3. 独立的WhatsApp Business API Token

批量WhatsApp号码的SMS验证方案

当需要同时配置3个、5个甚至10个Agent时,逐一购买实体SIM卡既昂贵又耗时。这正是虚拟手机号接码服务的典型应用场景。

SMS-Act 提供WhatsApp SMS验证接码服务,具体优势:

  • 按需获取:每次仅购买需要的验证码,8积分/次
  • 全球号码:支持印尼、菲律宾、美国等100+国家号码
  • 高成功率:95%以上验证成功率,失败自动退款
  • 即时到达:通常30秒内接收WhatsApp验证码

详细操作流程请参考:WhatsApp验证码接收教程

分步配置指南

第一步:批量获取WhatsApp手机号

为每个计划部署的Agent通过SMS-Act获取独立手机号:

  1. 访问 SMS-Act平台
  2. 在服务搜索框输入"WhatsApp"
  3. 选择目标国家(推荐印尼、菲律宾、美国)
  4. 点击"获取号码",系统即时分配虚拟号码
  5. 将号码用于WhatsApp注册并接收SMS验证码
  6. 重复以上步骤,为每个Agent获取独立号码

第二步:申请WhatsApp Business API访问

每个WhatsApp号码需要接入WhatsApp Business Cloud API:

  1. 访问 Meta Developer Portal
  2. 创建Meta开发者账号
  3. 新建应用,类型选择"Business"
  4. 在应用内添加"WhatsApp"产品
  5. 配置WhatsApp Business账号
  6. 添加并验证手机号码(使用SMS-Act提供的号码接收验证码)
  7. 获取Webhook URL和Access Token

重复步骤2-7,为每个Agent的号码申请独立API访问权限。

第三步:安装OpenClaw

bash
# 克隆仓库
git clone https://github.com/openclaw-ai/openclaw.git
cd openclaw

# 安装依赖
npm install

# 复制配置模板
cp openclaw.example.json openclaw.json

第四步:配置多Agent

编辑 openclaw.json 文件,配置多个WhatsApp Agent实例:

json
{
  "gateway": {
    "port": 3000,
    "log_level": "info"
  },
  "agents": {
    "list": ["agent-sales", "agent-support", "agent-tech"]
  },
  "channels": {
    "whatsapp": {
      "accounts": {
        "agent-sales": {
          "phone": "+62XXXXXXXXXX",
          "token": "YOUR_WHATSAPP_TOKEN_FOR_SALES",
          "model": "gpt-4o",
          "system_prompt": "你是销售助手Alpha,专注于产品咨询、报价和订单跟进。"
        },
        "agent-support": {
          "phone": "+63XXXXXXXXXX",
          "token": "YOUR_WHATSAPP_TOKEN_FOR_SUPPORT",
          "model": "claude-3-5-sonnet-20241022",
          "system_prompt": "你是客服助手Beta,专注于售后服务、投诉处理和账号问题解答。"
        },
        "agent-tech": {
          "phone": "+1XXXXXXXXXXX",
          "token": "YOUR_WHATSAPP_TOKEN_FOR_TECH",
          "model": "gemini-2.0-flash",
          "system_prompt": "你是技术助手Gamma,专注于技术支持、Bug排查和开发者问题解答。"
        }
      }
    }
  },
  "bindings": [
    {
      "agent": "agent-sales",
      "channel_type": "whatsapp",
      "phone": "+62XXXXXXXXXX"
    },
    {
      "agent": "agent-support",
      "channel_type": "whatsapp",
      "phone": "+63XXXXXXXXXX"
    },
    {
      "agent": "agent-tech",
      "channel_type": "whatsapp",
      "phone": "+1XXXXXXXXXXX"
    }
  ]
}

第五步:配置Webhook

WhatsApp Business API使用Webhook推送消息,需要配置公网可访问的回调地址:

bash
# 使用ngrok进行本地测试
npm install -g ngrok
ngrok http 3000

# 将ngrok提供的HTTPS地址配置为WhatsApp Webhook URL
# 格式:https://xxxx.ngrok.io/webhook/whatsapp

生产环境建议使用服务器的公网IP或域名配置Webhook。

第六步:启动Gateway

bash
# 开发模式
npm run dev

# 生产模式(使用PM2进程管理)
npm install -g pm2
pm2 start npm --name "openclaw-gateway" -- start
pm2 save

Gateway启动后,三个Agent将同时上线,各自通过不同WhatsApp号码响应用户消息。

实际使用场景

场景一:企业多部门客服

+62-XXX → agent-sales (GPT-4o)    → 销售咨询、产品报价、订单跟踪
+63-XXX → agent-support (Claude)  → 售后服务、退款、账号支持
+1-XXXX → agent-tech (Gemini)     → 技术支持、API文档、开发者帮助

客户直接添加对应业务的WhatsApp号码,即可获得专业AI助手服务。

场景二:多语言客服系统

不同号码对应不同语言的客服Agent,通过独立上下文和专属System Prompt,每个Agent专精一种语言和文化背景,实现精准的多语言客服自动化。

常见问题FAQ

Q: 虚拟号码能用于WhatsApp Business API吗?

A: 是的。Meta的WhatsApp Business Cloud API支持使用虚拟号码进行验证,只要能接收SMS验证码即可完成手机号绑定。SMS-Act提供的虚拟号码支持WhatsApp验证,可正常接收验证码。

Q: 每个Agent必须使用不同的AI模型吗?

A: 不是必须的。多个Agent可以使用相同的AI模型(如都使用Claude),但配置不同的System Prompt来实现功能差异化。关键是每个Agent拥有独立的WhatsApp号码和独立的上下文空间。

Q: OpenClaw的WhatsApp消息处理机制是什么?

A: OpenClaw通过WhatsApp Business Cloud API的Webhook接收消息,并根据接收号码自动路由到对应的Agent进行处理。每个Agent独立维护其对话上下文(v2026.3.7的ContextEngine支持独立的向量记忆),然后通过API回复消息。

Q: 如果其中一个WhatsApp号码被封禁怎么办?

A: 更新该Agent在 openclaw.json 中的phone字段为新号码,重新申请API访问权限,更新Token后重启Gateway即可。其他Agent不受影响。

Q: Gateway进程崩溃会影响所有Agent吗?

A: 是的,所有Agent共享同一个Gateway进程。建议使用PM2或Docker实现自动重启,结合WhatsApp Webhook的重试机制确保消息不丢失。

相关推荐

相关指南

立即使用 SMS-Act 批量获取WhatsApp验证码,快速搭建您的OpenClaw多Agent协作系统!

文档及教程仅作参考说明,因时效性及其他因素影响,最终以网站实际支持为准。

SMS-Act 全球领先的在线接码平台