← 首页

集成指南

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 并购买手机号

  1. 访问 twilio.com,注册账户。新账户会获得试用额度,可用于测试。
  2. 在 Twilio 控制台,进入 Phone Numbers → Manage → Buy a number,搜索并购买一个支持 SMS 的号码。美国号码费用最低,国际覆盖面广,月租通常仅需几美元。
  3. 记下你的 Twilio 手机号码(E.164 格式,如 +15551234567)。

第2步:获取 Account SID 和 Auth Token

  1. 在 Twilio 控制台首页(或 Account → General Settings),找到并复制你的 Account SID(以 AC 开头)和 Auth Token
  2. 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步:测试集成

  1. 在 Telegram(或你使用的其他原生渠道)向你的 OpenClaw 机器人发送:"帮我发一条短信到 +1XXXXXXXXXX,内容:来自 AI 助手的测试消息"
  2. 助手调用 twilio-sms 技能,技能 POST 到 Twilio API。
  3. 几秒内,目标号码收到短信。
  4. 在 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 接入微信接入等原生渠道配置。

给你的 AI 助手加上短信外发能力

在 Telegram 或微信上部署 OpenClaw 助手,再接入 Twilio 短信通知。首月特惠 $3,支持支付宝和微信支付。

立即部署