用途:让 OpenClaw 实现并运营 Twilio WhatsApp Business 消息子系统,涵盖模板消息、会话消息、媒体附件、Webhook 接收与状态回调、订阅同意管理(opt-in/opt-out),以及在限流、重试、幂等、错误码与 Messaging Service 成本控制等生产约束下可靠运行。
主要能力:发送模板消息(须使用 Meta Business Manager 预先审批的模板,推荐经 Content API 传 contentSid 与 contentVariables);发送会话消息(用户来信后 24 小时窗口内可发自由文本与媒体);通过 MediaUrl 发送图片/文档/音频/视频;接收来信 Webhook 与消息状态回调(queued、sent、delivered、read、failed、undelivered);用 X-Twilio-Signature 校验请求;实现 STOP/UNSUBSCRIBE 等退订关键词与抑制列表。
使用方式:Twilio 地址使用 whatsapp: 前缀,生产建议用 MessagingServiceSid 路由;安装 twilio(Node 4.23.0 / Python 9.0.5);本地可用 ngrok 暴露 HTTPS Webhook;Node 示例 client.messages.create({to:whatsapp:${toE164}, messagingServiceSid, body, statusCallback}),Python 示例 client.messages.create(to=..., messaging_service_sid=..., body=..., media_url=[...], status_callback=...)。签名校验需 TWILIO_AUTH_TOKEN(validateRequest、RequestValidator.validate),与 REST 调用所用的 API Key 分开保存。
限制与注意:Webhook 必须幂等并按 MessageSid 或 MessageSid+MessageStatus 去重,状态回调可能乱序;快速返回 2xx 并转队列处理;媒体 URL 须 Twilio 可公开访问(可用短时签名 URL);模板审批与类别影响送达与合规;WhatsApp 需用户 opt-in 并留存同意证据。资料未提供收费与价格信息。