telcall-twilio

name	telcall-twilio
description	Make emergency phone calls via Twilio. Use when you need to call someone and play a voice message programmatically (e.g., server down alerts, security notifications).

TelCall Twilio - Emergency Phone Calls

Make phone calls that speak a message to the recipient using Twilio's Voice API.

Author

• Name: Micheal Sun
• Email: [e-mail]
• X: https://x.com/pingfanbufan
• GitHub: https://github.com/cnvipstar

Features

• Make phone calls via Twilio API
• Text-to-speech message delivery (supports multiple languages)
• Simple configuration
• Easy integration with OpenClaw

Prerequisites

1. Twilio Account

1. Visit https://www.twilio.com and sign up
2. During setup, choose:
   • "With code" (for full API access)
   • "Voice" channel
3. Bind a credit card (required for production use)

2. Purchase a Phone Number

1. Go to Phone Numbers → Buy a Number
2. Select United States (easiest, no address verification needed)
3. Filter by Voice capability
4. Purchase a local number (~$1/month)

3. Get Your Credentials

From the Twilio Console homepage, copy:

• Account SID (starts with AC...)
• Auth Token (click to reveal)

4. Verify Your Phone Number (Trial Accounts)

Trial accounts can only call verified numbers:

1. Go to Phone Numbers → Verified Caller IDs
2. Add your phone number
3. Complete verification via SMS or voice call

Note: Upgrade your account ($20 minimum) to call any number without verification.

Setup

Run the setup script to configure your Twilio credentials:

bash ~/.openclaw/workspace/telcall-twilio/scripts/setup.sh

You will be prompted to enter:

• Account SID
• Auth Token
• Twilio phone number (e.g., [phone])
• Your phone number (e.g., [phone])

Usage

Basic Call

bash ~/.openclaw/workspace/telcall-twilio/scripts/call.sh "Your message here"

With OpenClaw

Simply tell your assistant:

• "Call me: Server is down!"
• "Emergency call: Security breach detected"

The assistant will use this skill to make the call.

Cost

Item	Price
US Phone Number	~$1/month
Call to most countries	~$0.02-0.15/min
Text-to-speech	Free (TwiML)

Estimated monthly cost: $2-5 for occasional emergency calls.

Troubleshooting

"Number is unverified"

Your account is in trial mode. Either:

1. Verify the destination number in Twilio Console
2. Upgrade your account ($20) to call any number

Call doesn't go through

1. Check your Twilio number has Voice capability
2. Verify your Auth Token is correct
3. Ensure you have account balance

Files

telcall-twilio/
├── SKILL.md           # This file
├── scripts/
│   ├── setup.sh       # Configure credentials
│   └── call.sh        # Make a phone call
└── config/
    └── twilio.json    # Credentials (created by setup.sh)

License

MIT License - Feel free to use and modify.