A self-hosted SMS gateway solution that turns an Android device into a private HTTP API for sending and receiving messages.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install android-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 android-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 Android SMS Gateway?
This skill empowers developers and security teams to maintain full control over their messaging infrastructure by utilizing an Android phone as a dedicated SMS gateway. By bypassing traditional third-party providers, Openclaw Skills users can ensure maximum privacy and eliminate per-message costs for security alerts, internal notifications, and automated workflows.
The integration supports multiple popular gateway applications, including the recommended SMS Gateway API and the high-security capcom6 implementation. It provides a robust set of scripts designed to programmatically interact with mobile hardware over a local network or via secure cloud tunnels, making it a perfect fit for self-hosted environments.
Android SMS Gateway Use Cases
- Deploying security alert systems that send real-time vulnerability notifications directly to mobile devices.
- Generating and delivering two-factor authentication (2FA) verification codes for custom applications.
- Automating daily security reminders and scheduled maintenance task notifications via cron jobs.
- Integrating monitoring tools like Nagios or Zabbix to provide SMS-based downtime alerts when network connectivity is limited.
How Android SMS Gateway Works
- An SMS Gateway application is installed and configured on an Android device to expose a local or cloud-based HTTP API.
- The Openclaw Skills interface establishes a connection to the phone's IP address or endpoint using secure API tokens.
- Custom bash scripts process outbound message requests, handling UTF-8 character encoding and automatically splitting messages exceeding 160 characters.
- Outbound messages are transmitted through the phone's cellular connection, while incoming messages are retrieved via polling or pushed to a server using webhooks.
Android SMS Gateway Setup
Prerequisites
- Android phone with an active SMS plan.
- Supported Gateway App (e.g., SMS Gateway API).
- Host and phone on the same network or reachable via VPN.
Installation
- Install the gateway app and enable the HTTP API server.
- Configure a strong API token within the app settings.
- Define your connection parameters using environment variables:
export SMS_GATEWAY_URL="http://192.168.1.100:8080"
export SMS_GATEWAY_TOKEN="your-api-token"
- Verify the gateway status:
./scripts/check_status.sh
Android SMS Gateway Data Schema & Taxonomy
The skill manages its configuration through environment variables or a dedicated JSON file located at ~/.openclaw/sms-gateway.json. This ensures that sensitive tokens remain outside of the codebase.
| Property | Type | Description |
|---|---|---|
gateway_url |
String | The IP address and port of the Android device. |
api_token |
String | The secure authentication token for the API. |
timeout_seconds |
Integer | Maximum time to wait for the phone to respond. |
retry_count |
Integer | Number of attempts for failed transmissions. |
Android SMS Gateway Advanced Features
- End-to-end encryption for message content, ensuring privacy during API transit.
- Bulk SMS capabilities for multi-recipient broadcasts using a single API call to reduce overhead.
- Real-time webhook registration for immediate processing of incoming messages.
- Support for private server deployments, allowing for a 100% air-gapped or internal messaging stack.
- Dual SIM support to programmatically choose specific carriers for different message types.
SKILL.md
Loading
Related Openclaw Skills
YouTube Uploader
A Python-powered automation tool for uploading videos, managing custom thumbnails, and handling OAuth2 authentication for YouTube channels.
spotify-player
A terminal-centric skill for managing Spotify playback and track searching through high-performance CLI tools.
ClawDoctor
ClawDoctor is a behavioral cost coach that analyzes your AI agent sessions to identify financial waste and provide actionable coaching to reduce spending.
LegiScan Bill Tracker
An automated monitoring tool that tracks state legislative bills using keyword filtering via the LegiScan API.
Neutron Agent Memory
A persistent memory solution for AI agents that leverages semantic search and structured context storage to maintain state across sessions.
Neutron Memory
A persistent memory layer for AI agents that enables semantic search and long-term context retention across multiple sessions.
Featured*
