介绍
# Vapi Calls - Agent Instructions
使用此技能来执行任何需要通过电话进行语音交互的任务。
## 配置与网络要求
⚠️ **重要：** 此技能需要您的机器可以从互联网访问，以便接收实时通话更新。
### 1. 环境变量
在您的 OpenClaw `config.json`（或 Gateway 环境）中配置这些变量：
- `VAPI_API_KEY`: 您的 Vapi 私有 API 密钥。 - `VAPI_ASSISTANT_ID`: 用作基础的 Vapi 智能体 ID。 - `VAPI_PHONE_NUMBER_ID`: Vapi 电话号码 ID。 - `WEBHOOK_BASE_URL`: **关键。** 此智能体可访问的公共 HTTPS URL（例如 `https://my-claw.com` 或 `https://xyz.ngrok-free.app`）。**请勿包含末尾斜杠。** - `WEBHOOK_PORT`（可选）：监听的本地端口（默认：`4430`）。 - `VAPI_LLM_PROVIDER`（可选）：自定义模式的提供商（默认：`openai`）。 - `VAPI_LLM_MODEL`（可选）：自定义模式的模型（默认：`gpt-4o-mini`）。
### 2. 连接设置
您必须将 `WEBHOOK_PORT`（默认为 4430）暴露到互联网。
**选项 A：Cloudflare Tunnel（推荐）** `cloudflared tunnel --url http://localhost:4430`
**选项 B：Ngrok** `ngrok http 4430`
将 `WEBHOOK_BASE_URL` 设置为生成的 URL（例如 `https://random-name.trycloudflare.com`）。
## 使用方法
### 自定义任务（动态）
提供一个特定的 `system_prompt`。系统将自动使用 **GPT-4o Mini** 并启用 **endCall** 工具。AI 将能够自主挂断电话。
### 原生智能体（静态）
为 `first_message`、`system_prompt` 和 `end_message` 传入 `"DEFAULT"`。系统将使用在 Vapi 控制台中定义的准确配置（模型、语音、提示词）。
## 故障排查
- **通话挂断 / 无报告：** 检查 `WEBHOOK_BASE_URL` 是否可从互联网访问。Python 脚本仅在通话期间在 `WEBHOOK_PORT` 上启动一个临时服务器。 - **API 400 错误：** 检查您的 `VAPI_PHONE_NUMBER_ID` 和 `VAPI_ASSISTANT_ID`。