Setup & Installation
openclaw skills install @typhonius/pidgesms
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install pidgesms
What This Skill Does
Sends and reads SMS messages from the command line using pidge, a CLI that connects to Android SMS Gateway running on an Android device. Phone numbers must be in E.164 format. Config lives in ~/.config/pidge/config.toml with no environment variables required.
Uses an Android phone you already own as the SMS backend instead of requiring a paid SMS API subscription.
When to use it
- Send a text to a contact without touching a phone
- Check unread SMS from a terminal or script
- Get notified via text when a long-running job finishes
- Reply to an incoming message from the command line
- Confirm delivery status of a sent text
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: Send a text to +15551234567 saying 'Package delivered'
AGENT
- 1Run: pidge send "+15551234567" "Package delivered"
- 2Capture the message id from the response
- 3Run: pidge status <message-id> to check delivery state
- 4Confirm state has progressed to Delivered
OUTPUT
Message sent and confirmed as Delivered
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
Android device with Android SMS Gateway app installed and runningpidge CLI binary (go install github.com/typhonius/pidge@latest)