AI Phone Calls (Bland AI)

# Phone Calls Skill

代表用户进行 AI 驱动的电话呼叫——预订餐厅、预约时间、咨询服务等。

## 提供商：Bland AI

**为什么选择 Bland AI？** - 所有选项中最简单的 API（Vapi、Retell 更复杂） - 只需 `phone_number` + `task` 即可拨打电话 - 低延迟、自然逼真的语音 - 按分钟付费，无平台费用 - 自托管（数据安全）

## 所需设置

### 1. 创建 Bland AI 账户 1. 前往 https://app.bland.ai 2. 使用邮箱注册 3. 添加付款方式（或使用免费试用额度）

### 2. 获取 API 密钥 1. 前往 https://app.bland.ai/dashboard 2. 点击您的个人资料 → API Keys 3. 复制您的 API 密钥

### 3. 配置 Clawdbot 添加到您的环境变量或 `.env` 文件： ```bash BLAND_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxx ```

或存储在 `~/.clawd/secrets.json` 中： ```json { "bland_api_key": "sk-xxxxxxxxxxxxxxxxxxxxxxxx" } ```

## 使用方法

### 基本呼叫 ```bash ./phone-call.sh "+447123456789" "Call the restaurant and book a table for 2 at 7pm tonight under the name John" ```

### 使用自定义语音 ```bash ./phone-call.sh "+447123456789" "Ask about their opening hours" --voice maya ```

### 检查通话状态 ```bash ./check-call.sh <call_id> ```

## 工作原理

1. 您提供电话号码和任务/目标 2. Bland AI 使用 AI 智能体呼叫该号码 3. AI 自然地遵循您的指令 4. 通话结束后，您会收到文字记录和摘要

## 示例任务

**餐厅预订：** ``` Call this restaurant and book a table for 4 people on Saturday at 8pm. The booking should be under the name "Smith". If they ask for a phone number, give them +447123456789. ```

**预约咨询：** ``` Call this dental office and ask what appointments are available next week for a routine checkup. Get at least 3 options if possible. ```

**服务咨询：** ``` Call this plumber and ask if they can come out tomorrow to fix a leaking tap. Get a quote for the callout fee. ```

## 定价（Bland AI）

- **外呼电话：** 约 $0.09/分钟（美国） - **因国家/地区而异** —— 请访问 https://app.bland.ai 查看当前费率 - 首次通话可能有免费额度

## 语音选项

内置语音： - `josh` - 男声，专业 - `maya` - 女声，亲切（默认） - `florian` - 男声，欧洲口音 - `derek` - 男声，随意 - `june` - 女声，专业 - `nat` - 男声，自然 - `paige` - 女声，活泼

## 高级功能

### 语音留言处理 AI 可以检测语音留言，然后选择挂机、留言或忽略。

### 通话录音 设置 `record: true` 以在通话结束后获取录音 URL。

### Webhooks 通过设置 webhook URL，在通话完成时接收通知。

### 对话路径 对于复杂的流程（IVR 菜单、多步骤流程），请在 Bland 仪表板中创建路径。

## 限制

- 无法呼叫紧急服务（999、911 等） - 某些号码可能会被阻止（DNC 列表） - 速率限制：同一号码每 10 秒 1 次呼叫 - 最大通话时长：默认 30 分钟（可配置）

## 故障排除

**“无效的电话号码”** - 包含国家代码：英国为 `+44`，美国为 `+1` - 移除空格和括号

**“余额不足”** - 在 https://app.bland.ai/dashboard/billing 添加额度

**“超过速率限制”** - 呼叫同一号码时请等待几秒钟

## 文件

- `phone-call.sh` — 进行电话呼叫 - `check-call.sh` — 检查通话状态/文字记录 - `bland.sh` — 底层 API 封装