telcall-twilio

# 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:** laosun1985@gmail.com
- **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
bash ~/.openclaw/workspace/telcall-twilio/scripts/setup.sh
```

You will be prompted to enter:
- Account SID
- Auth Token
- Twilio phone number (e.g., `+15551234567`)
- Your phone number (e.g., `+8613812345678`)

## Usage

### Basic Call

```bash
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/m...