核心功能
TelTel SMS 技能提供命令行方式调用 TelTel (teltel.io) 云通信平台的 REST API,支持单条短信发送与批量群发两种模式。用户可通过 Node.js 脚本直接集成至 CI/CD 流水线、监控告警系统或用户通知服务。
单条发送:使用 send_sms.js 脚本,指定接收号码(国际格式如 +3712xxxxxxx)、短信内容及发件人标识即可发送。支持 --dry-run 参数预览请求而不实际发送,便于调试。
批量发送:使用 send_sms_bulk.js 脚本,支持以逗号、换行或分号分隔的多号码列表,适合营销通知、验证码批量下发等场景。
显著优点
- 国际覆盖:TelTel 平台支持多国短信路由,适合跨境业务
- API 透明:直接暴露底层 REST 端点,便于自定义封装
- 灵活配置:支持环境变量与 OpenClaw Skills UI 双重配置方式
- 回执支持:可选配置 callback URL 接收投递状态报告
潜在局限
- 预付费模式:需预先充值账户余额,无后付或信用额度机制
- 发件人审核:首次使用前需在平台界面完成发件人名称/号码验证,无法纯 API 自动化
- 仅限 SMS:不支持语音、RCS 等富媒体消息
- 依赖第三方:服务可用性与价格受 TelTel 平台政策约束
适合人群
- 需要自动化国际短信通知的 DevOps 工程师
- 构建用户验证/告警系统的后端开发者
- 中小团队寻求比 Twilio 等巨头更经济的替代方案
常规风险提示
- API 密钥泄露:
TELTEL_API_KEY需妥善保管,避免硬编码至版本控制 - 余额监控:建议设置账户余额告警,防止因欠费导致服务中断
- 合规风险:批量发送需遵守目标国家的反垃圾短信法规(如 GDPR、TCPA)
- 号码格式:接收方号码必须严格使用国际 E.164 格式,否则可能投递失败