用途:面向需要构建消息管道、客户通知、双向客服及合规敏感短信的工程师,指导在 OpenClaw 中落地 Twilio Programmable Messaging(SMS/MMS)。
主要能力:可靠发送 SMS/MMS(支持 Messaging Service、地理匹配、粘性发送方、媒体限制);通过 webhook 接收入站消息并用 TwiML 同步回复;用状态回调跟踪 queued/sent/delivered/undelivered/failed 生命周期;实现退订/STOP 等关键词与合规流程;运营美国 A2P 10DLC 与免付费验证;进行签名校验、重试、幂等、限流与运营商错误排错。
使用方式:需 Twilio 账号、TWILIO_ACCOUNT_SID、TWILIO_AUTH_TOKEN,及 TWILIO_MESSAGING_SERVICE_SID(推荐)或 TWILIO_FROM_NUMBER;webhook 需公网 HTTPS,默认接收 application/x-www-form-urlencoded,并校验 X-Twilio-Signature。示例环境为 Node.js 20.11.1、Python 3.11.7,SDK 为 twilio(Node)4.23.0 与 twilio(Python)9.4.1,Web 框架示例为 Express 4.18.3、FastAPI 0.109.2。安装:pip install twilio;npm install -g twilio-cli@5.16.0。本地隧道可用 ngrok http 3000。发送可调用 client.messages.create,并使用 messagingServiceSid、statusCallback、provideFeedback;入站与状态回调需幂等、快速返回 2xx,回调按至少一次投递处理。
适用场景与限制:用于通知、双向支持与合规短信;sent 仅表示已交给运营商,不代表送达。退订由 Twilio 自动屏蔽,应用需记录退订状态、避免对已退订号码重试(错误码 21610)。MMS 媒体需 HTTPS 公开可达,建议小于 500KB,私有媒体用足够 TTL(≥1小时)的签名 URL。美国 A2P 10DLC 未注册流量可能被过滤或拦截;短码高吞吐但成本高、开通周期长;免付费适用于美加但需验证。文档未提供具体收费与价格。