A bridge for sending and receiving SMS messages through an Android device using the sms-gate.app framework.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install sms-gateway
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install sms-gateway using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is SMS Gateway?
The SMS Gateway skill allows for seamless integration of mobile messaging into automated environments. By connecting to a local sms-gate.app instance running on an Android device or via Termux, this skill facilitates the transmission of text messages and the monitoring of their delivery lifecycle. It is a core part of the Openclaw Skills ecosystem, offering a private and cost-effective alternative to commercial SMS APIs.
This tool is particularly useful for developers who need to manage message history, check delivery reports, and handle incoming SMS through configurable webhooks. Because it operates locally, it provides high levels of privacy and control over communication data.
SMS Gateway Use Cases
- Sending automated SMS notifications for system alerts or appointments
- Creating mobile-based verification systems for user authentication
- Programmatically checking the delivery status of sent messages
- Receiving and processing incoming SMS via custom webhooks
- Managing a searchable history of sent and received text communications
How SMS Gateway Works
- The skill communicates with an Android device hosting a local API instance.
- Commands are issued via Python scripts to trigger message dispatch.
- The gateway assigns a unique ID to each message, allowing for granular tracking through various states.
- Incoming messages are captured through a webhook server that listens for events from the gateway.
- Developers use the provided CLI tools to manage webhooks and query the status of the gateway.
SMS Gateway Setup
First, configure your environment variables to match your local gateway setup:
export SMS_GATE_URL="http://192.168.x.x:8080"
export SMS_GATE_USER="your_username"
export SMS_GATE_PASS="your_password"
To send your first message, use the following command:
python3 scripts/send_sms.py '+1234567890' 'Hello from Openclaw Skills!'
To verify your setup, run the health check script:
python3 scripts/health.py
SMS Gateway Data Schema & Taxonomy
| Element | Description |
|---|---|
| Message ID | A unique identifier returned upon sending a message. |
| Status | The current lifecycle stage (Pending, Sent, Delivered, Failed). |
| Phone Number | Normalized phone number using the + prefix. |
| Webhook Event | Triggers such as sms:received or sms:delivered for automation. |
SMS Gateway Advanced Features
- Multi-stage status tracking from pending to delivered
- Local webhook server integration for real-time message ingestion
- Ngrok compatibility for exposing local webhooks to the public internet
- Delivery report management to ensure message arrival
- CLI-based message history listing with customizable limits
SKILL.md
Loading
Related Openclaw Skills
Agent Chatroom
A sophisticated social interaction skill for AI agents featuring scrolling danmaku messages, Reddit-style threaded discussions, and community voting.
X Research
A professional-grade X/Twitter research agent that provides deep search, profile analysis, and thread extraction through a cost-effective API integration.
Tweet Composer
A data-driven skill for scoring and optimizing tweets based on X’s actual open-source ranking algorithm.
Google Search Skill
A comprehensive Serper.dev integration providing AI agents with rich Google Search results across multiple specialized verticals.
imsg
A specialized command-line interface for interacting with Apple Messages.app to read, monitor, and send iMessages or SMS on macOS.
Memory-ReMe
Memory-ReMe is a sophisticated memory management system that enables AI agents to maintain persistent context, apply user preferences automatically, and learn from feedback across multiple sessions.
Featured*
