集成指南
OpenClaw + Twilio — 给你的 AI 助手加上短信通知能力
OpenClaw 的原生消息渠道是 Telegram、Discord、WhatsApp、微信、Slack 和网页聊天。短信(SMS)不是内置的对话渠道 — 但你的 OpenClaw AI 助手可以通过一个自定义技能(skill)调用 Twilio 的可编程短信 API,向 Twilio 支持的手机号发送外发短信:告警、提醒、验证码、通知等。本文手把手教你完成全套配置。
Twilio 是什么?
Twilio 是一个云通信平台(CPaaS),让应用程序通过 REST API 发送短信(SMS/MMS)、语音电话等。其可编程短信(Programmable Messaging)API 只需向一个接口发送 POST 请求,即可将短信投递到 Twilio 支持的国家/地区手机号 — 前提是你的 Twilio 账户拥有一个支持 SMS 的手机号码、足够的余额,且目标号码符合 Twilio 的国家、运营商及试用账户限制。
Twilio 按消息条数收费,加上号码月租费;不同目的地国家的运营商费用有所不同。需要特别说明的是:Twilio 对中国大陆号码的短信服务可用性有限,费用也远高于美国/欧洲线路。如果你的用户主要在中国大陆,OpenClaw 原生支持的微信渠道是更合适的通知方式。
OpenClaw + Twilio 的工作原理
OpenClaw 的 AI 助手可以通过技能(Skills,ClawHub 提供 3,200+ 个)和 MCP 工具调用任意外部 HTTP API。Twilio 短信在这里属于"外发通知渠道",而非内置对话渠道:
- 你的机器人在 Telegram、Discord、WhatsApp 等原生渠道与用户进行对话。
- 当助手需要发送一条短信 — 比如告警、提醒、一次性验证码 — 它调用你配置的 Twilio 技能,由技能 POST 到 Twilio Messages API。
- 收件人的手机收到短信。用户不会通过短信回复到 OpenClaw — 短信回复需要配置 Twilio 入站 Webhook,超出本指南范围。
这个模式非常适合:服务宕机告警、预约提醒、每日摘要推送、双因素验证码(2FA)等"发出去就完成"的通知场景。
第1步:注册 Twilio 并购买手机号
- 访问 twilio.com,注册账户。新账户会获得试用额度,可用于测试。
- 在 Twilio 控制台,进入 Phone Numbers → Manage → Buy a number,搜索并购买一个支持 SMS 的号码。美国号码费用最低,国际覆盖面广,月租通常仅需几美元。
- 记下你的 Twilio 手机号码(E.164 格式,如
+15551234567)。
第2步:获取 Account SID 和 Auth Token
- 在 Twilio 控制台首页(或 Account → General Settings),找到并复制你的 Account SID(以
AC开头)和 Auth Token。 - Auth Token 相当于密码 — 不要提交到公开代码库或打印到日志中。
第3步:为 OpenClaw 助手添加 Twilio 技能
你需要创建(或从 ClawHub 安装)一个技能,让它调用 Twilio Messages API:
POST https://api.twilio.com/2010-04-01/Accounts/你的ACCOUNT_SID/Messages.json请求使用 HTTP Basic Auth(Account SID 为用户名,Auth Token 为密码)。POST 请求体(表单编码)需要三个字段:
From=+15551234567 # 你的 Twilio 号码
To=+86XXXXXXXXXXX # 收件人号码(E.164格式,含国家代码)
Body=你好,这是来自 AI 助手的提醒将 Account SID、Auth Token 和 Twilio 号码添加到技能配置中,使技能可以在不暴露凭证的情况下完成认证:
{
"skills": {
"twilio-sms": {
"accountSid": "ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"authToken": "your_auth_token_here",
"fromNumber": "+15551234567"
}
}
}在 OpenClaw Launch 的实例配置中,你也可以将这些凭证作为安全环境变量传入(加密存储),避免写入 JSON 配置文件。
第4步:告诉助手何时发短信
在你的助手系统提示中添加清晰的说明,例如:
当用户要求你通过短信发送提醒或告警时,
使用 twilio-sms 技能将消息发送到用户的手机号。
发送前始终与用户确认手机号码。
注意:短信仅用于外发通知,用户无法通过短信回复你;
请他们在 Telegram 上继续和你对话。有了这条指令,用户只需说"下午3点用短信提醒我有个会议",助手就会自动调用 Twilio 技能发送提醒,无需额外代码。
第5步:测试集成
- 在 Telegram(或你使用的其他原生渠道)向你的 OpenClaw 机器人发送:"帮我发一条短信到 +1XXXXXXXXXX,内容:来自 AI 助手的测试消息"
- 助手调用 twilio-sms 技能,技能 POST 到 Twilio API。
- 几秒内,目标号码收到短信。
- 在 Twilio 控制台的 Monitor → Messaging → Logs 中确认投递状态。
典型使用场景
外发告警与监控
让助手监控某项服务或数据,当触发条件满足(价格越线、系统报错、表单提交)时,发送一条短信告警。助手保持静默,直到触发条件出现。
定时提醒
用户告诉助手"明天早上9点用短信提醒我吃药",助手完成调度,Twilio 完成投递,无需额外的提醒 App。
验证码(2FA)
如果你在管理某个需要用户验证的应用,可以让助手通过 Twilio 技能发送一次性验证码。大规模生产级 2FA 建议使用 Twilio Verify API(同一套凭证,调整技能接口地址即可)。
每日/每周摘要
让助手汇总每日或每周信息,通过短信推送摘要。注意保持消息简短:单条 SMS 160 个英文字符(中文约 70 字);超出后会被拆分为多条计费。
短信 vs 原生渠道:选哪个?
| 对比维度 | 短信(Twilio 技能) | Telegram / Discord(原生) | 微信(原生) |
|---|---|---|---|
| 方向 | 仅外发(本指南范围) | 双向对话 | 双向对话 |
| 配置复杂度 | 需 Twilio 账户 + 技能配置 | Bot Token + 一键连接 | 扫码 + 一键连接 |
| 消息费用 | Twilio 按条计费 + 运营商费 | 包含在 OpenClaw 套餐内,免费 | 包含在 OpenClaw 套餐内,免费 |
| 无需额外 App | 是 — 任意手机均可接收 | 需要 Telegram/Discord | 需要微信 |
| 中国大陆 | 可用性有限,费用较高 | 受限(Telegram/Discord 被封) | 原生支持,推荐 |
| 最适合 | 单向告警,触达任意手机 | 对话、社区 | 对话、国内用户 |
费用说明
Twilio 的消息费用需单独计算,与你的 OpenClaw Launch 订阅费用分开。具体费率因目的地国家和消息量而异,请参考 Twilio 官网定价页面。
中国大陆短信:Twilio 对大陆号码的短信服务可用性有限,且单条费用远高于美欧线路。如果你的主要用户在中国大陆,强烈建议优先使用 OpenClaw 原生的微信渠道满足通知需求。
OpenClaw Launch 订阅:首月特惠 $3,之后 Lite $6/月、Pro $20/月,支持支付宝和微信支付。原生渠道(Telegram、微信等)的消息费用已包含在套餐内,Twilio 短信费用由 Twilio 单独按用量计费。
常见问题
认证报错(401)
确认 Account SID 以 AC 开头,Auth Token 从 Twilio 控制台精确复制。如果 Auth Token 已被重置,在控制台更新后记得同步更新技能配置。
试用账户限制
Twilio 试用账户只能发送到已验证的手机号,且消息带试用水印。正式上线前需升级为付费账户。
消息未送达
查看 Twilio 控制台消息日志中的错误码。常见原因:收件人号码格式错误(必须是含国家码的 E.164 格式)、目的地国家线路不支持、运营商过滤。
常见问题(FAQ)
短信是 OpenClaw 的内置渠道吗?
不是。OpenClaw 的原生对话渠道包括 Telegram、Discord、WhatsApp、微信、Slack 和网页聊天,短信不在其中。本指南介绍的 Twilio 集成属于"外发 API 模式":助手通过自定义技能调用 Twilio API 发出短信,用户无法通过短信和助手进行对话。
用户可以通过短信回复助手吗?
本指南的配置范围内不支持。短信仅用于外发通知,用户收到短信后,应回到 Telegram 等原生渠道继续和助手交流。如需接收短信回复,需另行配置 Twilio 入站 Webhook,属于进阶集成。
Twilio 在中国大陆可用吗?
技术上 Twilio 可以向中国大陆手机号发短信,但可用性有限、费用较高。如果你的用户主要在中国大陆,建议使用 OpenClaw 原生集成的微信渠道,既免费(套餐内),又稳定,体验更好。
需要 Twilio 付费账户吗?
测试阶段可以用试用账户(仅能发到已验证号码)。正式向真实用户发送短信,需要升级为付费账户并购买手机号,号码月租通常几美元,加上按条计费的消息费。
OpenClaw + Twilio 如何定价?
OpenClaw Launch 首月特惠 $3,之后 Lite $6/月、Pro $20/月,支持支付宝和微信支付。Twilio 短信费用由 Twilio 单独计费,与 OpenClaw Launch 订阅无关。查看模型选择和 Skills 中心了解更多扩展能力。
开始部署
无论你是想在 Telegram 机器人上加一个短信告警功能,还是让你的 AI 助手定时给自己发提醒,OpenClaw + Twilio 的组合都能轻松实现 — 助手在原生渠道负责对话,Twilio 负责外发短信通知。
更多扩展方式:查看 Skills 中心(3,200+ 技能)、MCP 工具接入指南,或了解 Telegram 接入、微信接入等原生渠道配置。