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"