SMS Gateway

通过运行在USB GSM调制解调器上的自托管短信网关收发短信。当用户需要发送短信或查收来信时使用。

安装

概览

SMS Gateway 是一个自托管的短信网关工具,专为通过 USB GSM 调制解调器收发短信而设计。它允许用户在本地环境中运行一个轻量级的短信服务,无需依赖第三方短信平台即可实现短信的发送与接收。该工具基于 OpenClaw 技能体系构建,通过简单的 Shell 脚本调用完成核心功能,适合需要私密、可控通信通道的开发者或自动化系统使用。用户只需配置好环境变量并连接支持的 GSM 设备,即可在命令行中直接操作短信功能,极大简化了嵌入式设备或远程监控系统中的消息交互流程。 该工具的核心优势在于其本地部署特性,所有数据流量均不经过外部服务器,保障了通信内容的隐私性和安全性。同时,它提供了灵活的权限管理机制,通过 allowlist.json 文件严格控制可通信的号码范围,防止误发或未授权访问。无论是个人项目还是企业级应用,都能根据实际需求定制白名单策略,确保仅与可信联系人进行短信交互。此外,工具支持自动标记已读状态、过滤消息类型(如未读/全部),并支持按国家代码格式(如 +1)精确匹配电话号码,提升了使用的准确性与可靠性。 SMS Gateway 的设计理念强调简洁与高效,避免复杂配置和图形界面干扰。用户仅需掌握基础的命令行操作即可完成全部功能,非常适合集成到自动化工作流中。例如,当某个监控脚本检测到异常事件时,可通过 send_sms.sh 立即向运维人员发送告警;而当收到来自特定设备的确认回复时,receive_sms.sh 能自动提取内容并触发后续处理逻辑。这种端到端的闭环能力使其成为物联网、远程设备管理和应急响应系统的理想补充组件。

核心功能特点

  1. 通过 USB GSM 调制解调器实现本地短信收发,无需依赖云端服务
  2. 提供 send_sms.sh 和 receive_sms.sh 两个核心脚本,支持命令行快速操作
  3. 内置 allowlist.json 机制,严格限制可通信的号码范围以保障安全
  4. 支持按国家代码格式(如 +1)精确匹配电话号码,兼容国际标准
  5. 自动将新收到的短信标记为已读,避免重复处理
  6. 可按状态筛选消息(未读/已读/全部)并支持从非白名单号码接收

适用场景

SMS Gateway 特别适用于对通信隐私和自主控制有较高要求的场景。例如,在部署远程传感器网络时,设备可通过 GSM 模块定期上报状态,管理员则利用此工具集中查收各节点的实时数据,确保信息传递不经过公共网络。又如,在家庭安防系统中,一旦摄像头检测到入侵行为,系统可立即调用 send_sms.sh 向预设联系人发送警报文本,实现即时通知。这些应用场景都依赖于本地化、低延迟且可审计的通信方式,而 SMS Gateway 恰好满足此类需求。 另一个典型用例是自动化运维流程。假设某台服务器因负载过高触发告警,运维脚本可通过调用 receive_sms.sh 检查是否有待处理的工单反馈,并根据最新短信内容决定是否重启服务或切换节点。由于所有操作均在本地完成,整个过程既快速又避免了因网络波动导致的通信中断。此外,对于需要离线运行的小型项目(如野外数据采集设备),GSM 调制解调器配合此工具可在无互联网环境下维持基本的消息通道,显著提升系统的鲁棒性。 在企业内部通讯方面,SMS Gateway 也可用于替代传统短信群发平台,尤其适合处理敏感信息。比如人力资源部门希望向候选人发送面试通知,使用本地网关不仅能降低运营成本,还能完全掌控号码列表和内容模板,避免泄露客户隐私。同样,在客户服务场景中,客服机器人可将用户问题摘要通过短信转发给专家团队,后者回复后再由系统统一回传,形成高效的双向沟通链路。这些案例充分体现了 SMS Gateway 在构建私有化、可定制通信基础设施方面的价值。