name: voipms-sms description: OpenClaw skill for sending and retrieving SMS messages via the VoIP.ms API (no Bitwarden dependency).

VoIP.ms SMS Skill

Use this skill to send and retrieve SMS messages through the VoIP.ms API.

Available Scripts

scripts/send_sms.py

Send an SMS from one of your VoIP.ms DIDs to a destination number.

Required arguments:

• --did: source VoIP.ms number
• --dst: destination phone number
• --message: SMS message text

Example:

python3 scripts/send_sms.py \
  --did "15551234567" \
  --dst "15557654321" \
  --message "Hello from OpenClaw"

scripts/get_sms.py

Retrieve SMS messages from the VoIP.ms API for a recent date range.

Arguments:

• --did (optional): filter by a specific source number
• --days (optional, default 1): number of days back to fetch

Example (all numbers, last day):

python3 scripts/get_sms.py --days 1

Example (specific DID, last 7 days):

python3 scripts/get_sms.py --did "15551234567" --days 7

Required Credentials

Set these environment variables before running either script. The Python scripts will read them directly. Please create a sub-account/dedicated VoIP.ms API account that only has SMS permissions rather than using your main admin credentials.

Example:

export VOIPMS_API_USERNAME="my_api_username"
export VOIPMS_API_PASSWORD="my_api_password"