Voice.ai 智能体

使用 Voice.ai 的智能体 API 构建最出色的对话式 AI 语音智能体。

✨ 功能特性

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

⚙️ 配置

获取您的 API 密钥

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

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

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

export VOICE_AI_API_KEY="your-api-key-here"

方法二：.env 文件

# Create .env file in project root
echo 'VOICE_AI_API_KEY=your-api-key-here' >> .env

方法三：OpenClaw 配置

{
  "skills": {
    "voice.ai-voice-agents": {
      "api_key": "your-api-key-here"
    }
  }
}

🔐 执行任何操作之前

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

# 1. Check if API key is set
echo $VOICE_AI_API_KEY

# 2. Test connection (list agents)
node scripts/agent.js list

# 3. If errors, re-export your key
export VOICE_AI_API_KEY="your-api-key-here"

静默初始化

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

🚀 快速开始

export VOICE_AI_API_KEY="your-api-key"

# Create an agent
node scripts/agent.js create --name "Support Bot" --prompt "You are a helpful assistant"

# List all agents
node scripts/agent.js list

# Deploy an agent
node scripts/agent.js deploy --id <agent_id>

🤖 智能体配置

🎙️ TTS 语音设置

🌍 支持的语言

自动,英语,加泰罗尼亚语,瑞典语,西班牙语,法语,德语,意大利语,葡萄牙语,波兰语,俄语,荷兰语

💻 命令行界面用法

# Create a new agent
node scripts/agent.js create --name "My Agent" --prompt "System prompt here" --greeting "Hello!"

# List all agents
node scripts/agent.js list

# Get agent details
node scripts/agent.js get --id <agent_id>

# Update an agent
node scripts/agent.js update --id <agent_id> --prompt "New prompt"

# Deploy an agent
node scripts/agent.js deploy --id <agent_id>

# Pause an agent
node scripts/agent.js pause --id <agent_id>

# Delete an agent
node scripts/agent.js delete --id <agent_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", "语音人工智能"

🗣️ 用户友好语言

📁 项目文件

voice-ai-agents/
├── SKILL.md                    # This documentation
├── voice-ai-agents.yaml        # Skill configuration
├── voice-ai-agents-sdk.js      # JavaScript SDK
└── scripts/
    └── agent.js                # CLI tool

❌ 错误处理

友好的错误信息

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

❌ Authentication failed. Please check your API key.
   Get one at: https://voice.ai/app/dashboard/developers

❌ Agent "support-bot" not found. 
   Run 'node scripts/agent.js list' to see available agents.

❌ Rate limit reached. Please wait 60 seconds before retrying.

📝 触发词

这些短语会在OpenClaw中激活Voice.ai代理技能：

🔗 MCP 服务器集成

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

const agent = await client.createAgent({
  name: "MCP Agent",
  config: {
    prompt: "You can use tools to help users",
    mcp_servers: [{
      name: "my-tools",
      url: "https://my-server.com/mcp",
      auth_type: "bearer_token",
      auth_token: "secret"
    }]
  }
});

📚 知识库 (RAG)

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

# Create agent with knowledge base
node scripts/agent.js create --name "FAQ Bot" --kb-id 123

🔗 链接

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

📋 更新日志

由以下人员倾情制作尼克·吉尔