telcall-twilio

通过 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/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.

---

## 中文说明

# TelCall Twilio - 紧急电话呼叫

使用 Twilio 的语音 API（Voice API）拨打电话，向接听者播报一段消息。

## 作者

- **Name:** Micheal Sun
- **Email:** laosun1985@gmail.com
- **X:** https://x.com/pingfanbufan
- **GitHub:** https://github.com/cnvipstar

## 功能特性

- 通过 Twilio API 拨打电话
- 文本转语音消息播报（支持多种语言）
- 配置简单
- 易于与 OpenClaw 集成

## 前提条件

### 1. Twilio 账户

1. 访问 https://www.twilio.com 并注册
2. 在设置过程中，选择：
   - **"With code"**（以获取完整的 API 访问权限）
   - **"Voice"** 渠道
3. 绑定一张信用卡（生产环境使用时必需）

### 2. 购买电话号码

1. 进入 **Phone Numbers** → **Buy a Number**
2. 选择 **United States**（最简单，无需地址验证）
3. 按 **Voice** 能力进行筛选
4. 购买一个本地号码（约 $1/月）

### 3. 获取凭据

从 Twilio 控制台首页，复制：
- **Account SID**（以 `AC...` 开头）
- **Auth Token**（点击以显示）

### 4. 验证你的电话号码（试用账户）

试用账户只能呼叫已验证的号码：
1. 进入 **Phone Numbers** → **Verified Caller IDs**
2. 添加你的电话号码
3. 通过短信或语音电话完成验证

**注意：** 升级你的账户（最低 $20）即可无需验证呼叫任意号码。

## 设置

运行设置脚本以配置你的 Twilio 凭据：

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

系统会提示你输入：
- Account SID
- Auth Token
- Twilio 电话号码（例如 `+15551234567`）
- 你的电话号码（例如 `+8613812345678`）

## 用法

### 基本呼叫

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

### 配合 OpenClaw

只需告诉你的助手：
- "Call me: Server is down!"
- "Emergency call: Security breach detected"

助手将使用此技能来拨打电话。

## 费用

| 项目 | 价格 |
|------|------|
| 美国电话号码 | 约 $1/月 |
| 呼叫大多数国家 | 约 $0.02-0.15/分钟 |
| 文本转语音 | 免费（TwiML） |

**预计月度费用：** 偶尔的紧急呼叫约 $2-5。

## 故障排查

### "Number is unverified"

你的账户处于试用模式。可采取以下任一方式：
1. 在 Twilio 控制台中验证目标号码
2. 升级你的账户（$20）以呼叫任意号码

### 电话无法接通

1. 检查你的 Twilio 号码是否具备 **Voice** 能力
2. 确认你的 Auth Token 是否正确
3. 确保你的账户有余额

## 文件

```
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)
```

## 许可证

MIT License - 欢迎自由使用和修改。