名称： voice.ai-voice-agents
title: "Voice.ai 语音助手"
描述： >
创建、管理和部署 Voice.ai 的对话式 AI 语音助手。
当用户希望使用语音助手、列出其助手、创建新助手或管理助手配置时使用。

Voice.ai 语音助手

使用 Voice.ai 的 Agent API 构建最出色的对话式 AI 语音助手。

✨ 功能特性

• 助手管理 - 创建、更新和删除语音助手
• 一键部署 - 即时为电话呼叫部署助手
• 知识库 - 支持 RAG 的助手，可集成自定义知识
• MCP 集成 - 通过 MCP 将助手连接到外部工具
• 电话号码 - 管理呼入/呼出电话号码
• 分析 - 追踪通话记录和助手性能

⚙️ 配置

获取您的 API 密钥

1. 前往 Voice.ai 开发者控制台
2. 登录或创建账户
3. 生成一个新的 API 密钥
4. 复制并安全保存

设置身份验证（3 种方法）

方法 1：环境变量（推荐）

export VOICE_AI_API_KEY="您的-api-key-在此"

方法 2：.env 文件

# 在项目根目录创建 .env 文件
echo 'VOICE_AI_API_KEY=您的-api-key-在此' >> .env

方法 3：OpenClaw 配置

{
  "skills": {
    "voice.ai-voice-agents": {
      "api_key": "您的-api-key-在此"
    }
  }
}

🔐 执行任何操作前

重要提示： 在运行任何命令前，请务必验证身份验证。

# 1. 检查 API 密钥是否已设置
echo $VOICE_AI_API_KEY

# 2. 测试连接（列出助手）
node scripts/agent.js list

# 3. 如果出错，请重新导出您的密钥
export VOICE_AI_API_KEY="您的-api-key-在此"

静默初始化

设置 API 密钥后，SDK 会在您运行任何命令时自动初始化。无需手动设置。

🚀 快速开始

export VOICE_AI_API_KEY="您的-api-key"

# 创建一个助手
node scripts/agent.js create --name "支持机器人" --prompt "你是一个乐于助人的助手"

# 列出所有助手
node scripts/agent.js list

# 部署一个助手
node scripts/agent.js deploy --id <助手_id>

🤖 助手配置

🎙️ TTS 语音设置

🌍 支持的语言

auto, en, ca, sv, es, fr, de, it, pt, pl, ru, nl

💻 CLI 使用

# 创建新助手
node scripts/agent.js create --name "我的助手" --prompt "系统提示词在此" --greeting "你好！"

# 列出所有助手
node scripts/agent.js list

# 获取助手详情
node scripts/agent.js get --id <助手_id>

# 更新助手
node scripts/agent.js update --id <助手_id> --prompt "新提示词"

# 部署助手
node scripts/agent.js deploy --id <助手_id>

# 暂停助手
node scripts/agent.js pause --id <助手_id>

# 删除助手
node scripts/agent.js delete --id <助手_id>

🤖 OpenClaw 集成

JSON 配置

{
  "name": "voice.ai-voice-agents",
  "enabled": true,
  "config": {
    "api_key": "${VOICE_AI_API_KEY}",
    "default_model": "gemini-2.5-flash-lite",
    "auto_deploy": false
  }
}

聊天触发器

当您提到以下内容时，OpenClaw 会自动激活此技能：
- "语音助手"、"语音机器人"、"电话助手"
- "创建助手"、"部署助手"、"列出助手"
- "Voice.ai"、"语音 AI"

🗣️ 用户友好语言

📁 项目文件

voice-ai-agents/
├── SKILL.md                    # 本文档
├── voice-ai-agents.yaml        # 技能配置
├── voice-ai-agents-sdk.js      # JavaScript SDK
└── scripts/
    └── agent.js                # 命令行工具

❌ 错误处理

友好的错误信息

SDK 提供用户友好的错误信息：

❌ 身份验证失败。请检查您的 API 密钥。
   在此获取：https://voice.ai/app/dashboard/developers

❌ 未找到助手 "support-bot"。
   运行 'node scripts/agent.js list' 查看可用助手。

❌ 达到速率限制。请在 60 秒后重试。

📝 触发器

以下短语会在 OpenClaw 中激活 Voice.ai 助手技能：

🔗 MCP 服务器集成

将您的助手连接到外部工具：

const agent = await client.createAgent({
  name: "MCP 助手",
  config: {
    prompt: "你可以使用工具来帮助用户",
    mcp_servers: [{
      name: "我的工具",
      url: "https://my-server.com/mcp",
      auth_type: "bearer_token",
      auth_token: "secret"
    }]
  }
});

📚 知识库 (RAG)

为您的助手添加自定义知识：

# 创建带有知识库的助手
node scripts/agent.js create --name "常见问题解答机器人" --kb-id 123

🔗 链接

• 获取 API 密钥 ← 从这里开始！
• 语音助手指南
• 助手 API 参考
• 状态页面

📋 更新日志

由 Nick Gill 用 ❤️ 制作