Send and receive SMS text messages directly from your AI agent using an Android phone and the pidge CLI.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pidgesms
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 pidgesms 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 pidgesms?
pidgesms is a robust communication utility designed for Openclaw Skills that bridges the gap between AI-driven workflows and mobile SMS networks. By leveraging the pidge CLI as a bridge to the Android SMS Gateway, this skill allows developers and AI agents to programmatically send, read, and manage text messages through a physical Android device.
This tool is particularly valuable for users who need to integrate real-world mobile messaging into their automated ecosystems without relying on expensive third-party SMS APIs. Because it utilizes Openclaw Skills infrastructure, it provides a secure and scriptable way to handle E.164 formatted messaging directly from your local environment.
pidgesms Use Cases
- Sending automated notifications or alerts to mobile devices via Openclaw Skills.
- Monitoring an Android SMS inbox for incoming verification codes or customer responses.
- Building two-way communication loops where an AI agent can reply to incoming texts.
- Tracking the delivery lifecycle of critical outgoing messages in real-time.
How pidgesms Works
- The AI agent invokes the pidgesms tool through the Openclaw Skills framework to perform an action like sending a message or fetching the inbox.
- The pidge CLI interprets the command and connects to the Android SMS Gateway app running on a linked mobile device.
- For outgoing messages, the gateway instructs the Android OS to send the SMS via the carrier network; for incoming messages, it retrieves them from the phone's storage.
- The results, including message IDs and delivery statuses, are returned to the agent in a structured format for further processing.
pidgesms Setup
To integrate this functionality into your Openclaw Skills environment, install the pidge binary using Go:
go install github.com/typhonius/pidge@latest
Configuration is managed via a TOML file. Ensure your settings are correctly defined in ~/.config/pidge/config.toml to allow the CLI to communicate with your Android SMS Gateway instance.
pidgesms Data Schema & Taxonomy
The skill manages SMS data and metadata using the following structure, ensuring compatibility with Openclaw Skills workflows:
| Attribute | Description | Requirement |
|---|---|---|
| Recipient | Phone number in E.164 format (e.g., +15551234567) | Mandatory |
| Message Body | The text content to be transmitted | Mandatory |
| Message ID | Unique identifier returned by the gateway for tracking | Generated |
| State | Delivery progress (Pending, Processed, Sent, Delivered) | Status Check |
| Inbox Filter | Options to retrieve all, unread, or JSON-formatted messages | Optional |
pidgesms Advanced Features
- Support for JSON-formatted output to enable seamless data parsing within Openclaw Skills.
- Message acknowledgment system (ack/unack) to maintain a clean state for processed communications.
- Built-in health check commands to verify the connection between the CLI and the Android hardware.
- Real-time status tracking to monitor the entire lifecycle of an SMS from pending to delivered.
SKILL.md
Loading
Related Openclaw Skills
bitclawden
A professional-grade interface for managing Bitwarden credentials and secrets directly through the Bitwarden CLI.
X-Read
A browser-based automation tool for extracting and summarizing public X (Twitter) content into clean markdown without requiring an account.
Tavily Web Search & Discovery
A specialized web search skill designed for AI agents to discover URLs, conduct technical research, and generate cited summaries from structured web results.
Agent Docs
A framework for creating documentation specifically optimized for LLM consumption, RAG retrieval, and token efficiency.
Civic Nexus MCP Bridge
A comprehensive bridge connecting Openclaw agents to over 100 external services through the Civic Nexus Model Context Protocol.
Frontend Design Ultimate
A sophisticated UI generation tool that converts text requirements into distinctive, production-grade React websites using Tailwind CSS and shadcn/ui.
Featured*
